# DocumenterTools

DocumenterTools.package_devpathFunction
package_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 module pkg.

## Generator

DocumenterTools.Generator.savefileMethod
savefile(f, root, filename)


Attempts to save a file at $(root)/$(filename). f will be called with file stream (see open).

filename can also be a file in a subdirectory (e.g. src/index.md), and then then subdirectories will be created automatically.

## Themes

Experimental API

The theming API in DocumenterTools is very experimental and may change without notice.

DocumenterTools.ThemesModule

The Themes 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 the Themes.compile function:

julia> using DocumenterTools: Themes

julia> Themes.compile("mytheme.scss")

When working on the Documenter built-in themes, the Themes.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: Themes

julia> 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.compileFunction
compile(src[, dst])

Compile an input Sass/SCSS file src into a CSS file. The standard Documenter Sass/SCSS files are available in the include path.

The optional dst argument can be used to specify the output file. Otherwise, the file extension of the src file is simply replaced by .css.

DocumenterTools.Themes.compile_native_themeMethod
compile_native_theme(name; dst=nothing)

Compiles a native Documenter theme and places it into Documenter's assets directory.

Optionally, the dst keyword argument can be used to specify the output file.

DocumenterTools.Themes.themewatcherMethod
themewatcher()

Starts an asynchronous background task that checks for changes in the Documenter Sass files and recompiles all native themes whenever changes are detected.