@ -26,4 +26,4 @@ include("file2.jl")</code></pre><p>Let's say we have saved this fi
end
end
return str
return str
end</code></pre><p>(of course replace <code>included</code> with your respective files)</p><p>Finally, you simply pass this function to e.g. <ahref="../outputformats/#Literate.markdown"><code>Literate.markdown</code></a> as</p><pre><codeclass="language-julia hljs">Literate.markdown("examples.jl", "path/to/save/markdown";
end</code></pre><p>(of course replace <code>included</code> with your respective files)</p><p>Finally, you simply pass this function to e.g. <ahref="../outputformats/#Literate.markdown"><code>Literate.markdown</code></a> as</p><pre><codeclass="language-julia hljs">Literate.markdown("examples.jl", "path/to/save/markdown";
name = "markdown_file_name", preprocess = replace_includes)</code></pre><p>and you will see that in the final output file (here <code>markdown_file_name.md</code>) the <code>include</code> statements are replaced with the actual code to be included!</p><p>This approach is used for generating <ahref="https://juliadynamics.github.io/TimeseriesPrediction.jl/latest/stexamples/">the examples</a> in the documentation of the <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl">TimeseriesPrediction.jl</a> package. The <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl/tree/dcb080376a7861716147c04e45c473f55bb9a078/examples">example files</a>, included together in the <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl/blob/dcb080376a7861716147c04e45c473f55bb9a078/docs/src/stexamples.jl">stexamples.jl</a> file, are processed by literate via this <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl/blob/dcb080376a7861716147c04e45c473f55bb9a078/docs/make.jl">make.jl</a> file to generate the markdown and code cells of the documentation.</p></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../outputformats/">« <strong>4.</strong> Output formats</a><aclass="docs-footer-nextpage"href="../documenter/"><strong>6.</strong> Interaction with Documenter.jl »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Wednesday 19 November 2025 18:04">Wednesday 19 November 2025</span>. Using Julia version 1.12.1.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
name = "markdown_file_name", preprocess = replace_includes)</code></pre><p>and you will see that in the final output file (here <code>markdown_file_name.md</code>) the <code>include</code> statements are replaced with the actual code to be included!</p><p>This approach is used for generating <ahref="https://juliadynamics.github.io/TimeseriesPrediction.jl/latest/stexamples/">the examples</a> in the documentation of the <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl">TimeseriesPrediction.jl</a> package. The <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl/tree/dcb080376a7861716147c04e45c473f55bb9a078/examples">example files</a>, included together in the <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl/blob/dcb080376a7861716147c04e45c473f55bb9a078/docs/src/stexamples.jl">stexamples.jl</a> file, are processed by literate via this <ahref="https://github.com/JuliaDynamics/TimeseriesPrediction.jl/blob/dcb080376a7861716147c04e45c473f55bb9a078/docs/make.jl">make.jl</a> file to generate the markdown and code cells of the documentation.</p></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../outputformats/">« <strong>4.</strong> Output formats</a><aclass="docs-footer-nextpage"href="../documenter/"><strong>6.</strong> Interaction with Documenter.jl »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Tuesday 2 December 2025 15:39">Tuesday 2 December 2025</span>. Using Julia version 1.12.2.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
> An important warning.</code></pre></li><li><p>Whereas Documenter requires HTML blocks to be escaped</p><pre><codeclass="nohighlight hljs">```@raw html
> An important warning.</code></pre></li><li><p>Whereas Documenter requires HTML blocks to be escaped</p><pre><codeclass="nohighlight hljs">```@raw html
<tag>...</tag>
<tag>...</tag>
```</code></pre><p>the output to a notebook markdown cell will be raw HTML</p><pre><codeclass="nohighlight hljs"><tag>...</tag></code></pre></li></ul><h3id="[Literate.script](@ref):"><aclass="docs-heading-anchor"href="#[Literate.script](@ref):"><ahref="../outputformats/#Literate.script"><code>Literate.script</code></a>:</a><aid="[Literate.script](@ref):-1"></a><aclass="docs-heading-anchor-permalink"href="#[Literate.script](@ref):"title="Permalink"></a></h3><ul><li>Documenter style <code>@ref</code>s, <code>@extref</code>s and <code>@id</code> will be removed. This means that you can use <code>@ref</code>, <code>@extref</code> and <code>@id</code> in the source file without them leaking to the script.</li></ul></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../customprocessing/">« <strong>5.</strong> Custom pre- and post-processing</a><aclass="docs-footer-nextpage"href="../tips/"><strong>7.</strong> Tips and tricks »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Wednesday 19 November 2025 18:04">Wednesday 19 November 2025</span>. Using Julia version 1.12.1.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
```</code></pre><p>the output to a notebook markdown cell will be raw HTML</p><pre><codeclass="nohighlight hljs"><tag>...</tag></code></pre></li></ul><h3id="[Literate.script](@ref):"><aclass="docs-heading-anchor"href="#[Literate.script](@ref):"><ahref="../outputformats/#Literate.script"><code>Literate.script</code></a>:</a><aid="[Literate.script](@ref):-1"></a><aclass="docs-heading-anchor-permalink"href="#[Literate.script](@ref):"title="Permalink"></a></h3><ul><li>Documenter style <code>@ref</code>s, <code>@extref</code>s and <code>@id</code> will be removed. This means that you can use <code>@ref</code>, <code>@extref</code> and <code>@id</code> in the source file without them leaking to the script.</li></ul></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../customprocessing/">« <strong>5.</strong> Custom pre- and post-processing</a><aclass="docs-footer-nextpage"href="../tips/"><strong>7.</strong> Tips and tricks »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Tuesday 2 December 2025 15:39">Tuesday 2 December 2025</span>. Using Julia version 1.12.2.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
#md # ```</code></pre><p>The lines in the example above would be filtered out in the preprocessing step, unless we are generating a markdown file. When generating a markdown file we would simply remove the leading <code>#md</code> from the lines. Beware that the space after the tag is also removed.</p><p>The <code>#src</code> token can also be placed at the <em>end</em> of a line. This is to make it possible to have code lines exclusive to the source code, and not just comment lines. For example, if the source file is included in the test suite we might want to add a <code>@test</code> at the end without this showing up in the outputs:</p><pre><codeclass="language-julia hljs">using Test #src
#md # ```</code></pre><p>The lines in the example above would be filtered out in the preprocessing step, unless we are generating a markdown file. When generating a markdown file we would simply remove the leading <code>#md</code> from the lines. Beware that the space after the tag is also removed.</p><p>The <code>#src</code> token can also be placed at the <em>end</em> of a line. This is to make it possible to have code lines exclusive to the source code, and not just comment lines. For example, if the source file is included in the test suite we might want to add a <code>@test</code> at the end without this showing up in the outputs:</p><pre><codeclass="language-julia hljs">using Test #src
@test result == expected_result #src</code></pre><h2id="Default-replacements"><aclass="docs-heading-anchor"href="#Default-replacements"><strong>2.3.</strong> Default replacements</a><aid="Default-replacements-1"></a><aclass="docs-heading-anchor-permalink"href="#Default-replacements"title="Permalink"></a></h2><p>The following convenience "macros"/source placeholders are always expanded:</p><ul><li><p><code>@__NAME__</code>:</p><p>expands to the <code>name</code> keyword argument to <ahref="../outputformats/#Literate.markdown"><code>Literate.markdown</code></a>, <ahref="../outputformats/#Literate.notebook"><code>Literate.notebook</code></a> and <ahref="../outputformats/#Literate.script"><code>Literate.script</code></a> (defaults to the filename of the input file).</p></li><li><p><code>@__REPO_ROOT_URL__</code>:</p><p>Can be used to link to files in the repository. For example <code>@__REPO_ROOT_URL__/src/Literate.jl</code> would link to the <ahref="https://github.com/fredrikekre/Literate.jl/blob/master/src/Literate.jl">source of the Literate module</a>. This variable is automatically determined on Travis CI, GitHub Actions and GitLab CI, but can be configured, see <ahref="../outputformats/#Configuration">Configuration</a>.</p></li><li><p><code>@__NBVIEWER_ROOT_URL__</code>:</p><p>Can be used if you want a link that opens the generated notebook in <ahref="http://nbviewer.jupyter.org/">http://nbviewer.jupyter.org/</a>. This variable is automatically determined on Travis CI, GitHub Actions and GitLab CI, but can be configured, see <ahref="../outputformats/#Configuration">Configuration</a>.</p></li><li><p><code>@__BINDER_ROOT_URL__</code>:</p><p>Can be used if you want a link that opens the generated notebook in <ahref="https://mybinder.org/">https://mybinder.org/</a>. For example, to add a binder-badge in e.g. the HTML output you can use:</p><pre><codeclass="nohighlight hljs">[](@__BINDER_ROOT_URL__/path/to/notebook.inpynb)</code></pre><p>This variable is automatically determined on Travis CI, GitHub Actions and GitLab CI, but can be configured, see <ahref="../outputformats/#Configuration">Configuration</a>.</p></li></ul></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../">« <strong>1.</strong> Introduction</a><aclass="docs-footer-nextpage"href="../pipeline/"><strong>3.</strong> Processing pipeline »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Wednesday 19 November 2025 18:04">Wednesday 19 November 2025</span>. Using Julia version 1.12.1.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
@test result == expected_result #src</code></pre><h2id="Default-replacements"><aclass="docs-heading-anchor"href="#Default-replacements"><strong>2.3.</strong> Default replacements</a><aid="Default-replacements-1"></a><aclass="docs-heading-anchor-permalink"href="#Default-replacements"title="Permalink"></a></h2><p>The following convenience "macros"/source placeholders are always expanded:</p><ul><li><p><code>@__NAME__</code>:</p><p>expands to the <code>name</code> keyword argument to <ahref="../outputformats/#Literate.markdown"><code>Literate.markdown</code></a>, <ahref="../outputformats/#Literate.notebook"><code>Literate.notebook</code></a> and <ahref="../outputformats/#Literate.script"><code>Literate.script</code></a> (defaults to the filename of the input file).</p></li><li><p><code>@__REPO_ROOT_URL__</code>:</p><p>Can be used to link to files in the repository. For example <code>@__REPO_ROOT_URL__/src/Literate.jl</code> would link to the <ahref="https://github.com/fredrikekre/Literate.jl/blob/master/src/Literate.jl">source of the Literate module</a>. This variable is automatically determined on Travis CI, GitHub Actions and GitLab CI, but can be configured, see <ahref="../outputformats/#Configuration">Configuration</a>.</p></li><li><p><code>@__NBVIEWER_ROOT_URL__</code>:</p><p>Can be used if you want a link that opens the generated notebook in <ahref="http://nbviewer.jupyter.org/">http://nbviewer.jupyter.org/</a>. This variable is automatically determined on Travis CI, GitHub Actions and GitLab CI, but can be configured, see <ahref="../outputformats/#Configuration">Configuration</a>.</p></li><li><p><code>@__BINDER_ROOT_URL__</code>:</p><p>Can be used if you want a link that opens the generated notebook in <ahref="https://mybinder.org/">https://mybinder.org/</a>. For example, to add a binder-badge in e.g. the HTML output you can use:</p><pre><codeclass="nohighlight hljs">[](@__BINDER_ROOT_URL__/path/to/notebook.inpynb)</code></pre><p>This variable is automatically determined on Travis CI, GitHub Actions and GitLab CI, but can be configured, see <ahref="../outputformats/#Configuration">Configuration</a>.</p></li></ul></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../">« <strong>1.</strong> Introduction</a><aclass="docs-footer-nextpage"href="../pipeline/"><strong>3.</strong> Processing pipeline »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Tuesday 2 December 2025 15:39">Tuesday 2 December 2025</span>. Using Julia version 1.12.2.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
plot(x, [y1, y2])</code></pre><imgsrc="31f14fb6.svg"alt="Example block output"/><h3id="Custom-processing"><aclass="docs-heading-anchor"href="#Custom-processing">Custom processing</a><aid="Custom-processing-1"></a><aclass="docs-heading-anchor-permalink"href="#Custom-processing"title="Permalink"></a></h3><p>It is possible to give Literate custom pre- and post-processing functions. For example, here we insert a placeholder value <code>y = 321</code> in the source, and use a preprocessing function that replaces it with <code>y = 321</code> in the rendered output.</p><pre><codeclass="language-julia hljs">x = 123</code></pre><preclass="documenter-example-output"><codeclass="nohighlight hljs ansi">123</code></pre><p>In this case the preprocessing function is defined by</p><pre><codeclass="language-julia hljs">function pre(s::String)
plot(x, [y1, y2])</code></pre><imgsrc="c1f19e6a.svg"alt="Example block output"/><h3id="Custom-processing"><aclass="docs-heading-anchor"href="#Custom-processing">Custom processing</a><aid="Custom-processing-1"></a><aclass="docs-heading-anchor-permalink"href="#Custom-processing"title="Permalink"></a></h3><p>It is possible to give Literate custom pre- and post-processing functions. For example, here we insert a placeholder value <code>y = 321</code> in the source, and use a preprocessing function that replaces it with <code>y = 321</code> in the rendered output.</p><pre><codeclass="language-julia hljs">x = 123</code></pre><preclass="documenter-example-output"><codeclass="nohighlight hljs ansi">123</code></pre><p>In this case the preprocessing function is defined by</p><pre><codeclass="language-julia hljs">function pre(s::String)
s = replace(s, "x = 123" =>"y = 321")
s = replace(s, "x = 123" =>"y = 321")
return s
return s
end</code></pre><preclass="documenter-example-output"><codeclass="nohighlight hljs ansi">pre (generic function with 1 method)</code></pre><h3id="documenter-interaction"><aclass="docs-heading-anchor"href="#documenter-interaction">Documenter.jl interaction</a><aid="documenter-interaction-1"></a><aclass="docs-heading-anchor-permalink"href="#documenter-interaction"title="Permalink"></a></h3><p>In the source file it is possible to use Documenter.jl style references, such as <code>@ref</code> and <code>@id</code>. These will be filtered out in the notebook output. For example, <ahref="#documenter-interaction">here is a link</a>, but it is only visible as a link if you are reading the markdown output. We can also use equations:</p><pclass="math-container">\[\int_\Omega \nabla v \cdot \nabla u\ \mathrm{d}\Omega = \int_\Omega v f\ \mathrm{d}\Omega\]</p><p>using Documenters math syntax. Documenters syntax is automatically changed to <code>\begin{equation} ... \end{equation}</code> in the notebook output to display correctly.</p><hr/><p><em>This page was generated using <ahref="https://github.com/fredrikekre/Literate.jl">Literate.jl</a>.</em></p></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../../tips/">« <strong>7.</strong> Tips and tricks</a><aclass="docs-footer-nextpage"href="../../changelog/"><strong>9.</strong> Changelog »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Wednesday 19 November 2025 18:04">Wednesday 19 November 2025</span>. Using Julia version 1.12.1.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
end</code></pre><preclass="documenter-example-output"><codeclass="nohighlight hljs ansi">pre (generic function with 1 method)</code></pre><h3id="documenter-interaction"><aclass="docs-heading-anchor"href="#documenter-interaction">Documenter.jl interaction</a><aid="documenter-interaction-1"></a><aclass="docs-heading-anchor-permalink"href="#documenter-interaction"title="Permalink"></a></h3><p>In the source file it is possible to use Documenter.jl style references, such as <code>@ref</code> and <code>@id</code>. These will be filtered out in the notebook output. For example, <ahref="#documenter-interaction">here is a link</a>, but it is only visible as a link if you are reading the markdown output. We can also use equations:</p><pclass="math-container">\[\int_\Omega \nabla v \cdot \nabla u\ \mathrm{d}\Omega = \int_\Omega v f\ \mathrm{d}\Omega\]</p><p>using Documenters math syntax. Documenters syntax is automatically changed to <code>\begin{equation} ... \end{equation}</code> in the notebook output to display correctly.</p><hr/><p><em>This page was generated using <ahref="https://github.com/fredrikekre/Literate.jl">Literate.jl</a>.</em></p></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../../tips/">« <strong>7.</strong> Tips and tricks</a><aclass="docs-footer-nextpage"href="../../changelog/"><strong>9.</strong> Changelog »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Tuesday 2 December 2025 15:39">Tuesday 2 December 2025</span>. Using Julia version 1.12.2.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
y = 2 // 5</code></pre><p>Chunk #3:</p><pre><codeclass="language-markdown hljs">When adding `x` and `y` together we obtain a new rational number:</code></pre><p>Chunk #4:</p><pre><codeclass="language-julia hljs">z = x + y</code></pre><p>It is then up to the <ahref="#Document-generation">Document generation</a> step to decide how these chunks should be treated.</p><h3id="Custom-control-over-chunk-splits"><aclass="docs-heading-anchor"href="#Custom-control-over-chunk-splits">Custom control over chunk splits</a><aid="Custom-control-over-chunk-splits-1"></a><aclass="docs-heading-anchor-permalink"href="#Custom-control-over-chunk-splits"title="Permalink"></a></h3><p>Sometimes it is convenient to be able to manually control how the chunks are split. For example, if you want to split a block of code into two, such that they end up in two different <code>@example</code> blocks or notebook cells. The <code>#-</code> token can be used for this purpose. All lines starting with <code>#-</code> are used as "chunk-splitters":</p><pre><codeclass="language-julia hljs">x = 1 // 3
y = 2 // 5</code></pre><p>Chunk #3:</p><pre><codeclass="language-markdown hljs">When adding `x` and `y` together we obtain a new rational number:</code></pre><p>Chunk #4:</p><pre><codeclass="language-julia hljs">z = x + y</code></pre><p>It is then up to the <ahref="#Document-generation">Document generation</a> step to decide how these chunks should be treated.</p><h3id="Custom-control-over-chunk-splits"><aclass="docs-heading-anchor"href="#Custom-control-over-chunk-splits">Custom control over chunk splits</a><aid="Custom-control-over-chunk-splits-1"></a><aclass="docs-heading-anchor-permalink"href="#Custom-control-over-chunk-splits"title="Permalink"></a></h3><p>Sometimes it is convenient to be able to manually control how the chunks are split. For example, if you want to split a block of code into two, such that they end up in two different <code>@example</code> blocks or notebook cells. The <code>#-</code> token can be used for this purpose. All lines starting with <code>#-</code> are used as "chunk-splitters":</p><pre><codeclass="language-julia hljs">x = 1 // 3
y = 2 // 5
y = 2 // 5
#-
#-
z = x + y</code></pre><p>The example above would result in two consecutive code-chunks.</p><divclass="admonition is-success"id="Tip-fe7226d986c6db44"><headerclass="admonition-header">Tip<aclass="admonition-anchor"href="#Tip-fe7226d986c6db44"title="Permalink"></a></header><divclass="admonition-body"><p>The rest of the line, after <code>#-</code>, is discarded, so it is possible to use e.g. <code>#-------------</code> as a chunk splitter, which may make the source code more readable.</p></div></div><p>It is also possible to use <code>#+</code> as a chunk splitter. The difference between <code>#+</code> and <code>#-</code> is that <code>#+</code> enables Documenter's "continued"-blocks, see the <ahref="https://juliadocs.github.io/Documenter.jl/stable/">Documenter manual</a>.</p><h2id="Document-generation"><aclass="docs-heading-anchor"href="#Document-generation"><strong>3.3.</strong> Document generation</a><aid="Document-generation-1"></a><aclass="docs-heading-anchor-permalink"href="#Document-generation"title="Permalink"></a></h2><p>After the parsing it is time to generate the output. What is done in this step is very different depending on the output target, and it is described in more detail in the Output format sections: <ahref="../outputformats/#Markdown-output">Markdown output</a>, <ahref="../outputformats/#Notebook-output">Notebook output</a> and <ahref="../outputformats/#Script-output">Script output</a>. Using the default settings, the following is happening:</p><ul><li>Markdown output: markdown chunks are printed as-is, code chunks are put inside a code fence (defaults to <code>@example</code>-blocks),</li><li>Notebook output: markdown chunks are printed in markdown cells, code chunks are put in code cells,</li><li>Script output: markdown chunks are discarded, code chunks are printed as-is.</li></ul><h2id="Post-processing"><aclass="docs-heading-anchor"href="#Post-processing"><strong>3.4.</strong> Post-processing</a><aid="Post-processing-1"></a><aclass="docs-heading-anchor-permalink"href="#Post-processing"title="Permalink"></a></h2><p>When the document is generated the user, again, has the option to hook-into the generation with a custom post-processing function. The reason is that one might want to change things that are only visible in the rendered document. See <ahref="../customprocessing/#Custom-pre-and-post-processing">Custom pre- and post-processing</a>.</p><h2id="Writing-to-file"><aclass="docs-heading-anchor"href="#Writing-to-file"><strong>3.5.</strong> Writing to file</a><aid="Writing-to-file-1"></a><aclass="docs-heading-anchor-permalink"href="#Writing-to-file"title="Permalink"></a></h2><p>The last step of the generation is writing to file. The result is written to <code>$(outputdir)/$(name)(.md|.ipynb|.jl)</code> where <code>outputdir</code> is the output directory supplied by the user (for example <code>docs/generated</code>), and <code>name</code> is a user supplied filename. It is recommended to add the output directory to <code>.gitignore</code> since the idea is that the generated documents will be generated as part of the build process rather than being files in the repo.</p></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../fileformat/">« <strong>2.</strong> File format</a><aclass="docs-footer-nextpage"href="../outputformats/"><strong>4.</strong> Output formats »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Wednesday 19 November 2025 18:04">Wednesday 19 November 2025</span>. Using Julia version 1.12.1.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
z = x + y</code></pre><p>The example above would result in two consecutive code-chunks.</p><divclass="admonition is-success"id="Tip-fe7226d986c6db44"><headerclass="admonition-header">Tip<aclass="admonition-anchor"href="#Tip-fe7226d986c6db44"title="Permalink"></a></header><divclass="admonition-body"><p>The rest of the line, after <code>#-</code>, is discarded, so it is possible to use e.g. <code>#-------------</code> as a chunk splitter, which may make the source code more readable.</p></div></div><p>It is also possible to use <code>#+</code> as a chunk splitter. The difference between <code>#+</code> and <code>#-</code> is that <code>#+</code> enables Documenter's "continued"-blocks, see the <ahref="https://juliadocs.github.io/Documenter.jl/stable/">Documenter manual</a>.</p><h2id="Document-generation"><aclass="docs-heading-anchor"href="#Document-generation"><strong>3.3.</strong> Document generation</a><aid="Document-generation-1"></a><aclass="docs-heading-anchor-permalink"href="#Document-generation"title="Permalink"></a></h2><p>After the parsing it is time to generate the output. What is done in this step is very different depending on the output target, and it is described in more detail in the Output format sections: <ahref="../outputformats/#Markdown-output">Markdown output</a>, <ahref="../outputformats/#Notebook-output">Notebook output</a> and <ahref="../outputformats/#Script-output">Script output</a>. Using the default settings, the following is happening:</p><ul><li>Markdown output: markdown chunks are printed as-is, code chunks are put inside a code fence (defaults to <code>@example</code>-blocks),</li><li>Notebook output: markdown chunks are printed in markdown cells, code chunks are put in code cells,</li><li>Script output: markdown chunks are discarded, code chunks are printed as-is.</li></ul><h2id="Post-processing"><aclass="docs-heading-anchor"href="#Post-processing"><strong>3.4.</strong> Post-processing</a><aid="Post-processing-1"></a><aclass="docs-heading-anchor-permalink"href="#Post-processing"title="Permalink"></a></h2><p>When the document is generated the user, again, has the option to hook-into the generation with a custom post-processing function. The reason is that one might want to change things that are only visible in the rendered document. See <ahref="../customprocessing/#Custom-pre-and-post-processing">Custom pre- and post-processing</a>.</p><h2id="Writing-to-file"><aclass="docs-heading-anchor"href="#Writing-to-file"><strong>3.5.</strong> Writing to file</a><aid="Writing-to-file-1"></a><aclass="docs-heading-anchor-permalink"href="#Writing-to-file"title="Permalink"></a></h2><p>The last step of the generation is writing to file. The result is written to <code>$(outputdir)/$(name)(.md|.ipynb|.jl)</code> where <code>outputdir</code> is the output directory supplied by the user (for example <code>docs/generated</code>), and <code>name</code> is a user supplied filename. It is recommended to add the output directory to <code>.gitignore</code> since the idea is that the generated documents will be generated as part of the build process rather than being files in the repo.</p></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../fileformat/">« <strong>2.</strong> File format</a><aclass="docs-footer-nextpage"href="../outputformats/"><strong>4.</strong> Output formats »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Tuesday 2 December 2025 15:39">Tuesday 2 December 2025</span>. Using Julia version 1.12.2.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
img = DisplayAs.PNG(img)</code></pre><p>This can save some memory, since the image is never captured in e.g. SVG or HTML formats.</p><divclass="admonition is-info"id="Note-81522c929f76d3a9"><headerclass="admonition-header">Note<aclass="admonition-anchor"href="#Note-81522c929f76d3a9"title="Permalink"></a></header><divclass="admonition-body"><p>It is best to always let the object be showable as <code>text/plain</code>. This can be achieved by nested calls to <code>DisplayAs</code> output types. For example, to limit an image <code>img</code> to be showable as just <code>image/png</code> and <code>text/plain</code> you can use</p><pre><codeclass="language-julia hljs">img = plot(...)
img = DisplayAs.PNG(img)</code></pre><p>This can save some memory, since the image is never captured in e.g. SVG or HTML formats.</p><divclass="admonition is-info"id="Note-81522c929f76d3a9"><headerclass="admonition-header">Note<aclass="admonition-anchor"href="#Note-81522c929f76d3a9"title="Permalink"></a></header><divclass="admonition-body"><p>It is best to always let the object be showable as <code>text/plain</code>. This can be achieved by nested calls to <code>DisplayAs</code> output types. For example, to limit an image <code>img</code> to be showable as just <code>image/png</code> and <code>text/plain</code> you can use</p><pre><codeclass="language-julia hljs">img = plot(...)
img = DisplayAs.Text(DisplayAs.PNG(img))</code></pre></div></div><h3id="printing-tables-in-markdown"><aclass="docs-heading-anchor"href="#printing-tables-in-markdown">Printing tables in Markdown</a><aid="printing-tables-in-markdown-1"></a><aclass="docs-heading-anchor-permalink"href="#printing-tables-in-markdown"title="Permalink"></a></h3><p>Tables that support the <ahref="https://tables.juliadata.org/">Tables.jl</a> interface can be included in Markdown output with the lightweight package <ahref="https://github.com/tpapp/MarkdownTables.jl">MarkdownTables.jl</a>.</p><pre><codeclass="language-julia hljs">using MarkdownTables
img = DisplayAs.Text(DisplayAs.PNG(img))</code></pre></div></div><h3id="printing-tables-in-markdown"><aclass="docs-heading-anchor"href="#printing-tables-in-markdown">Printing tables in Markdown</a><aid="printing-tables-in-markdown-1"></a><aclass="docs-heading-anchor-permalink"href="#printing-tables-in-markdown"title="Permalink"></a></h3><p>Tables that support the <ahref="https://tables.juliadata.org/">Tables.jl</a> interface can be included in Markdown output with the lightweight package <ahref="https://github.com/tpapp/MarkdownTables.jl">MarkdownTables.jl</a>.</p><pre><codeclass="language-julia hljs">using MarkdownTables
table = [(a = 1, b = 2), (a = 3, b = 4)]
table = [(a = 1, b = 2), (a = 3, b = 4)]
table |> markdown_table()</code></pre><h3id="admonitions-md"><aclass="docs-heading-anchor"href="#admonitions-md">Adding admonitions using compound line filtering</a><aid="admonitions-md-1"></a><aclass="docs-heading-anchor-permalink"href="#admonitions-md"title="Permalink"></a></h3><p>Admonitions are a useful feature for drawing attention to particular elements of documentation. They are <ahref="https://juliadocs.github.io/Documenter.jl/stable/showcase/#Basic-Markdown">documented in Documenter.jl</a> and an example of their use can be seen above in the blue 'note' box. Admonitions is a specific Julia markdown feature, and they are not recognized by either common mark or Jupyter notebooks. The <code>md</code> line filter can be used to make sure admonitions only show up in markdown output, for example:</p><pre><codeclass="nohighlight hljs">#md # !!! note "Be aware!"
table |> markdown_table()</code></pre><h3id="admonitions-md"><aclass="docs-heading-anchor"href="#admonitions-md">Adding admonitions using compound line filtering</a><aid="admonitions-md-1"></a><aclass="docs-heading-anchor-permalink"href="#admonitions-md"title="Permalink"></a></h3><p>Admonitions are a useful feature for drawing attention to particular elements of documentation. They are [documented in Documenter.jl] (https://juliadocs.github.io/Documenter.jl/stable/showcase/#Basic-Markdown) and an example of their use can be seen above in the blue 'note' box. Admonitions is a specific Julia markdown feature, and they are not recognized by either common mark or Jupyter notebooks. The <code>md</code> line filter can be used to make sure admonitions only show up in markdown output, for example:</p><pre><codeclass="nohighlight hljs">#md # !!! note "Be aware!"
#md # This a note style admonition!</code></pre><p>It is important to note that both <code>#md</code> and the second <code>#</code> are required. Literate.jl interprets the first <code>#md</code> as a markdown exclusive line, and then strips it out. The second <code>#</code> tells Literate.jl that the line should be parsed as markdown and not a Julia code block. If you only include <code>#md</code> and not the second <code>#</code> then it will be parsed into Julia example block in the final documentation and not an actual admonition.</p><h3id="admonitions-compatibility"><aclass="docs-heading-anchor"href="#admonitions-compatibility">Custom parsing for markdown and notebook compatible admonitions</a><aid="admonitions-compatibility-1"></a><aclass="docs-heading-anchor-permalink"href="#admonitions-compatibility"title="Permalink"></a></h3><p>As mentioned above, admonitions are not compatible with Jupyter notebooks. (Though at time of writing this documentation, <ahref="https://github.com/jupyter/notebook/issues/1292">this is an open issue in Jupyter</a> so may change in the future.) For now, we can write a custom preprocessor function so that admonitions are interpreted as quotes (with their own special formatting) in notebooks and proper admonitions in markdown. For the case of note admonitions, this can be written as follows:</p><pre><codeclass="language-julia hljs">function md_note(str)
#md # This a note style admonition!</code></pre><p>It is important to note that both <code>#md</code> and the second <code>#</code> are required. Literate.jl interprets the first <code>#md</code> as a markdown exclusive line, and then strips it out. The second <code>#</code> tells Literate.jl that the line should be parsed as markdown and not a Julia code block. If you only include <code>#md</code> and not the second <code>#</code> then it will be parsed into Julia example block in the final documentation and not an actual admonition.</p><h3id="admonitions-compatibility"><aclass="docs-heading-anchor"href="#admonitions-compatibility">Custom parsing for markdown and notebook compatible admonitions</a><aid="admonitions-compatibility-1"></a><aclass="docs-heading-anchor-permalink"href="#admonitions-compatibility"title="Permalink"></a></h3><p>As mentioned above, admonitions are not compatible with Jupyter notebooks. (Though at time of writing this documentation, <ahref="https://github.com/jupyter/notebook/issues/1292">this is an open issue in Jupyter</a> so may change in the future.) For now, we can write a custom preprocessor function so that admonitions are interpreted as quotes (with their own special formatting) in notebooks and proper admonitions in markdown. For the case of note admonitions, this can be written as follows:</p><pre><codeclass="language-julia hljs">function md_note(str)
This is a useful note.</code></pre><p>and a quotation style formatting in the generated notebook cell:</p><pre><codeclass="language-julia hljs">> *Note*
This is a useful note.</code></pre><p>and a quotation style formatting in the generated notebook cell:</p><pre><codeclass="language-julia hljs">> *Note*
> This is a useful note.</code></pre><p>which, in an actual notebook cell, will look similar to:</p><blockquote><p><em>Note</em><br/>This is a useful note.</p></blockquote><h3id="debug-execution"><aclass="docs-heading-anchor"href="#debug-execution">Debugging code execution</a><aid="debug-execution-1"></a><aclass="docs-heading-anchor-permalink"href="#debug-execution"title="Permalink"></a></h3><p>When Literate is executing code (i.e. when <code>execute = true</code> is set), it does so quietly. All the output gets captured and nothing gets printed into the terminal. This can make it tricky to know where things go wrong, e.g. when the execution stalls due to an infinite loop.</p><p>To help debug this, Literate has an <code>@debug</code> statement that prints out each code block that is being executed. In general, to enable the printing of Literate's <code>@debug</code> statements, you can set the <code>JULIA_DEBUG</code> environment variable to <code>"Literate"</code>.</p><p>The easiest way to do that is to set the variable in the Julia session before running Literate by doing</p><pre><codeclass="language-julia hljs">ENV["JULIA_DEBUG"]="Literate"</code></pre><p>Alternatively, you can also set the environment variable before starting the Julia session, e.g.</p><pre><codeclass="language-sh hljs">$ JULIA_DEBUG=Literate julia</code></pre><p>or by wrapping the Literate calls in an <code>withenv</code> block</p><pre><codeclass="language-julia hljs">withenv("JULIA_DEBUG" =>"Literate") do
> This is a useful note.</code></pre><p>which, in an actual notebook cell, will look similar to:</p><blockquote><p><em>Note</em><br/>This is a useful note.</p></blockquote><h3id="debug-execution"><aclass="docs-heading-anchor"href="#debug-execution">Debugging code execution</a><aid="debug-execution-1"></a><aclass="docs-heading-anchor-permalink"href="#debug-execution"title="Permalink"></a></h3><p>When Literate is executing code (i.e. when <code>execute = true</code> is set), it does so quietly. All the output gets captured and nothing gets printed into the terminal. This can make it tricky to know where things go wrong, e.g. when the execution stalls due to an infinite loop.</p><p>To help debug this, Literate has an <code>@debug</code> statement that prints out each code block that is being executed. In general, to enable the printing of Literate's <code>@debug</code> statements, you can set the <code>JULIA_DEBUG</code> environment variable to <code>"Literate"</code>.</p><p>The easiest way to do that is to set the variable in the Julia session before running Literate by doing</p><pre><codeclass="language-julia hljs">ENV["JULIA_DEBUG"]="Literate"</code></pre><p>Alternatively, you can also set the environment variable before starting the Julia session, e.g.</p><pre><codeclass="language-sh hljs">$ JULIA_DEBUG=Literate julia</code></pre><p>or by wrapping the Literate calls in an <code>withenv</code> block</p><pre><codeclass="language-julia hljs">withenv("JULIA_DEBUG" =>"Literate") do
end</code></pre></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../documenter/">« <strong>6.</strong> Interaction with Documenter.jl</a><aclass="docs-footer-nextpage"href="../generated/example/"><strong>8.</strong> Example »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Wednesday 19 November 2025 18:04">Wednesday 19 November 2025</span>. Using Julia version 1.12.1.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>
end</code></pre></article><navclass="docs-footer"><aclass="docs-footer-prevpage"href="../documenter/">« <strong>6.</strong> Interaction with Documenter.jl</a><aclass="docs-footer-nextpage"href="../generated/example/"><strong>8.</strong> Example »</a><divclass="flexbox-break"></div><pclass="footer-message">Powered by <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <ahref="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><divclass="modal"id="documenter-settings"><divclass="modal-background"></div><divclass="modal-card"><headerclass="modal-card-head"><pclass="modal-card-title">Settings</p><buttonclass="delete"></button></header><sectionclass="modal-card-body"><p><labelclass="label">Theme</label><divclass="select"><selectid="documenter-themepicker"><optionvalue="auto">Automatic (OS)</option><optionvalue="documenter-light">documenter-light</option><optionvalue="documenter-dark">documenter-dark</option><optionvalue="catppuccin-latte">catppuccin-latte</option><optionvalue="catppuccin-frappe">catppuccin-frappe</option><optionvalue="catppuccin-macchiato">catppuccin-macchiato</option><optionvalue="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <ahref="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.16.0 on <spanclass="colophon-date"title="Tuesday 2 December 2025 15:39">Tuesday 2 December 2025</span>. Using Julia version 1.12.2.</p></section><footerclass="modal-card-foot"></footer></div></div></div></body></html>