echolib/tyto-litterateur
echolib
/
tyto-litterateur
1
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity
tyto-litterateur/README.md

7.3 KiB
Raw Blame History

This software needs tests !

This program can be tested and should mainly work. Please report any problems

Tyto - Littérateur is translated in french and english. Official website not yet udpated for this new version.

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 articl file [myfile].tyto (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`* =&gt; &lt;strong&gt;</span></code>
<code class="bcode"><span class="bcode ln">6</span><span class="bcode line">+`gras`+      =&gt; &lt;b&gt;</span></code>
<code class="bcode"><span class="bcode ln">7</span><span class="bcode line">/`italique`/  =&gt; &lt;em&gt;</span></code>
<code class="bcode"><span class="bcode ln">8</span><span class="bcode line">;`italique`;  =&gt; &lt;i&gt;</span></code>
<code class="bcode"><span class="bcode ln">9</span><span class="bcode line">_`souligné`_  =&gt; &lt;u&gt;</span></code>
<code class="bcode"><span class="bcode ln">10</span><span class="bcode line">~`effacé`~    =&gt; &lt;del&gt;</span></code>
<code class="bcode"><span class="bcode ln">11</span><span class="bcode line">[`cité`]      =&gt; &lt;q&gt;    # Contenu</span></code>
<code class="bcode"><span class="bcode ln">12</span><span class="bcode line">:`cité`:      =&gt; &lt;cite&gt; # auteur, nom</span></code>
<code class="bcode"><span class="bcode ln">13</span><span class="bcode line">|`perso`|     =&gt; &lt;span&gt;</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&apos;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">{` &lt;li&gt;Une entée de liste&lt;/li&gt; `} =&gt; &lt;code&gt;</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>