tyto-litterateur/website_doc/article/redac_titres.html

115 lines
5.5 KiB
HTML

<!-- Écrire les titres et sous-titres - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Écrire les titres et sous-titres">
<meta name="author" content="echolib">
<meta name="description" content="Comment écrire les titres et les sous-titres pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,rédaction,titres,table des matières">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/redac_titres.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Écrire les titres et sous-titres">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/redac_titres.html">
<meta property="og:description" content="Comment écrire les titres et les sous-titres pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_titles_toc.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Écrire les titres et sous-titres (echolib) | Tyto - Littérateur</title>
</head>
<body>
<div id="site_container">
<!--# include virtual="/template/header.html"-->
<!--# include virtual="/template/navbar.html"-->
<main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article">
<time datetime="2024-01-15 18:28:34">
<header id="article_header">
<img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_titles_toc.png" alt="Écrire les titres et sous-titres">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/redac_titres.html" title="Écrire les titres et sous-titres -- echolib, 07/01/2024">Écrire les titres et sous-titres</a>
</h1>
<div id="article_refs">
echolib, 07/01/2024 [<a id="post_code" class="tyto" href="./redac_titres.tyto" title="Code source : Écrire les titres et sous-titres">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Les titres</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Les marqueurs</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">La table des matières</a></li>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Les titres</h2>
<p class="tyto">
En HTML, les 6 titres et sous-titres sont écrits avec les balises <code class="tyto">&lt;h1&gt;</code>
à <code class="tyto">&lt;h6&gt;</code>. Toutefois, <cite class="tyto">Tyto</cite> crée le squelette du site HTML, en
mettant le titre principal de l'article dans la balise <code class="tyto">&lt;h1&gt;</code> - elle-même
dans la balise <code class="tyto">&lt;article&gt;</code>. De ce fait, le contenu rédactionnel dipose
de 5 titres et sous-titres.
</p>
<p class="tyto">
Tous les titres ont la même classe CSS : celle dans la configuration du
domaine ("tyto" par défaut). Chacun des titres a également l'identifiant CSS
incrémentée par ordre d'apparition. Le 1er titre aura donc <code class="tyto">id=&quot;toc_1&quot;</code>,
le 4ème titre, <code class="tyto">id=&quot;toc_4&quot;</code>...
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Les marqueurs</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">#1 Titre &lt;h2&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#2 Titre &lt;h3&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#3 Titre &lt;h4&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#4 Titre &lt;h5&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#5 Titre &lt;h6&gt;</code></li>
</ol></pre>
<h2 role="heading" aria-level="2" id="toc_3" class="tyto">La table des matières</h2>
<p class="tyto">
Il est possible, très facilement, de créer une table des matière
automatiquement grâce au marqueur <code class="tyto">! TOC</code>, à mettre, de préférence au
début du contenu rédactionnel. Cette <strong class="tyto">table des matières</strong>, (comme celles
que vous pouvez observer dans la majorité des pages de cette documentation),
est composée avec tous les titres et sous-titres, et permet de créer des
liens vers leurs ancres.
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>