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 49fe9bcc91 check: fix for searching image:, brut: in header 2022-12-26 15:55:00 +01:00
src check: fix for searching image:, brut: in header 2022-12-26 15:55:00 +01:00
CHANGELOG.md Présentation 2022-11-16 11:45:39 +01:00
LICENSE Présentation 2022-11-16 11:45:39 +01:00
README.md wip: HTML time tag added to quotes (when registred) + base64 in utf8 2022-12-26 14:20:52 +01:00

README.md

Tyto

Répertoire de code du projet Tyto

Comment définir les métas

# Obligatoires uniques
title:  Titre
about:  Infos de l'article
author: Autheur
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

brut:   Nom
        URI
        Texte Alternatif

abbr:   NOM (en majuscule)
        Définition du NOM
        nom (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

Titre h1 à h6

#1 Titre 1
((
Un paragraphe
))

#2 Titre 2

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
-)

Citations

[[ CSS
_cite: autheur
_lang: langue
_link: lien
_year: année ou date YYYY-MM-DD
_book: référence
((
Citation placée dans un paragraphe
))
]]

[[ CSS
Citation simple sans référence
]]

Ancres

-> id
((
un long paragraphe
))
((
>_id:Retourner au point d'ancre_<
))

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 NAME 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>
{_Code_} # <code>
:_Citation rapide_: # <cite>
%_Classe personnalisée_% >>> <span class="custom">
._Souligné_. # <u> 

Abréviations

# ! NOM sera remplacé par "nom" dans la page si défini en entête
#   sinon, NOM sera conservé
# Toujours écrire en majuscule les ABBR dans l'article brut
# <abbr title="Définition du NOM">nom</abbr>
Avec ce NOM.

Images

# Chaque image doit être placée en début de ligne
# Placer dans un paragraphe pour chaque 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 à l'image
_image:Nom c=CSS t=https://... w=320px h=240

Code Brut depuis un fichier

_brut:NOM

Citations

Possibilité dans toute citation d'utiliser les marqueurs optionnels _xxx. Pour la date, utilisez le FORMAT INTERNATIONAL

# Source
[[ 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
[[
Une citation simple, et sans paragraphe
]]

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