196 lines
7.2 KiB
Markdown
196 lines
7.2 KiB
Markdown
# Very early IN dev code
|
|
This program can be tested and should mainly work. Please report any problems
|
|
|
|
Tyto - Littérateur is translated in french and english.
|
|
|
|
# Commands
|
|
```
|
|
# Get commands help
|
|
tyto
|
|
|
|
# Get all documentation
|
|
tyto help all
|
|
|
|
# How to write words tags (strong...) and anchors
|
|
tyto help words anchor
|
|
```
|
|
|
|
# Create new domain
|
|
- create a domain directory, like www.domain.tld
|
|
- Go to this directory
|
|
- type `tyto new domain`
|
|
- type `tyto check domain` and PLEASE, CHECK configuration file
|
|
- create in new directory domain ".../articles/", an article (see help)
|
|
- type `wip myfile.tyto`
|
|
|
|
|
|
## Exemple d'article .tyto commenté
|
|
```
|
|
title: Tests
|
|
about: Tests divers
|
|
date: 2023-02-28
|
|
tags: tests
|
|
authors: echolib
|
|
|
|
abbr: CSS
|
|
Cascading SteelSheet
|
|
en
|
|
|
|
link: le site est prêt
|
|
https://forge.a-lec.org
|
|
La forge libre
|
|
|
|
-----
|
|
|
|
#1 Titre 1
|
|
((
|
|
Un peu de ::CSS et ::le site est prêt
|
|
(( note
|
|
Cet article est un test
|
|
))
|
|
))
|
|
|
|
#2 Citation
|
|
("
|
|
cite: Auteur
|
|
date: AAAA-MM-JJ
|
|
book: Nom du livre
|
|
lang: fr
|
|
link: https://...
|
|
|
|
((
|
|
Citation complète dans un paragraphe
|
|
))
|
|
)"
|
|
|
|
#2 Code (bloc)
|
|
{{
|
|
# Écrire les marqueurs de mots
|
|
# Chaque marqueur à la classe CSS de la configuration
|
|
# Astuce : ** + ← + `` + ← + très gras
|
|
|
|
*`très gras`* => <strong>
|
|
+`gras`+ => <b>
|
|
/`italique`/ => <em>
|
|
;`italique`; => <i>
|
|
_`souligné`_ => <u>
|
|
~`effacé`~ => <del>
|
|
[`cité`] => <q> # Contenu
|
|
:`cité`: => <cite> # auteur, nom
|
|
|`perso`| => <span>
|
|
|
|
# Code dans un texte
|
|
# ! Les marqueurs d'ouverture et de fermeture de code sont sur la MEME LIGNE
|
|
|
|
{` <li>Une entée de liste</li> `} => <code>
|
|
|
|
# ! Dans certains cas, il faut ajouter un espace après le 1er marqueur
|
|
# et/ou avant le second. Ils seront automatiquement supprimés
|
|
|
|
*`DOMAIN/articles/ `* # évite /` : marqueur italique ouvert
|
|
}}
|
|
|
|
#2 Une liste
|
|
# Liste. Classe CSS possible (défaut : celle dans la configuration)
|
|
# Une entrée de liste peut être ordonnée avec le signe "+" ou non avec "="
|
|
# Une liste peut contenir des entrées mixées ("+" et "=")
|
|
# mais au changement de signe, ajouter un signe !
|
|
# Possible d'écrire une entrée sur plusieurs lignes
|
|
|
|
(=
|
|
= Première entrée non ordonnée (ul)
|
|
== Sous entrée non ordonnée
|
|
+++ Première sous-sous entrée ordonnée (ol)
|
|
+++ Seconde sous-sous entrée ordonnée
|
|
= Seconde entrée non ordonnée
|
|
= Troisième entrée ...
|
|
... non ordonnée
|
|
)=
|
|
```
|
|
|
|
## Output HTML
|
|
```
|
|
<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="2023-12-27 17:45:57">
|
|
<header id="article_header">
|
|
<h1 id="article_title">
|
|
<a id="article_title_link" href="https://tyto.echolib.re/test.html" title="Tests -- echolib, 28/02/2023">Tests</a>
|
|
</h1>
|
|
<div id="article_refs">
|
|
echolib, 28/02/2023 [<a id="post_code" class="tyto" href="./test.tyto" title="Code source : Tests">Code source</a>]
|
|
</div>
|
|
</header>
|
|
<h2 id="toc_4" class="tyto">Titre 1</h2>
|
|
<p class="tyto">
|
|
Un peu de <abbr class="tyto" title="Cascading SteelSheet" lang="en">CSS</abbr> et <a class="tyto" href="https://forge.a-lec.org" title="La forge libre">le site est prêt</a>
|
|
<p class="note">
|
|
Cet article est un test
|
|
</p>
|
|
</p>
|
|
<h3 id="toc_4" class="tyto">Citation</h3>
|
|
<blockquote class="tyto" cite="https://..." lang="fr" title="-- Auteur, Nom du livre, AAAA-MM-JJ"><time datetime="AAAA-MM-JJ">
|
|
<p class="tyto">
|
|
Citation complète dans un paragraphe
|
|
</p>
|
|
</time><footer class="tyto"><a class="tyto" href="https://...">-- Auteur, Nom du livre, AAAA-MM-JJ</a></footer></blockquote>
|
|
<h3 id="toc_4" class="tyto">Code (bloc)</h3>
|
|
<pre class="bcode">
|
|
<code class="bcode"><span class="bcode ln">1</span><span class="bcode line"># Écrire les marqueurs de mots</span></code>
|
|
<code class="bcode"><span class="bcode ln">2</span><span class="bcode line"># Chaque marqueur à la classe CSS de la configuration</span></code>
|
|
<code class="bcode"><span class="bcode ln">3</span><span class="bcode line"># Astuce : ** + ← + `` + ← + très gras</span></code>
|
|
<code class="bcode"><span class="bcode ln">4</span><span class="bcode line"></span></code>
|
|
<code class="bcode"><span class="bcode ln">5</span><span class="bcode line">*`très gras`* => <strong></span></code>
|
|
<code class="bcode"><span class="bcode ln">6</span><span class="bcode line">+`gras`+ => <b></span></code>
|
|
<code class="bcode"><span class="bcode ln">7</span><span class="bcode line">/`italique`/ => <em></span></code>
|
|
<code class="bcode"><span class="bcode ln">8</span><span class="bcode line">;`italique`; => <i></span></code>
|
|
<code class="bcode"><span class="bcode ln">9</span><span class="bcode line">_`souligné`_ => <u></span></code>
|
|
<code class="bcode"><span class="bcode ln">10</span><span class="bcode line">~`effacé`~ => <del></span></code>
|
|
<code class="bcode"><span class="bcode ln">11</span><span class="bcode line">[`cité`] => <q> # Contenu</span></code>
|
|
<code class="bcode"><span class="bcode ln">12</span><span class="bcode line">:`cité`: => <cite> # auteur, nom</span></code>
|
|
<code class="bcode"><span class="bcode ln">13</span><span class="bcode line">|`perso`| => <span></span></code>
|
|
<code class="bcode"><span class="bcode ln">14</span><span class="bcode line"></span></code>
|
|
<code class="bcode"><span class="bcode ln">15</span><span class="bcode line"># Code dans un texte</span></code>
|
|
<code class="bcode"><span class="bcode ln">16</span><span class="bcode line"># ! Les marqueurs d'ouverture et de fermeture de code sont sur la MEME LIGNE</span></code>
|
|
<code class="bcode"><span class="bcode ln">17</span><span class="bcode line"></span></code>
|
|
<code class="bcode"><span class="bcode ln">18</span><span class="bcode line">{` <li>Une entée de liste</li> `} => <code></span></code>
|
|
<code class="bcode"><span class="bcode ln">19</span><span class="bcode line"></span></code>
|
|
<code class="bcode"><span class="bcode ln">20</span><span class="bcode line"># ! Dans certains cas, il faut ajouter un espace après le 1er marqueur</span></code>
|
|
<code class="bcode"><span class="bcode ln">21</span><span class="bcode line"># et/ou avant le second. Ils seront automatiquement supprimés</span></code>
|
|
<code class="bcode"><span class="bcode ln">22</span><span class="bcode line"></span></code>
|
|
<code class="bcode"><span class="bcode ln">23</span><span class="bcode line">*`DOMAIN/articles/ `* # évite /` : marqueur italique ouvert</span></code>
|
|
</pre>
|
|
<h3 id="toc_4" class="tyto">Une liste</h3>
|
|
<ul class="tyto">
|
|
<li class="tyto">Première entrée non ordonnée (ul)</li>
|
|
<ul>
|
|
<li class="tyto">Sous entrée non ordonnée</li>
|
|
<ol>
|
|
<li class="tyto">Première sous-sous entrée ordonnée (ol)</li>
|
|
<li class="tyto">Seconde sous-sous entrée ordonnée</li>
|
|
</ol>
|
|
</ul>
|
|
<li class="tyto">Seconde entrée non ordonnée</li>
|
|
<li class="tyto">Troisième entrée ... ... non ordonnée</li>
|
|
</ul>
|
|
</time>
|
|
</article>
|
|
|
|
<!--# include virtual="/template/sidebar.html"-->
|
|
|
|
</main>
|
|
|
|
<!--# include virtual="/template/footer.html"-->
|
|
|
|
</div> <!-- #site_container -->
|
|
|
|
</body>
|
|
```
|