out of tree build

.gitignore

@@ -1,2 +1,3 @@
+build
 *.pdf
 result

Makefile

@@ -1,12 +1,15 @@
-MDS := $(wildcard *.md)
-PDFS := $(MDS:.md=.pdf)
+SOURCES := $(wildcard src/*.md)
+OUTPUTS := $(patsubst src/%.md,build/%.pdf,$(SOURCES))
 
-%.pdf: %.md
-	pandoc -t beamer $< -o $@
+all: $(OUTPUTS)
+
+clean:
+	rm -r build
 
 .PHNOY: all clean
 
-all: $(PDFS)
+build/%.pdf: src/%.md build
+	pandoc -d pandoc.yml $< -o $@
 
-clean:
-	rm $(PDFS)
+build:
+	mkdir -p build

README.md

@@ -11,7 +11,7 @@ Esse repositório contém os slides, montados com pandoc + beamer.
 Tenha instalado texlive e pandoc. Para cada aula:
 
 ```bash
-pandoc -t beamer aulaX.md -o aulaX.pdf
+pandoc -d pandoc.yml aulaX.md -o aulaX.pdf
 ```
 
 ### Com make

flake.nix

@@ -17,7 +17,7 @@
           src = ./.;
           buildInputs = [ pkgs.pandoc pkgs.texlive.combined.scheme-small ];
           installPhase = ''
-            install -D *.pdf -t $out
+            install -D build/*.pdf -t $out
           '';
         };
       });

pandoc.yml

@@ -0,0 +1,2 @@
+from: markdown+rebase_relative_paths
+to: beamer

aula1.md → src/aula1.md

@@ -62,7 +62,7 @@
 
 Sua ideia é simples: salvar as alterações de um arquivo em um determinado momento e permitir tirar informações sobre o que foi alterado, quando e por que e quem fez a alteração.
 
-![git vs vcs](images/aula1/gitVsVCS.png)
+![git vs vcs](./images/aula1/gitVsVCS.png)
 
 ---
 
@@ -72,7 +72,7 @@ Sua ideia é simples: salvar as alterações de um arquivo em um determinado mom
 - Serviço de Web compartilhado para projetos que utilizam Git
 - Criado por Tom Preston-Werner em Ruby
 
-![git != github](images/aula1/git!=Github.png)
+![git != github](./images/aula1/git!=Github.png)
 
 ---
 
@@ -98,7 +98,7 @@ tamanho dos dados)
   - **Staged**: Arquivos que estão sendo rastreados pelo Git e estão prontos para serem commitados
   - **Unmodified**: Arquivos que estão sendo rastreados pelo Git e não foram alterados desde o último commit
 
-![Git life cycle 3 state](images/aula1/gitLifeCycle-3states-local.png)
+![Git life cycle 3 state](./images/aula1/gitLifeCycle-3states-local.png)
 
 O fluxo de trabalho básico do Git é algo assim:
 
@@ -112,7 +112,7 @@ O fluxo de trabalho básico do Git é algo assim:
 
 Agora que você entendeu os três principais estados de um repositório Git, vamos entender como cada arquivo se comporta dentro do repositório
 
-![Git Life Cycle](images/aula1/gitLifeCycle.png)
+![Git Life Cycle](./images/aula1/gitLifeCycle.png)
 
 Vamos passar por cada um desses estados hoje
 
@@ -173,7 +173,7 @@ git clone https://github.com/gelos-icmc/workshop-git-2023 # exemplo
 
 Para quem está no Windows: botão direito do mouse na pasta criada > Git Bash Here > git init
 
-![windows Git Bash Here](images/aula1/windowsGitBashHere.png)
+![windows Git Bash Here](./images/aula1/windowsGitBashHere.png)
 
 ---
 
@@ -303,7 +303,7 @@ Agora, você fez o seu primeiro commit! vamos aprender a ver o histórico de com
 git log # mostra o histórico de commits
 ```
 
-![git log](images/aula1/gitLogExemplo1.png)
+![git log](./images/aula1/gitLogExemplo1.png)
 
 <!-- TODO: Explicar o que é o HEAD e dizer q será melhor explicado na aula de branch -->
 

aula2.md → src/aula2.md

@@ -43,7 +43,7 @@ Resumir isso
 - Quando você faz um commit, o Git armazena um objeto de commit no repositório do Git (./git/objects)
 - Cada commit possui metadados e ponteiros para os "blobs" (arquivos) que foram alterados
 
-![Diagrama de um commit](images/aula2/commit.png)
+![Diagrama de um commit](./images/aula2/commit.png)
 
 ---
 
@@ -55,7 +55,7 @@ Se você commitar novamente, o proximo commit terá um ponteiro para o commit an
 - Cada commit vai ter um ponteiro para uma snapshot (conjunto de arquivos e suas respectivas modificações)
 - O Git é um grafo acíclico direcionado
 
-![Diagrama de grafo de um commit](images/aula2/commitGraph.png)
+![Diagrama de grafo de um commit](./images/aula2/commitGraph.png)
 
 ---
 
@@ -68,7 +68,7 @@ Enfim, chegamos em o que é uma branch
 - Todas as vezes que você commita, este ponteiro é atualizado para o commit mais recente
 - Esse ponteiro é chamado de `HEAD`
 
-![Diagrama de branch master](images/aula2/headBranchExample.png)
+![Diagrama de branch master](./images/aula2/headBranchExample.png)
 
 ---
 
@@ -80,7 +80,7 @@ Ao criar uma branch, você cria um novo ponteiro para seu commit atual
 
 **NOTA:** Ao criar uma branch, você não muda de branch, você continua na branch atual
 
-![Exemplo de criação de branch](images/aula2/createBranch.png)
+![Exemplo de criação de branch](./images/aula2/createBranch.png)
 
 ---
 
@@ -92,7 +92,7 @@ Então, como eu mudo de branch?
 
 Suponha então que você troque de branch e crie um novo commit
 
-![Alternando Branch e commitando](images/aula2/switchBranch.png)
+![Alternando Branch e commitando](./images/aula2/switchBranch.png)
 
 ---
 
@@ -104,7 +104,7 @@ Deste modo, você pode alternar entre branches e criar commits em cada uma delas
 
 Aqui chegamos em um ponto crucial do Git, ao ter duas branches, você pode fazer um merge entre elas
 
-![Branches](images/aula2/branches.png)
+![Branches](./images/aula2/branches.png)
 
 ---
 
@@ -137,7 +137,7 @@ Há um local temporário onde o Git armazena as modificações que você fez mas
 
 - `git stash` - Salva as modificações atuais em um local temporário
 
-![Stash](images/aula2/gitStash.jpg)
+![Stash](./images/aula2/gitStash.jpg)
 
 o git stash é util quando você quer mudar de branch mas não quer commitar suas modificações (por exemplo, quando você está no meio de uma funcionalidade e precisa mudar de branch para corrigir um bug)