Added PDF manual export (#91)

Still needs prettifying

docs/builddocs.jl

@@ -12,6 +12,7 @@ push!(LOAD_PATH, "../src/")
 
 using Documenter, Persefone
 
+# build the online documentation
 makedocs(sitename="Persefone.jl",
          modules = [Persefone],
          repo = Remotes.GitLab("git.idiv.de", "persefone", "persefone-model"),
@@ -44,3 +45,38 @@ makedocs(sitename="Persefone.jl",
                       "crops.md",
                       "farm.md"]
                   ])
+
+# compile the handbook
+makedocs(format = Documenter.LaTeX(),
+         sitename="Persefone.jl manual",
+         authors="Vedder, Matthies, Pe'er",
+         modules = [Persefone],
+         repo = Remotes.GitLab("git.idiv.de", "persefone", "persefone-model"),
+         warnonly = true, #XXX not recommended
+         #warnonly = [:cross_references],
+         pages = ["index.md",
+                  "User guide" => [
+                      "using.md",
+                      "gui.md",
+                      "config.md"],
+                  #"odd.md",
+                  "Scientific documentation" => [
+                      "management.md",
+                      "crop-models.md",
+                      "skylark.md"],
+                  "Developer guide" => [
+                      "developing.md",
+                      "adapting.md",
+                      "architecture.md",
+                      "gis.md",
+                      "species-dsl.md",
+                      "CHANGELOG.md"],
+                  "Software API" => [
+                      "simulation.md",
+                      "io.md",
+                      "nature.md",
+                      #"energy.md",
+                      "species.md",
+                      "crops.md",
+                      "farm.md"]
+                  ])

docs/src/index.md

@@ -14,4 +14,4 @@ changes in farm operations (e.g. through policy changes in the CAP) influence bi
 The model is open-source software available on 
 [Gitlab](https://git.idiv.de/persefone/persefone-model).
 
-*This documentation was last updated on 2024-09-11 for **Persefone.jl v0.5.5** (commit [6b3aee6](https://git.idiv.de/persefone/persefone-model/-/commit/6b3aee6)).*
+*This documentation was last updated on 2025-01-14 for **Persefone.jl v0.6.0** (commit [479afb4](https://git.idiv.de/persefone/persefone-model/-/commit/479afb4)).*