reorganize docs (#328)

* reorganize docs

* update

* checkpoint

* checkpoint structure

* src/democards fix

* checkpoint fail pyplot

* update fixes

Author: t-bltg

.gitignore

@@ -1,2 +1,10 @@
 Manifest.toml
+
+# DemoCards
+generated/
+
+docs/build/
+
+work/
+site/
 dev/

Project.toml

@@ -9,9 +9,11 @@ The new documentation files will be pushed to the [`gh-pages`](https://github.co
 
 ## Building the docs
 
-With proper dependencies installed, run the following on your local terminal `$ GKSwstype=nul CI=true julia --project=docs docs/make.jl`.
+With proper dependencies installed, run the following on your local terminal `$ CI=true julia --project=docs docs/make.jl`.
 
-Setting the environment variable `CI=true` is optional, but this will be closer to the remote docs building process.
+Setting the environment variable `CI=true` is optional, but the result will be closer to the remote docs building process.
+
+To only build part of the documentation (faster dev), use `PLOTDOCS_BACKENDS='GR PyPlot'` and / or `PLOTDOCS_EXAMPLES='1 22 60'` environement variables. 
 
 ## Contributing demos
 

README.md

@@ -1,12 +1,14 @@
 [deps]
 AbstractTrees = "1520ce14-60c1-5f80-bbc7-55ef81b5835c"
 DataFrames = "a93c6f00-e57d-5684-b7b6-d8193f3e46c0"
+Dates = "ade2ca70-3891-5945-98fb-dc099432e06a"
 DemoCards = "311a05b2-6137-4a5a-b473-18580a3d38b5"
 Distributions = "31c24e10-a181-5473-b8eb-7969acd0382f"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 FileIO = "5789e2e9-d7fb-5bc7-8068-2c6fae9b9549"
 Gaston = "4b11ee91-296f-5714-9832-002c20994614"
 GeometryBasics = "5c1252a2-5f33-56bf-86c9-59e7332b4326"
+Glob = "c27321d9-0574-5035-807b-f59d2c89b15c"
 GraphRecipes = "bd48cda9-67a9-57be-86fa-5b3c104eda73"
 Graphs = "86223c79-3864-5bf0-83f7-82e725a168b6"
 ImageIO = "82e4d734-157c-48bb-816b-45c225c6df19"
@@ -17,22 +19,24 @@ JSON = "682c06a0-de6a-54ab-a142-c8b1cf79cde6"
 LaTeXStrings = "b964fa9f-0449-5b57-a5c2-d3ea65f4040f"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
+MacroTools = "1914dd2f-81c6-5fcd-8719-6d5c9610ff09"
 OffsetArrays = "6fe1bfb0-de20-5000-8ca7-80f57d26f881"
+OrderedCollections = "bac558e1-5e72-5ebc-8fee-abe8a469f55d"
 OrdinaryDiffEq = "1dea7af3-3e70-54e6-95c3-0bf5283fa5ed"
 PGFPlotsX = "8314cec4-20b6-5062-9cdb-752b83310925"
-PlotDocs = "16eed3e5-6057-5b33-8288-9339028cbc04"
 PlotThemes = "ccf2f8ad-2431-5c83-bf29-c5338b663b6a"
 PlotlyBase = "a03496cd-edff-5a9b-9e67-9cda94a718b5"
 PlotlyJS = "f0f68f2c-4968-5e81-91da-67840de0976a"
+PlotlyKaleido = "f2990250-8cf9-495f-b13a-cce12b45703c"
 Plots = "91a5bcdd-55d7-5caf-9e0b-520d859cae80"
 ProgressMeter = "92933f4c-e287-5a05-a399-4b506db050ca"
 PyPlot = "d330b81b-6aea-500a-939a-2ce795aea3ee"
+RDatasets = "ce6b1742-4840-55fa-b093-852dadbb1d8b"
 Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
 RecipesBase = "3cdcf5f2-1ef4-517c-9805-6587b60abb01"
 RecipesPipeline = "01d81517-befc-4cb6-b9ec-a95719d0359c"
-RDatasets = "ce6b1742-4840-55fa-b093-852dadbb1d8b"
-StableRNGs = "860ef19b-820b-49d6-a774-d7a799459cd3"
 SparseArrays = "2f01184e-e22b-5df5-ae63-d93ebab69eaf"
+StableRNGs = "860ef19b-820b-49d6-a774-d7a799459cd3"
 StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
 StatsBase = "2913bbd2-ae8a-5f71-8c99-4fb6c76f3a91"
 StatsPlots = "f3b207a7-027a-5e70-b257-86293d7955fd"

docs/.gitignore

@@ -41,18 +41,19 @@ sudo fc-cache -vr
 fc-list | grep 'JuliaMono'
 
 echo "== install julia dependencies =="
-export JULIA_DEBUG='Documenter,PlotDocs,DemoCards'
-export DOCUMENTER_DEBUG=true  # Democards.jl
+if true; then
+  export JULIA_DEBUG='Documenter,Literate,DemoCards'
+  export DOCUMENTER_DEBUG=true  # Democards.jl
+fi
 
 export GKSwstype=nul  # Plots.jl/issues/3664
-export COLORTERM='truecolor'  # UnicodePlots.jl
+export COLORTERM=truecolor  # UnicodePlots.jl
 export PLOTDOCS_ANSICOLOR=true
 
 julia='xvfb-run julia --color=yes --project=docs'
 
 $julia -e '
-  using Pkg
-  Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()
+  using Pkg; Pkg.instantiate()
   Pkg.add("Conda"); Pkg.build("Conda"; verbose=true)
   using Conda; env, rc = Conda.ROOTENV, Conda.conda_rc(Conda.ROOTENV)
   Conda.runconda(`config --set auto_update_conda False --file $rc --force`, env)
@@ -75,13 +76,9 @@ $julia -e '
   Pkg.add("PyCall"); Pkg.build("PyCall"; verbose=true)
 '
 
-# tentative fix for `pyplot` bug: libstdc++.so.X: version `GLIBCXX_X.X.X' not found ...
-# export LD_PRELOAD=$(g++ --print-file-name=libstdc++.so)
-# export LD_PRELOAD=$($julia -e 'using Conda; joinpath(Conda.ROOTENV, "lib", "libstdc++.so") |> print')
-# echo $LD_PRELOAD
-
 echo "== build documentation for $GITHUB_REPOSITORY@$GITHUB_REF, triggerd by $GITHUB_ACTOR on $GITHUB_EVENT_NAME =="
 if [ "$GITHUB_REPOSITORY" == 'JuliaPlots/PlotDocs.jl' ]; then
+  $julia -e 'using Pkg; Pkg.add(PackageSpec(name="Plots", rev="master"))'
   $julia docs/make.jl
 elif [ "$GITHUB_REPOSITORY" == 'JuliaPlots/Plots.jl' ]; then
   $julia -e 'using Pkg; Pkg.add(PackageSpec(name="Plots", rev=split(ENV["GITHUB_REF"], "/", limit=3)[3])); Pkg.instantiate()'