diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index cefa73be8..07921ddfe 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -3,9 +3,13 @@ on: pull_request: branches: - master + paths-ignore: + - 'docs/**' push: branches: - master + paths-ignore: + - 'docs/**' jobs: test: runs-on: ubuntu-latest diff --git a/docs/Project.toml b/docs/Project.toml index 0edd8d5a1..9a18ffb63 100644 --- a/docs/Project.toml +++ b/docs/Project.toml @@ -10,7 +10,7 @@ Symbolics = "0c5d862f-8b57-4792-8d23-62f2024744c7" [compat] BenchmarkTools = "1.3" -Documenter = "0.27" +Documenter = "1" Latexify = "0.15, 0.16" OrdinaryDiffEq = "6.31" Plots = "1.36" diff --git a/docs/make.jl b/docs/make.jl index 23a697e8b..0e00255f3 100644 --- a/docs/make.jl +++ b/docs/make.jl @@ -1,5 +1,8 @@ using Documenter, Symbolics, SymbolicUtils +cp("./docs/Manifest.toml", "./docs/src/assets/Manifest.toml", force = true) +cp("./docs/Project.toml", "./docs/src/assets/Project.toml", force = true) + # Make sure that plots don't throw a bunch of warnings / errors! ENV["GKSwstype"] = "100" using Plots @@ -18,19 +21,10 @@ makedocs( sitename="Symbolics.jl", authors="Chris Rackauckas", modules=[Symbolics,SymbolicUtils], - clean=true,doctest=false, - strict=[ - :doctest, - :linkcheck, - :parse_error, - :example_block, - # Other available options are - # :autodocs_block, :cross_references, :docs_block, :eval_block, :example_block, :footnote, :meta_block, :missing_docs, :setup_block - ], - format = Documenter.HTML(#analytics = "UA-90474609-3", - assets = ["assets/favicon.ico"]), + clean=true, doctest=false, linkcheck = true, + format = Documenter.HTML(assets = ["assets/favicon.ico"], mathengine = mathengine, - #canonical="https://mtk.sciml.ai/stable/"), + canonical="https://docs.sciml.ai/Symbolics/stable/"), pages=[ "Home" => "index.md", "getting_started.md", diff --git a/docs/src/index.md b/docs/src/index.md index 5bb52465b..bda1e63a3 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -80,3 +80,61 @@ to be listed here, feel free to open a pull request! - [ReversePropagation.jl](https://github.com/dpsanders/ReversePropagation.jl): Source-to-source reverse mode automatic differentiation - Automated tracing of code and construction of backpropagation equations - Composes with symbolic transformation and simplification functionality + +## Reproducibility + +```@raw html +
The documentation of this SciML package was built using these direct dependencies, +``` + +```@example +using Pkg # hide +Pkg.status() # hide +``` + +```@raw html +
+``` + +```@raw html +
and using this machine and Julia version. +``` + +```@example +using InteractiveUtils # hide +versioninfo() # hide +``` + +```@raw html +
+``` + +```@raw html +
A more complete overview of all dependencies and their versions is also provided. +``` + +```@example +using Pkg # hide +Pkg.status(; mode = PKGMODE_MANIFEST) # hide +``` + +```@raw html +
+``` + +```@eval +using TOML +using Markdown +version = TOML.parse(read("../../Project.toml", String))["version"] +name = TOML.parse(read("../../Project.toml", String))["name"] +link_manifest = "https://github.com/SciML/" * name * ".jl/tree/gh-pages/v" * version * + "/assets/Manifest.toml" +link_project = "https://github.com/SciML/" * name * ".jl/tree/gh-pages/v" * version * + "/assets/Project.toml" +Markdown.parse("""You can also download the +[manifest]($link_manifest) +file and the +[project]($link_project) +file. +""") +``` \ No newline at end of file