<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="https://cecilapp.github.io/theme-leon/xsl/atom.xsl" media="all"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
  <id>https://cecilapp.github.io/theme-leon/docs/getting-started/</id>
  <title>Léon - Getting started</title>
  <subtitle><![CDATA[Léon is a documentation theme for Cecil, with a warm and editorial look.]]></subtitle>
  <link href="https://cecilapp.github.io/theme-leon/docs/getting-started/atom.xml" rel="self" type="application/atom+xml" />
  <link href="https://cecilapp.github.io/theme-leon/docs/getting-started/" rel="alternate" type="text/html" />
  <updated>2026-10-22T22:11:10+00:00</updated>
  <author>
    <name>Cecil</name>
    <uri>https://cecil.app</uri>
  </author>
  <entry xml:lang="en">
    <id>https://cecilapp.github.io/theme-leon/docs/getting-started/overview/</id>
    <title>Overview</title>
    <published>2026-10-22T22:11:04+00:00</published>
    <link href="https://cecilapp.github.io/theme-leon/docs/getting-started/overview/" rel="alternate" type="text/html" />
    <content type="html">
      <![CDATA[<p>Léon gives your documentation a calm, readable layout: a tabbed header, a sidebar per tab, a table of contents that follows your reading, and content components written in plain Markdown.</p>
<h2 id="get-started">Get started</h2>
<p>Install the theme with Composer, then enable it in the configuration of your site.</p>
<div class="note note-code-group" id="note-code-group-1" data-leon-tabs>
  <div class="leon-tablist" role="tablist">
    <button type="button" class="leon-tab-button" id="note-code-group-1-tab-1" role="tab" aria-controls="note-code-group-1-panel-1" aria-selected="true">Composer</button>
    <button type="button" class="leon-tab-button" id="note-code-group-1-tab-2" role="tab" aria-controls="note-code-group-1-panel-2" aria-selected="false" tabindex="-1">Archive</button>
  </div>
  <div class="leon-tabpanel" id="note-code-group-1-panel-1" role="tabpanel" aria-labelledby="note-code-group-1-tab-1" tabindex="0">
    <p class="leon-tabpanel-title">Composer</p>
    <pre><code class="language-bash hljs bash" translate="no">composer require cecil/theme-leon</code></pre>
  </div>
  <div class="leon-tabpanel" id="note-code-group-1-panel-2" role="tabpanel" aria-labelledby="note-code-group-1-tab-2" tabindex="0">
    <p class="leon-tabpanel-title">Archive</p>
    <pre><code class="language-bash hljs bash" translate="no">curl -LO https://github.com/Cecilapp/theme-leon/releases/latest/download/leon.zip
unzip leon.zip -d themes/leon</code></pre>
  </div>
</div>
<p>Then <a href="../quickstart/">continue with the Quickstart →</a></p>
<aside class="note note-info"><p>Léon requires the <a href="https://github.com/Cecilapp/theme-flexsearch" rel="noopener noreferrer">FlexSearch</a> and <a href="https://github.com/Cecilapp/theme-darkmodetoggle" rel="noopener noreferrer">Dark mode toggle</a> component themes.</p></aside>
<h2 id="what-you-can-do">What you can do</h2>
<div class="note note-accordion" id="note-accordion-2">
  <details class="leon-accordion">
    <summary>Write rich content in Markdown</summary>
    <div class="leon-accordion-content">
      <p>Callouts, tabs, code groups, steps, accordions and cards use the <code translate="no">:::</code> syntax of Cecil: no HTML, no shortcodes.</p>
    </div>
  </details>
  <details class="leon-accordion">
    <summary>Let readers search everything</summary>
    <div class="leon-accordion-content">
      <p>The search box is powered by FlexSearch: the index is generated at build time, and the search runs in the browser.</p>
    </div>
  </details>
  <details class="leon-accordion">
    <summary>Feed your favorite AI assistant</summary>
    <div class="leon-accordion-content">
      <p>The <strong>Copy page</strong> button copies the page as Markdown, and the <code translate="no">llms.txt</code> file lists all the pages of the site.</p>
    </div>
  </details>
</div>
<h2 id="next-steps">Next steps</h2>
<div class="note note-cards" id="note-cards-3">
  <ul>
    <li><a href="../quickstart/">Quickstart</a><div class="leon-card-description">create a documentation site from scratch</div></li>
    <li><a href="../../guides/writing-content/">Writing content</a><div class="leon-card-description">all the components, by example</div></li>
    <li><a href="../../../reference/configuration/">Configuration</a><div class="leon-card-description">every option of the theme</div></li>
    <li><a href="../../../reference/front-matter/">Front matter</a><div class="leon-card-description">per page variables</div></li>
  </ul>
</div>]]>
    </content>
  </entry>
  <entry xml:lang="en">
    <id>https://cecilapp.github.io/theme-leon/docs/getting-started/quickstart/</id>
    <title>Quickstart</title>
    <published>2026-10-22T22:11:04+00:00</published>
    <link href="https://cecilapp.github.io/theme-leon/docs/getting-started/quickstart/" rel="alternate" type="text/html" />
    <content type="html">
      <![CDATA[<p>This guide walks you through the creation of a documentation site.</p>
<div class="note note-steps" id="note-steps-1">
  <ol class="leon-steps">
    <li class="leon-step">
      <h4>Create a site</h4>
      <p>Download Cecil and create a new site:</p>
<pre><code class="language-bash hljs bash" translate="no">curl -LO https://cecil.app/cecil.phar
php cecil.phar new:site</code></pre>
    </li>
    <li class="leon-step">
      <h4>Install the theme</h4>
      <pre><code class="language-bash hljs bash" translate="no">composer require cecil/theme-leon</code></pre>
    </li>
    <li class="leon-step">
      <h4>Enable the themes</h4>
      <p>Add Léon and its components to <code translate="no">cecil.yml</code>:</p>
<pre><code class="language-yaml hljs yaml" translate="no"><span class="hljs-attr">theme:</span>
  <span class="hljs-bullet">-</span> <span class="hljs-string">leon</span>
  <span class="hljs-bullet">-</span> <span class="hljs-string">flexsearch</span>
  <span class="hljs-bullet">-</span> <span class="hljs-string">darkmodetoggle</span></code></pre>
<p>Nothing else to configure: Léon sorts the pages by weight and adds their Markdown version and the <code translate="no">llms.txt</code> file (see <a href="/theme-leon/reference/configuration/#cecil-options">Configuration</a>).</p>
    </li>
    <li class="leon-step">
      <h4>Preview</h4>
      <pre><code class="language-bash hljs bash" translate="no">php cecil.phar serve</code></pre>
<p>Open <a href="http://localhost:8000" rel="noopener noreferrer">http://localhost:8000</a> and start writing.</p>
    </li>
  </ol>
</div>
<aside class="note note-tip"><p>Organize your pages in folders: each top level folder becomes a tab, and each sub-folder a group of the sidebar.</p></aside>]]>
    </content>
  </entry>
  <entry xml:lang="en">
    <id>https://cecilapp.github.io/theme-leon/docs/getting-started/installation/</id>
    <title>Installation</title>
    <published>2026-10-22T22:11:04+00:00</published>
    <updated>2026-10-21T00:00:00+00:00</updated>
    <link href="https://cecilapp.github.io/theme-leon/docs/getting-started/installation/" rel="alternate" type="text/html" />
    <content type="html">
      <![CDATA[<h2 id="with-composer">With Composer</h2>
<pre><code class="language-bash hljs bash" translate="no">composer require cecil/theme-leon</code></pre>
<p>Composer installs Léon in <code translate="no">themes/leon</code>, and its dependencies in <code translate="no">themes/flexsearch</code> and <code translate="no">themes/darkmodetoggle</code>.</p>
<h2 id="manually">Manually</h2>
<p>Download the <a href="https://github.com/Cecilapp/theme-leon/releases/latest/" rel="noopener noreferrer">latest release</a> and uncompress it in <code translate="no">themes/leon</code>.</p>
<aside class="note note-warning"><p>Theme dependencies are not resolved automatically: download the <a href="https://github.com/Cecilapp/theme-flexsearch" rel="noopener noreferrer">FlexSearch</a> and <a href="https://github.com/Cecilapp/theme-darkmodetoggle" rel="noopener noreferrer">Dark mode toggle</a> themes too.</p></aside>
<h2 id="requirements">Requirements</h2>
<table>
<thead>
<tr>
<th>Software</th>
<th>Version</th>
</tr>
</thead>
<tbody>
<tr>
<td>Cecil</td>
<td>9.18.0+</td>
</tr>
</tbody>
</table>]]>
    </content>
  </entry>
</feed>
