<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="https://cecilapp.github.io/theme-docs/xsl/atom.xsl" media="all"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
  <id>https://cecilapp.github.io/theme-docs/docs/guides/</id>
  <title>Docs theme - Guides</title>
  <subtitle><![CDATA[Demo site of the Docs theme for Cecil.]]></subtitle>
  <link href="https://cecilapp.github.io/theme-docs/docs/guides/atom.xml" rel="self" type="application/atom+xml" />
  <link href="https://cecilapp.github.io/theme-docs/docs/guides/" rel="alternate" type="text/html" />
  <updated>2026-10-20T22:26:11+00:00</updated>
  <author>
    <name>Cecil</name>
    <uri>https://cecil.app</uri>
  </author>
  <entry xml:lang="en">
    <id>https://cecilapp.github.io/theme-docs/docs/guides/notes/</id>
    <title>Notes</title>
    <published>2026-10-20T22:26:03+00:00</published>
    <link href="https://cecilapp.github.io/theme-docs/docs/guides/notes/" rel="alternate" type="text/html" />
    <content type="html">
      <![CDATA[<h1>Notes</h1>
<aside class="note note-info"><p><strong>Info:</strong> useful information that users should know.</p></aside>
<aside class="note note-tip"><p><strong>Tip:</strong> helpful advice for doing things better, with <a href="https://cecil.app" rel="noopener noreferrer">a link</a>.</p></aside>
<aside class="note note-important"><p><strong>Important:</strong> key information users need to know.</p></aside>
<aside class="note note-warning"><p><strong>Warning:</strong> urgent info that needs immediate user attention.</p></aside>
<aside class="note note-caution"><p><strong>Caution:</strong> advises about risks or negative outcomes.</p></aside>]]>
    </content>
  </entry>
  <entry xml:lang="en">
    <id>https://cecilapp.github.io/theme-docs/docs/guides/advanced/customization/</id>
    <title>Customization</title>
    <published>2026-10-20T22:26:03+00:00</published>
    <link href="https://cecilapp.github.io/theme-docs/docs/guides/advanced/customization/" rel="alternate" type="text/html" />
    <content type="html">
      <![CDATA[<h1>Customization</h1>
<h2 id="override-a-template">Override a template</h2>
<p>Create a template with the same path in your site's <code translate="no">layouts/</code> folder, e.g. <code translate="no">layouts/partials/logo.html.twig</code>.</p>
<h2 id="colors">Colors</h2>
<p>Primary and secondary colors are defined in <code translate="no">assets/css/tailwind.css</code>.</p>]]>
    </content>
  </entry>
  <entry xml:lang="en">
    <id>https://cecilapp.github.io/theme-docs/docs/guides/code/</id>
    <title>Code and diagrams</title>
    <published>2026-10-20T22:26:03+00:00</published>
    <link href="https://cecilapp.github.io/theme-docs/docs/guides/code/" rel="alternate" type="text/html" />
    <content type="html">
      <![CDATA[<h1>Code and diagrams</h1>
<h2 id="syntax-highlighting">Syntax highlighting</h2>
<pre><code class="language-php hljs php" translate="no"><span class="hljs-meta">&lt;?php</span>
$builder = <span class="hljs-keyword">new</span> Cecil\Builder($config);
$builder-&gt;build([<span class="hljs-string">'drafts'</span> =&gt; <span class="hljs-keyword">false</span>]);</code></pre>
<pre><code class="language-twig hljs twig" translate="no"><span class="hljs-template-tag">{% <span class="hljs-name"><span class="hljs-keyword">for</span></span> p in site.pages.showable %}</span><span class="xml">
  <span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">"</span></span></span><span class="hljs-template-variable">{{ url(p) }}</span><span class="xml"><span class="hljs-tag"><span class="hljs-string">"</span>&gt;</span></span><span class="hljs-template-variable">{{ p.title }}</span><span class="xml"><span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span>
</span><span class="hljs-template-tag">{% <span class="hljs-name"><span class="hljs-keyword">endfor</span></span> %}</span></code></pre>
<pre><code class="language-javascript hljs javascript" translate="no"><span class="hljs-built_in">document</span>.querySelectorAll(<span class="hljs-string">'article h2'</span>).forEach(<span class="hljs-function">(<span class="hljs-params">el</span>) =&gt;</span> <span class="hljs-built_in">console</span>.log(el.id));</code></pre>
<h2 id="mermaid">Mermaid</h2>
<p>Switch the color theme to check that the diagram is re-rendered.</p>
<pre><code class="language-mermaid" translate="no">flowchart LR
  A[Markdown] --&gt; B(Cecil)
  B --&gt; C{Theme}
  C --&gt;|light| D[HTML]
  C --&gt;|dark| D</code></pre>
<pre><code class="language-mermaid" translate="no">sequenceDiagram
  User-&gt;&gt;Browser: Toggle theme
  Browser-&gt;&gt;Mermaid: Re-render
  Mermaid--&gt;&gt;User: Diagram updated</code></pre>
<h2 id="long-page">Long page</h2>
<p>The sections below make the page long enough to test the "On this page" table of contents and the "Back to top" button.</p>
<h3 id="section-a">Section A</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<h3 id="section-b">Section B</h3>
<p>Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
<h3 id="section-c">Section C</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
<h3 id="section-d">Section D</h3>
<p>Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>]]>
    </content>
  </entry>
</feed>
