update docs

Author: GiggleLiu

.gitignore

@@ -5,4 +5,5 @@ _test.bin
 _test.txt
 docs/build/
 docs/src/tutorials/
-docs/src/assets/indigo.css
+docs/src/assets/indigo.css
+docs/src/notebooks

docs/Project.toml

@@ -5,4 +5,5 @@ GenericTensorNetworks = "3521c873-ad32-4bb4-b63d-f4f178f42b49"
 Graphs = "86223c79-3864-5bf0-83f7-82e725a168b6"
 Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
 LiveServer = "16fef848-5104-11e9-1b77-fb7a48bbb589"
+PlutoStaticHTML = "359b1769-a58e-495b-9770-312e911026ad"
 Polynomials = "f27b6e38-b328-58d1-80ce-0feddd5e7a45"

docs/make.jl

@@ -3,6 +3,7 @@ using GenericTensorNetworks
 using GenericTensorNetworks: TropicalNumbers, Polynomials, Mods, OMEinsum, OMEinsumContractionOrders
 using Documenter
 using DocThemeIndigo
+using PlutoStaticHTML
 using Literate
 
 for each in readdir(pkgdir(GenericTensorNetworks, "examples"))
@@ -14,6 +15,22 @@ for each in readdir(pkgdir(GenericTensorNetworks, "examples"))
     Literate.markdown(input_file, output_dir; name=each[1:end-3], execute=false)
 end
 
+"""Run all Pluto notebooks (".jl" files) in `notebook_dir` and write outputs to HTML files."""
+function build()
+    notebook_dir = joinpath(pkgdir(GenericTensorNetworks), "notebooks")
+    target_dir = joinpath(pkgdir(GenericTensorNetworks), "docs", "src", "notebooks")
+    cp(notebook_dir, target_dir)
+    println("Building tutorials")
+    # Evaluate notebooks in the same process to avoid having to recompile from scratch each time.
+    # This is similar to how Documenter and Franklin evaluate code.
+    # Note that things like method overrides and other global changes may leak between notebooks!
+    use_distributed = false
+    output_format = documenter_output
+    bopts = BuildOptions(target_dir; use_distributed, output_format)
+    build_notebooks(bopts)
+    return nothing
+end
+
 indigo = DocThemeIndigo.install(GenericTensorNetworks)
 DocMeta.setdocmeta!(GenericTensorNetworks, :DocTestSetup, :(using GenericTensorNetworks); recursive=true)