tyto-litterateur/README.md

# Tyto
Pour obtenir de l'aide, taper juste la commande tyto

## Répertoire de code du projet Tyto

## Comment définir les métas
```
# Obligatoires uniques
title:  Titre
about:  Infos de l'article
author: Auteur
tags:   mots-clé-1,mots-clé-2
date:   YYYY-MM-DD (AAAA-MM-JJ)

# Optionnels multiples
link:   Nom du lien
        URL
        Texte Alternatif

image:  Nom
        URI
        Texte Alternatif

file:   Nom du lien
        URL
        Texte Alternatif

raw:    Nom
        URI
        Texte Alternatif

abbr:   abbrev
        Définition de abbrev
        ABBR (forme à afficher dans l'artile (optionnel))

# L'image doit d'abord être configurée
# Utiliser l'image précisée comme défaut dans les réseaux sociaux
snpic:  Nom

# Séparateur d'au moins 5 "-" pour définir la fin
# des métadonnées d'entête de l'article
----------
```

## Comment écrire un article

### Écrire des titres
```
# Les titres HTML vont de 1 à 6.
# Utiliser #N, où N est entre 1 et 6.
# Si du contenu existe entre les titres, une <div> est ajoutée
# Astuce: on commence en général par #2 dans l'article

# Source
#1 Titre 1
Contenu 1

#2 Titre 2

#3 Titre 3
contenu 2

#4 Titre 4

# HTML
<h1 class="title_1">Titre 1</h1>
<div class="content_title">
Contenu 1
</div>
<h2 class="title_2">Titre 2</h2>
<h3 class="title_3">Titre 3</h3>
<div class="content_title">
contenu 2
</div>
<h4 class="title_4">Titre 4</h4>
```

### Paragraphes
```
(( CSS
Un paragraphe
))
```

### Code Brut
```
{{ CSS
def hello_world():
  print("Hello")
}}
```

### Listes ul/ol
```
-( CSS
= Liste ul
== Sous-liste ul
=== Sous-sous-liste ul
++++ Sous-sous-sous-liste ol
+++ Sous-sous-liste ol
-)
```

### Ancres
```
# Source`
-> id

# HTML
<a href="id2"></a>

# Source
((
>_id:Retourner au point d'ancre id_<
))

# HTML
<a class="anchor" href="#id">Retourner au point d'ancre id</a>
```

### Retour à la ligne HTML
```
| # <br />
```

### Lien vers URL
```
Voir ce _Nom du lien # Ouverture même fenêtre
Voir ce _Nom du lien+ # ouverture nouvelle fenêtre
```

### Lien vers fichier
```
Voir ce __Nom du lien # Ouverture même fenêtre
Voir ce __Nom du lien+ # ouverture nouvelle fenêtre
```

Note:
Vous pouvez avoir un Nom identique pour file: et link:

### Gras, Strong, italique...
```
*_très gras_* # <strong>
+_gras léger_+ # <b>
/_en italique_/ # <em>
[_en italique_] # <i>
~_texte barré_~ # <del>
:_Citation rapide_: # <cite>
%_Classe personnalisée_% >>> <span class="custom">
._Souligné_. # <u>
{_Code_} # <code>

# Montrer comment écrire du code dans Tyto:
# Bypass avec \ devant {_ et _}
{_\{_Comme ça\_}_}

```

### Abréviations
```
# abbrev sera remplacé par "ABBR" dans la page si défini en entête
#   sinon, abbrev sera conservé
# - Toujours écrire dans l'article :
#   - entre parenthèses ET majuscules les "(ABBREV)"
 

Avec cette (ABBREV).
# HTML: <abbr title="Définition de abbrev">ABBR</abbr>
```

### Images
```
# Chaque image doit être placée en début de ligne
# Placer dans un paragraphe pour chacune ou après "|",
# sinon, affichage les une à côté des autres
# ! Si pas d'unité pour w= et h= : défaut "px"

_image:Nom
_image:Nom c=CSS
_image:Nom c=css w=1080
_image:Nom w=640em h=480em
_image:Nom t=+ # Rend l'image interne cliquable
_image:Nom t=https://...# Donne un lien web à l'image
_image:Nom c=CSS t=https://... w=320px h=240 # 240px
```

### Code brut depuis un fichier
```
_raw:NOM
```

### Citations
Possibilité dans toute citation d'utiliser les marqueurs 
optionnels _xxx. Pour la date, utilisez le FORMAT INTERNATIONAL
```
# Source: citation complète
[[ CSS_TEST
_cite: echolib
_date: 2022-12-28
_lang: fr
_link: https://tyto.echolib.re
_book: Référence
((
Pfff, vraiment !
))
]]

# HTML
<figure class="CSS_TEST">
  <blockquote class="CSS_TEST" lang="fr" cite="https://tyto.echolib.re" title="echolib - Reference (2022-12-28)">
  <time datetime="2022-12-28">
    <p class="tyto">
      Pfff, vraiment !
    </p>
  </time>
  </blockquote>
  <figcaption class="CSS_TEST">
    <a class="figc" href="https://tyto.echolib.re">echolib - Reference (2022-12-28)</a>
  </figcaption>
</figure>
````
```
# Source: citation basique
[[
Une citation simple, et sans paragraphe
]]

# HTML
<blockquote class="tyto">
  Une citation simple, et sans paragraphe
</blockquote>
```