add makefile and update gitlab-ci template

* `make test` pull and test codes in `juliatest` block
* `make compile` compiles the complete book into `book.pdf`
* `make clean` cleans all generated files except `book.pdf`

Author: johnnychen94

.gitlab-ci.yml

@@ -22,8 +22,7 @@ before_script:
 
 .test_template: &test_definition
   script:
-    - julia pull_julia_code.jl
-    - julia runtests.jl
+    - make test
 
 Julia 1.0:
   image: johnnychen94/juliabook:1.0
@@ -40,17 +39,11 @@ Julia 1.2:
   stage: test
   <<: *test_definition
 
-# compile the book only when all tests pass
 Deploy:
   image: johnnychen94/juliabook:stable
   stage: deploy
   script:
-    # compile the book
-    - julia pull_julia_code.jl
-    - lualatex book
-    - pythontex3 book
-    - biber book
-    - lualatex book
+    - make compile
   artifacts:
     paths:
       - "book.pdf"

README.md

@@ -6,7 +6,6 @@ The template allows for the direct compilation of a print-ready PDF, including s
 
 We do all of our development in Ubuntu.
 
-## Installation
 
 Install [Julia](https://julialang.org/downloads/platform.html).
 
@@ -55,13 +54,14 @@ Install it over the version of pythontex that was just installed.
 
 (Note that on arch-based systems, one should use tllocalmgr instead.)
 
+## Test
+
+Running `make test` pulls all the code and then runs all tests in `juliatest` blocks. See `runtests.jl` for details.
+
 ## Compilation
 
-The textbook can be compiled as follows:
-```
-julia pull_julia_code.jl
-lualatex book
-pythontex book
-biber book
-lualatex book
-```
+* `make compile` compiles the whole book
+* `make clean` removes all generated files except `book.pdf`
+
+If you host your project under Gitlab, `.gitlab-ci.yml` is a CI/CD template to start with.
+

makefile

@@ -0,0 +1,14 @@
+test:
+    julia --color=yes pull_julia_code.jl
+    julia --color=yes runtests.jl
+compile:
+    julia --color=yes pull_julia_code.jl
+    lualatex book
+    pythontex book
+    biber book
+    lualatex book
+clean:
+    find . -type f -name "*.aux" -exec rm -f {} \;
+    rm -f book.bbl book.blg book.bcf book.idx book.log book.out book.pytxcode book.run.xml book.toc
+    rm -f all_algorithm_blocks.jl all_juliaconsole_blocks.jl all_test_blocks.jl
+    rm -rf pythontex-files-book