Update Documenter, DocumenterCitations (PALEOtoolkit#30)

* Update Documenter, DocumenterCitations

* makedocs(; plugins=[bib], ...) update

Breaking change in Documenter.jl v1

* style=:authoryear for references

* Update Documenter [compat] in top-level Project.toml

Author: sjdaines

Project.toml

@@ -17,7 +17,7 @@ XLSX = "fdbf4ff8-1666-58a4-91e7-1b58723a45e0"
 
 [compat]
 DataFrames = "1.1"
-Documenter = "0.27"
+Documenter = "1"
 Infiltrator = "1.0"
 Interpolations = "0.13, 0.14"
 MAT = "0.10"

docs/Project.toml

@@ -1,6 +1,6 @@
 [compat]
-Documenter = "0.27"
-DocumenterCitations = "0.2"
+Documenter = "1"
+DocumenterCitations = "1"
 Revise = "3.1"
 julia = "1.6"
 

docs/make.jl

@@ -4,10 +4,13 @@ import PALEOcopse
 
 using DocumenterCitations
 
-bib = CitationBibliography(joinpath(@__DIR__, "src/paleo_references.bib"))
+bib = CitationBibliography(
+    joinpath(@__DIR__, "src/paleo_references.bib");
+    style=:authoryear,
+)
 
-makedocs(bib, sitename="PALEOcopse Documentation", 
-# makedocs(sitename="PALEO Documentation", 
+makedocs(;
+    sitename = "PALEOcopse Documentation", 
     pages = [
         "index.md",
         "Examples and Tutorials" => [
@@ -16,7 +19,7 @@ makedocs(bib, sitename="PALEOcopse Documentation",
         "Design" => [
             "COPSE_Domains.md",
         ],
-        # no HOWTO docs yes
+        # no HOWTO docs yet
         "Reference" => [
             "PALEOcopse.md",
         ],
@@ -26,6 +29,7 @@ makedocs(bib, sitename="PALEOcopse Documentation",
     format = Documenter.HTML(
         prettyurls = get(ENV, "CI", nothing) == "true"
     ),
+    plugins = [bib],
 )
 
 @info "Local html documentation is available at $(joinpath(@__DIR__, "build/index.html"))"