mirror of
https://github.com/JuliaFEM/JuliaFEM.jl.git
synced 2026-08-06 04:21:33 +00:00
Jukka Aho
7125a617f8
Simplify documentation build script to generate API docs only. Remove legacy code for generating examples, packages, and guides. - Replace complex build system with simple Documenter.jl setup - Generate markdown output for Quarto integration - Build directly to juliafem.github.io/api/ directory - Remove functions: copy_docs, add_page!, generate_* functions - Use DocumenterMarkdown format instead of HTML
38 lines
1.0 KiB
Julia
38 lines
1.0 KiB
Julia
# 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",
|
|
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
|
|
checkdocs = :none,
|
|
doctest = false,
|
|
linkcheck = false,
|
|
warnonly = [:missing_docs, :cross_references],
|
|
)
|