tyto-litterateur/README.md

# 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. Current website
documentation is in directory source (/usr/share/tyto/docs/www/)

# 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 an article
- go to domain directory ".../articles/"
- create an article file [myfile].tyto (see `tyto help article`)
- type `tyto wip myfile.tyto`
- [myfile].html is created in wip/ domain server directory


## Exemple d'article .tyto commenté
```
title:   Tests
about:   Tests divers
date:    2023-02-28
tags:    tests
authors: echolib

# Ajouter l'URI d'une image "logo" de l'article
#logo:   @logos/post_logo_test.png

abbr:    CSS
         Cascading SteelSheet
         en

link:    le site est prêt
         https://forge.a-lec.org
         La forge libre

code:    MyPY
         @code1.py
         Test d'ajout de code depuis un fichier

file:    PyF
         @code1.py
         Lien vers un fichier

-----
! TOC

#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 du domaine
   # 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 entré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
)=

::MyPY
((
   Télécharger le fichier ::PyF.
   Ceci est un icode : {` <h1>Titre principal de l'article</h1> `}
))
```