Tyto - Litterateur is a libre project to create and manage multiple websites from articles files. Tyto uses its own syntax to convert your articles in HTML5 pages. Tyto works on a GNU/Linux system and needs minimal dependencies.
Go to file
Cyrille L 6cb19e6879 removed unused and useless 'comments' in sort_dict() 2024-02-09 16:44:32 +01:00
debian [1.11.5] - fix helps and updated doc websites 2024-01-20 17:15:34 +01:00
src removed unused and useless 'comments' in sort_dict() 2024-02-09 16:44:32 +01:00
CHANGELOG.md [1.11.6] - Fix sorted markers names 2024-02-09 16:34:38 +01:00
LICENSE [1.9.50] 2023-12-28 00:31:19 +01:00
Makefile added Makefile and debian control file 2023-04-10 19:45:54 +02:00
README.md fix '/template/' copies + updated docs 2024-01-18 11:17:30 +01:00

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.

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

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
   # 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 principale de l'article</h1> `}
))