refactor(docs): update make.jl

docs/make.jl | 52 ++++++++++++++++++++++------------------------------  1 file changed, 22 insertions(+), 30 deletions(-)
This commit is contained in:
Jukka Aho
2026-05-09 16:30:24 +03:00
parent 482af34fea
commit 2a3b11592f
+18 -26
View File
@@ -1,35 +1,27 @@
# Modern Documenter.jl build script for JuliaFEM API documentation
# Generates markdown files for Quarto integration
using Documenter
using DocumenterMarkdown
using JuliaFEM
# Get directories
juliafem_dir = dirname(@__DIR__)
website_dir = joinpath(juliafem_dir, "juliafem.github.io")
build_dir = joinpath(website_dir, "api") # Build markdown directly to api/ directory
# Simple pages structure - just API documentation
pages = [
"Home" => "index.md",
"API Reference" => "api.md",
]
# Build API documentation as markdown
makedocs(
sitename = "JuliaFEM API",
sitename = "JuliaFEM.jl",
authors = "JuliaFEM Team",
modules = [JuliaFEM],
# Source and build directories
source = "api", # Use docs/api/ for source
build = build_dir, # Build markdown to website api/ directory
# Format: Generate markdown instead of HTML
format = DocumenterMarkdown.Markdown(),
# Documentation options
format = Documenter.HTML(;
prettyurls = get(ENV, "CI", nothing) == "true",
size_threshold = nothing,
size_threshold_warn = nothing,
),
pages = [
"Home" => "index.md",
"Elements and multiphysics" => "elements_multiphysics_teaser.md",
"Thermo-elastic walkthrough" => "thermo_elastic_walkthrough.md",
"Choosing an assembler" => "assembler_choice.md",
"Legacy module" => "legacy.md",
"Developer" => [
"Architecture layers" => "developer/architecture_layers.md",
"Repository layout" => "repository_layout.md",
],
"API Reference" => "api.md",
],
checkdocs = :none,
doctest = false,
linkcheck = false,