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 4df098260a [0.10.0] 2023-04-16 16:42:31 +02:00
debian [0.10.0] 2023-04-16 16:42:31 +02:00
src [0.10.0] 2023-04-16 16:42:31 +02:00
CHANGELOG.md [0.10.0] 2023-04-16 16:42:31 +02:00
LICENSE Présentation 2022-11-16 11:45:39 +01:00
Makefile added Makefile and debian control file 2023-04-10 19:45:54 +02:00
README.md [0.10.0] 2023-04-16 16:42:31 +02:00

README.md

Tyto

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

Répertoire de code du projet Tyto

TODO

Comment définir les métas

# Obligatoires uniques
# Ces marqueurs se configurent sur UNE ligne
title:  Titre
about:  Infos de l'article
author: Auteur
tags:   mot-clé-1,mot 2,
date:   YYYY-MM-DD (AAAA-MM-JJ)

# L'image doit être configurée avec le même Nom
# dans les marqueurs multiples
# Utilise l'image précisée comme "avatar" dans les réseaux sociaux
snpic:  Nom


# Optionnels multiples
# Ces marqueurs se configurent sur 3 lignes
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))

# 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 le titre du site
# étant en #1

# Source
#2 Titre 1
Contenu 1

#3 Titre 2

#4 Titre 3
contenu 2

#5 Titre 4

Balise div

<< CSS
((
1er paragraphes dans une balise div class="CSS"
))
((
2e paragraphes dans une balise div class="CSS"
))
>>

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 de l'ancre cible. "id" est son identité
-> id

# Source de l'ancre d'appel
# Définir l'identité cible et le texte du lien
>_id:Retourner au point d'ancre id_<

Retour à la ligne HTML

# Source
|

# HTML
<br />

Lien vers URL

# Placer "_" devant le Nom du lien
Voir ce _Nom du lien # Ouverture même fenêtre
Voir ce _Nom du lien+ # ouverture nouvelle fenêtre

Lien vers fichier

# Placer "__" devant le Nom du lien
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 les marqueurs 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 (format AAAA ou AAAA-MM ou AAAA-MM-JJ)
_lang: fr
_link: https://tyto.echolib.re
_book: Référence
((
Pfff, vraiment !
))
]]
# Source: citation basique
[[
Une citation simple, et sans paragraphe
]]