DocumenterTools.package_devpath
—Functionpackage_devpath(pkg)
Returns the path to the top level directory of a devved out package source tree. The package is identified by its top level modulepkg
.
DocumenterTools.Generator
—ModuleProvides the functions related to generating documentation stubs.
DocumenterTools.Generator.gitignore
—Methodgitignore()
Contents of the default.gitignore
file.
DocumenterTools.Generator.index
—Methodindex(pkgname)
Contents of the defaultsrc/index.md
file.
DocumenterTools.Generator.make
—Methodmake(pkgname; format)
Contents of the defaultmake.jl
file.
DocumenterTools.Generator.mkdocs
—Methodmkdocs(pkgname; description, author, url)
Contents of the defaultmkdocs.yml
file.
DocumenterTools.Generator.project
—Methodproject(; format)
Contents of the defaultProject.toml
file.
DocumenterTools.Generator.savefile
—Methodsavefile(f, root, filename)
Attempts to save a file at$(root)/$(filename)
.f
will be called with file stream (seeopen
).
filename
can also be a file in a subdirectory (e.g.src/index.md
), and then then subdirectories will be created automatically.
DocumenterTools.Themes
—ModuleTheThemes
module contains APIs to more easily compile the Documenter Sass themes into CSS files.
To compile an Sass file into a Documenter theme, you can use theThemes.compile
function:
julia> using DocumenterTools: Themesjulia> Themes.compile("mytheme.scss")
When working on the Documenter built-in themes, theThemes.themewatcher
function can be used to automatically update all the built-in themes when any of the Sass files are modified. To enable it, just run
julia> using DocumenterTools: Themesjulia> Themes.themewatcher()
Note that it will read and overwrite the Sass and CSS files of the Documenter of the environment DocumenterTools is loaded in — make sure that you have Documenter added as a development dependency to that environment.
DocumenterTools.Themes.compile
—Functioncompile(src[, dst])
Compile an input Sass/SCSS filesrc
into a CSS file. The standard Documenter Sass/SCSS files are available in the include path.
The optionaldst
argument can be used to specify the output file. Otherwise, the file extension of thesrc
file is simply replaced by.css
.
DocumenterTools.Themes.compile_native_theme
—Methodcompile_native_theme(name; dst=nothing)
Compiles a native Documenter theme and places it into Documenter's assets directory.
Optionally, thedst
keyword argument can be used to specify the output file.
DocumenterTools.Themes.themewatcher
—Methodthemewatcher()
Starts an asynchronous background task that checks for changes in the Documenter Sass files and recompiles all native themes whenever changes are detected.
Settings
This document was generated withDocumenter.jl version 1.14.1 onWednesday 9 July 2025. Using Julia version 1.11.5.