# Tyto Pour obtenir de l'aide, taper juste la commande tyto ## Répertoire de code du projet Tyto https://git.a-lec.org/echolib/tyto-litterateur ## Documentation officielle https://tyto.echolib.re (en cours de construction) ## Démarrage "rapide" ```` mkdir -p MONDOMAIN cd MONDOMAIN tyto new domain URL tyto new index # À ce stade, voir la doc "écrire" tyto edit index.tyto tyto check index.tyto tyto wip index.tyto # Publier ! tyto publish template tyto publish index.tyto ``` ## 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) # Pour snpic, l'image doit être configurée avec le même Nom # qu'un marqueur d'entête "image:" # Utilise l'image précisée comme "avatar" dans les réseaux sociaux # Et dans le flux RSS 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 mais h1 est utilisé pour afficher # le titre de l'article. # Utiliser #N, où N est entre 1 et 5. (h+1 en HTML) # Si du contenu existe entre les titres, une
est ajoutée # Source #1 Titre 1 Contenu 1 #2 Titre 2 #3 Titre 3 contenu 2 #4 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
``` ### 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_* # +_gras léger_+ # ;_en italique_; # :_en italique_: # ~_texte barré_~ # [_Citation rapide_] # %_Classe personnalisée_% >>> ._Souligné_. # {_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 ``` ### 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 ]] ```