From 1045870497ee6308c7374c7b8193e4a1cacb3851 Mon Sep 17 00:00:00 2001 From: Midgard <2885-Midgard@users.noreply.framagit.org> Date: Tue, 9 Jun 2020 11:34:51 +0200 Subject: [PATCH] Put each sentence on its own line, improve some --- blog/2020-06-08-svg-makefile-slides.md | 61 ++++++++++++++------------ 1 file changed, 33 insertions(+), 28 deletions(-) diff --git a/blog/2020-06-08-svg-makefile-slides.md b/blog/2020-06-08-svg-makefile-slides.md index 770c5c7..38a4532 100644 --- a/blog/2020-06-08-svg-makefile-slides.md +++ b/blog/2020-06-08-svg-makefile-slides.md @@ -4,16 +4,17 @@ published: 2020-06-02 --- -Text-based slides are boring and not effective. While preparing a presentation for my intermediary -thesis' defence, I wanted to create something that would support my story better. I wanted to use -graphics instead of words so the language centres of my dear audience's brains could focus on my -speech rather than reading. Rather than importing slide-sized graphics in a GUI, I thought -a makefile would be a nice way to do the trick. +Text-based slides are boring and not effective. +While preparing a presentation for my intermediary thesis' defence, I wanted to create something that would support my story better. +I wanted to use graphics instead of words so the language centres of my dear audience's brains could focus on my speech rather than reading. +Rather than importing slide-sized graphics in a GUI, I thought a makefile would be a nice way to do the trick. -Makefiles these days are commonly used as a shell script with multiple entry points. You give it a -filename, and it will build that file if its dependencies have been changed. Traditionally -makefiles are used for C programs, but there's no reason you can't use them for any build you want. -Even this website is updated with a makefile! Want to join me and write one together? +Makefiles these days are commonly used as a shell script with multiple entry points. +But it's more than that! +You give it a filename, and it will build that file if its dependencies have been changed. +Traditionally makefiles are used for C programs, but there's no reason you can't use them for any build you want. +Even this website is built by a makefile! +Want to join me and write one together? ## Writing the makefile Putting the name of our output file in variables will make it easier to change it later. @@ -21,17 +22,19 @@ Putting the name of our output file in variables will make it easier to change i OUTPUT = slides.pdf ``` -We'll make a list of SVGs in the current directory, and convert it into a list of PDFs targets. -Sorting is necessary to be able to place your slides like you want. The `$(:=)` construct is used -to go from `%.svg` to `build/%.pdf`. +We'll make a list of SVGs in the current directory, and convert it into a list of PDF targets. +Sorting is necessary to be able to place your slides in the order you want. +The `$(:=)` construct is used to go from `%.svg` to `build/%.pdf`. ```makefile SLIDES ::= $(sort $(wildcard *.svg)) SLIDES_PDF ::= $(SLIDES:%.svg=build/%.pdf) ``` -I love this next rule. It teaches make that it should use Inkscape if it needs to create a PDF. +I love this next rule. +It teaches make that it should use Inkscape if it needs to create a PDF. `$@` refers to the target (`build/….pdf`), and `$<` refers to the first dependency (`….svg`). Inkscape's `-A filename` option exports to PDF without opening the GUI. + **TODO: isn't there a way to automatically depend on all parent directories?** ```makefile build/%.pdf: %.svg build @@ -40,10 +43,10 @@ build/%.pdf: %.svg build Now we tell make that the final output can be created from the individual slides. -Make will recursively make sure that all dependencies are up to date. Because we add the SVG source -file as a dependency, it will know that the individual PDF files have to be rebuilt if their source -was changed. And if any slide was changed, the end result will be updated too. But if there was no -change, it won't. Nothing is rebuilt unnecessarily! +Make will recursively make sure that all dependencies are up to date. +Because we add the SVG source file as a dependency, it will know that the individual PDF files have to be rebuilt if their source was changed. +And if any slide was changed, the end result will be updated too. +But if there was no change, it won't; nothing is rebuilt unnecessarily! **TODO: DRY** **TODO: Do we need to fix sh's space disease here?** @@ -52,15 +55,16 @@ $(OUTPUT): $(SLIDES_PDF) pdfjoin $(SLIDES_PDF) -o "$@" ``` -If you look at the `build/%.pdf` rule, you see that it depends on `build`. With this simple, final -rule, make will know how to create this directory. +If you look at the `build/%.pdf` rule, you see that it depends on `build`. +With this simple, final rule, make will know how to create this directory. ```makefile build: mkdir -p "$@" ``` -It is common to create a `clean` to clean up. Since `clean` is not a file, we have to mark the -target as "phony". +It is common to create a `clean` to clean up. +Since `clean` is not a file, we have to mark the target as "phony". +Failing to do so would result in **TODO how to finish this sentence?** ```makefile .PHONY: clean @@ -70,13 +74,14 @@ clean: This concludes the Makefile portion of this post. -**TODO: write about first rule being the default** +**TODO: write about first rule being the default** **TODO: split into 2 posts?** -## Creating and presenting slides -Create one SVG per slide, you can do that in Inkscape. Set the document size to something with the -desired aspect ratio. In my experience this is 16:9 for newer projectors and 4:3 for older models. -To use the resulting slide deck during your presentation, I can recommend -[pdfpc](https://pdfpc.github.io/). But any old PDF viewer that has a fullscreen mode will work, of -course. +## Creating and presenting slides +Create one SVG per slide, you can do that in Inkscape. +Set the document size to something with the desired aspect ratio. +In my experience this is 16:9 for newer projectors and 4:3 for older models. + +To use the resulting slide deck during your presentation, I can recommend [pdfpc](https://pdfpc.github.io/). +But any old PDF viewer that has a fullscreen mode will work, of course.