Add OrdinaryDiffEq.jl API docs

Author: ChrisRackauckas

.gitignore

@@ -3,6 +3,8 @@
 *.jl.mem
 docs/build
 docs/site
+docs/src/api/ordinarydiffeq
+docs/ordinarydiffeq_pages.jl
 /Manifest.toml
 
 # vscode stuff

docs/make.jl

@@ -6,6 +6,23 @@ using Sundials, DASKR
 cp("./docs/Manifest.toml", "./docs/src/assets/Manifest.toml", force = true)
 cp("./docs/Project.toml", "./docs/src/assets/Project.toml", force = true)
 
+# Copy OrdinaryDiffEq.jl documentation
+ordinartdiffeq_docs_root = joinpath(dirname(pathof(OrdinaryDiffEq)), "..", "docs")
+ordinartdiffeq_docs_path = joinpath(ordinartdiffeq_docs_root, "src")
+if isdir(ordinartdiffeq_docs_path)
+    # Create the OrdinaryDiffEq API directory in the docs
+    ordinary_diffeq_dest = joinpath(@__DIR__, "src", "api", "ordinarydiffeq")
+    mkpath(dirname(ordinary_diffeq_dest))
+    
+    # Copy all the docs from OrdinaryDiffEq.jl
+    cp(ordinartdiffeq_docs_path, ordinary_diffeq_dest, force=true)
+    
+    # Copy the pages.jl file from OrdinaryDiffEq.jl
+    ordinary_diffeq_pages_dest = joinpath(@__DIR__, "ordinarydiffeq_pages.jl")
+    ordinary_diffeq_pages_file = joinpath(ordinartdiffeq_docs_root, "pages.jl")
+    cp(ordinary_diffeq_pages_file, ordinary_diffeq_pages_dest, force=true)
+end
+
 ENV["PLOTS_TEST"] = "true"
 ENV["GKSwstype"] = "100"
 

docs/pages.jl

@@ -1,3 +1,31 @@
+# Load OrdinaryDiffEq pages - must be available
+ordinary_diffeq_pages_file = joinpath(@__DIR__, "ordinarydiffeq_pages.jl")
+if !isfile(ordinary_diffeq_pages_file)
+    error("OrdinaryDiffEq pages file not found at: $ordinary_diffeq_pages_file. Run the build process first.")
+end
+
+include(ordinary_diffeq_pages_file)
+
+# Transform OrdinaryDiffEq pages to have the api/ordinarydiffeq prefix
+function transform_ordinarydiffeq_pages(pages_array)
+    transformed = []
+    for page in pages_array
+        if isa(page, String)
+            push!(transformed, "api/ordinarydiffeq/" * page)
+        elseif isa(page, Pair)
+            key, value = page
+            if isa(value, String)
+                push!(transformed, key => "api/ordinarydiffeq/" * value)
+            elseif isa(value, Vector)
+                push!(transformed, key => transform_ordinarydiffeq_pages(value))
+            end
+        end
+    end
+    return transformed
+end
+
+ordinary_diffeq_pages = transform_ordinarydiffeq_pages(pages)
+
 pages = Any["index.md",
     "getting_started.md",
     "Tutorials" => Any["tutorials/faster_ode_example.md",
@@ -63,6 +91,7 @@ pages = Any["index.md",
         "features/io.md",
         "features/low_dep.md",
         "features/progress_bar.md"],
-    "Detailed Solver APIs" => Any["api/sundials.md",
+    "External Solver APIs" => Any["api/sundials.md",
         "api/daskr.md"],
+    "OrdinaryDiffEq.jl API" => ordinary_diffeq_pages,
     "Extra Details" => Any["extras/timestepping.md"]]