Reference

Configuration

Types and functions for configuring documentation generation.

Function	Description
FooterConfig	Configuration for page footer.
NavbarItem	Configuration for navbar items.
QuartoConfig	Main configuration struct for QuartoDocBuilder.
ReferenceGroup	Configuration for a reference section group.
SectionConfig	Configuration for a navbar section (supports multiple dropdowns).
ThemeConfig	Configuration for theming and appearance.
default_config	default_config(module_name::Module) -> QuartoConfig
detect_repo	detect_repo() -> String
get_dark_theme	get_dark_theme(light_theme::String) -> String
load_config	load_config(path::String=“_quartodoc.toml”) -> Union{QuartoConfig, Nothing}
merge_config	merge_config(base::QuartoConfig, overrides::QuartoConfig) -> QuartoConfig
validate_config	validate_config(config::QuartoConfig) -> Bool

Content Selectors

pkgdown-style helpers for organizing reference pages by matching function names.

Function	Description
apply_selector	apply_selector(selector, symbols::Vector{Symbol}) -> Vector{Symbol}
auto_group_objects	auto_group_objects(module_name::Module) -> Vector{Tuple{ReferenceGroup, Vector{Symbol}}}
contains	contains(substring::String) -> Function
ends_with	ends_with(suffix::String) -> Function
filter_objects	filter_objects(module_name::Module, selectors::Vector) -> Vector{Symbol}
group_objects	group_objects(module_name::Module, groups::Vector{ReferenceGroup}) -> Vector{Tuple{ReferenceGroup…
has_docstring	has_docstring(module_name::Module) -> Function
is_exported	is_exported(module_name::Module) -> Function
is_function_symbol	is_function_symbol(module_name::Module) -> Function
is_type_symbol	is_type_symbol(module_name::Module) -> Function
matches	matches(pattern::Union{String, Regex}) -> Function
parse_content_selector	parse_content_selector(s::String) -> Union{Symbol, Function}
starts_with	starts_with(prefix::String) -> Function

Site Building

Core functions for generating documentation sites.

Function	Description
quarto_build_refpage	quarto_build_refpage(module_name; output = “docs/reference.qmd”)
quarto_build_refpage_grouped	quarto_build_refpage_grouped(module_name::Module, config::QuartoConfig; output::String=“docs/refe…
quarto_build_site	quarto_build_site(config::QuartoConfig)
quarto_index	quarto_index(; title::String=““)
quarto_rebuild_all	quarto_rebuild_all(config::QuartoConfig)
quarto_rebuild_reference	quarto_rebuild_reference(module_name::Module)
quarto_yaml_from_config	quarto_yaml_from_config(config::QuartoConfig; force::Bool=false)

Docstring Processing

Functions for extracting and formatting Julia docstrings to Quarto format.

Function	Description
get_objects_from_module	get_objects_from_module(m::Module) -> Vector{Docs.Binding}
quarto_callout_block	quarto_callout_block(s)
quarto_doc	quarto_doc(s::Symbol)
quarto_doc_page	quarto_doc_page(s; dir = “docs/reference”)
quarto_doc_short	quarto_doc_short(s::Symbol)
quarto_format	quarto_format(m::Markdown.Code, eval = false)

Articles & News {#sec-articles-&-news}

Article discovery and changelog generation.

Function	Description
ArticleInfo	ArticleInfo
NewsVersion	NewsVersion
create_article_template	create_article_template(filepath::String; title::String=““, order::Int=999)
create_news_template	create_news_template(path::String=“NEWS.md”; package_name::String=“Package”)
detect_get_started	detect_get_started(module_name::Module; dir::String=“docs/articles”) -> Union{String, Nothing}
discover_articles	discover_articles(dir::String=“docs/articles”) -> Vector{String}
discover_articles_recursive	discover_articles_recursive(dir::String=“docs/articles”) -> Vector{String}
get_article_info	get_article_info(filepath::String) -> ArticleInfo
get_article_title	get_article_title(filepath::String) -> String
has_news	has_news(config::QuartoConfig) -> Bool
linkify_github_refs	linkify_github_refs(text::String, repo::String) -> String
news_summary	news_summary(config::QuartoConfig) -> String
parse_news	parse_news(path::String=“NEWS.md”) -> Vector{NewsVersion}
quarto_news_page	quarto_news_page(config::QuartoConfig; output::String=“docs/news.qmd”)

Auto-linking

Automatic cross-reference linking in documentation.

Function	Description
ReferenceIndex	ReferenceIndex
autolink_references	autolink_references(text::String, index::ReferenceIndex) -> String
build_reference_index	build_reference_index(module_name::Module; base_path::String=“reference”) -> ReferenceIndex
create_reference_report	create_reference_report(module_name::Module) -> String
find_undefined_references	find_undefined_references(text::String, index::ReferenceIndex) -> Vector{String}
link_julia_docs	link_julia_docs(text::String) -> String
resolve_reference	resolve_reference(name::String, index::ReferenceIndex) -> Union{String, Nothing}

Styles & Themes {#sec-styles-&-themes}

CSS generation and theme customization.

Function	Description
quarto_styles_from_config	quarto_styles_from_config(config::QuartoConfig)

GitHub Integration

CI/CD workflow generation and deployment helpers.

Function	Description
quarto_docs_project_toml	quarto_docs_project_toml(module_name::Module)
quarto_github_action	quarto_github_action(; kwargs…)
quarto_github_action_simple	quarto_github_action_simple(; kwargs…)
quarto_makejl_template	quarto_makejl_template(module_name::Module; config_file::String=““)
quarto_setup_instructions	quarto_setup_instructions() -> String
setup_documentation	setup_documentation(module_name::Module; repo::String=““, kwargs…)