tyto-litterateur/README.md

221 lines
3.9 KiB
Markdown
Raw Normal View History

2022-11-16 11:45:39 +01:00
# Tyto
2023-03-02 15:53:29 +01:00
Pour obtenir de l'aide, taper juste la commande tyto
2022-11-16 11:45:39 +01:00
## Répertoire de code du projet Tyto
TODO
2022-11-16 11:45:39 +01:00
2022-11-26 12:34:59 +01:00
## Comment définir les métas
```
# Obligatoires uniques
# Ces marqueurs se configurent sur UNE ligne
2022-11-26 12:34:59 +01:00
title: Titre
about: Infos de l'article
author: Auteur
tags: mot-clé-1,mot 2,
2022-11-26 12:34:59 +01:00
date: YYYY-MM-DD (AAAA-MM-JJ)
2022-11-16 11:45:39 +01:00
# 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
2022-11-26 12:34:59 +01:00
link: Nom du lien
URL
Texte Alternatif
image: Nom
URI
Texte Alternatif
file: Nom du lien
URL
Texte Alternatif
2023-03-07 17:51:19 +01:00
raw: Nom
2022-11-26 12:34:59 +01:00
URI
Texte Alternatif
2023-03-28 14:37:42 +02:00
abbr: abbrev
Définition de abbrev
ABBR (forme à afficher dans l'artile (optionnel))
2022-11-26 12:34:59 +01:00
# 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
2022-11-26 12:34:59 +01:00
```
# 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
2023-04-16 16:42:31 +02:00
# Astuce: on commence en général par #2 dans l'article le titre du site
# étant en #1
# Source
2023-04-16 16:42:31 +02:00
#2 Titre 1
Contenu 1
2022-11-26 12:34:59 +01:00
2023-04-16 16:42:31 +02:00
#3 Titre 2
2023-04-16 16:42:31 +02:00
#4 Titre 3
contenu 2
2023-04-16 16:42:31 +02:00
#5 Titre 4
```
2023-04-16 16:42:31 +02:00
### Balise div
```
<< CSS
((
1er paragraphes dans une balise div class="CSS"
))
((
2e paragraphes dans une balise div class="CSS"
))
>>
2022-11-26 12:34:59 +01:00
```
2022-12-15 12:44:24 +01:00
2022-11-26 12:34:59 +01:00
### Paragraphes
```
2022-12-15 12:44:24 +01:00
(( CSS
2022-11-26 12:34:59 +01:00
Un paragraphe
2022-12-15 12:44:24 +01:00
))
2022-11-26 12:34:59 +01:00
```
### Code Brut
```
2022-12-15 12:44:24 +01:00
{{ CSS
2022-11-26 12:34:59 +01:00
def hello_world():
print("Hello")
2022-12-15 12:44:24 +01:00
}}
2022-11-26 12:34:59 +01:00
```
### 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é
2022-12-15 12:44:24 +01:00
-> id
2023-03-08 11:48:17 +01:00
# Source de l'ancre d'appel
# Définir l'identité cible et le texte du lien
2023-03-07 17:44:44 +01:00
>_id:Retourner au point d'ancre id_<
2023-03-08 11:48:17 +01:00
2022-11-26 12:34:59 +01:00
```
2022-11-26 12:45:46 +01:00
### Retour à la ligne HTML
```
# Source
|
# HTML
<br />
2022-11-26 12:45:46 +01:00
```
2022-11-26 12:34:59 +01:00
### Lien vers URL
```
2023-04-16 16:42:31 +02:00
# 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
2022-11-26 12:34:59 +01:00
```
### Lien vers fichier
```
2023-04-16 16:42:31 +02:00
# 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
2022-11-26 12:34:59 +01:00
```
Note:
2023-04-16 16:42:31 +02:00
Vous pouvez avoir un Nom identique pour les marqueurs `file:` et `link:`
2022-11-26 12:34:59 +01:00
### Gras, Strong, italique...
```
2022-12-15 12:44:24 +01:00
*_très gras_* # <strong>
+_gras léger_+ # <b>
2023-04-18 12:32:14 +02:00
;_en italique_; # <em>
2023-04-16 16:42:31 +02:00
:_en italique_: # <i>
2022-12-15 12:44:24 +01:00
~_texte barré_~ # <del>
2023-04-18 12:32:14 +02:00
[_Citation rapide_] # <cite>
2022-12-15 12:44:24 +01:00
%_Classe personnalisée_% >>> <span class="custom">
2023-03-07 17:44:44 +01:00
._Souligné_. # <u>
{_Code_} # <code>
# Montrer comment écrire du code dans Tyto:
# Bypass avec \ devant {_ et _}
{_\{_Comme ça\_}_}
2022-11-26 12:34:59 +01:00
```
### Abréviations
```
2023-03-28 14:37:42 +02:00
# abbrev sera remplacé par "ABBR" dans la page si défini en entête
# sinon, abbrev sera conservé
2023-03-28 14:37:42 +02:00
# - Toujours écrire dans l'article :
# - entre parenthèses ET majuscules les "(ABBREV)"
2023-03-07 17:49:50 +01:00
2023-03-28 14:37:42 +02:00
Avec cette (ABBREV).
# HTML: <abbr title="Définition de abbrev">ABBR</abbr>
2022-11-26 12:34:59 +01:00
```
### Images
```
2022-11-26 12:45:46 +01:00
# Chaque image doit être placée en début de ligne
2023-03-07 17:49:50 +01:00
# Placer dans un paragraphe pour chacune ou après "|",
2022-12-18 15:14:28 +01:00
# sinon, affichage les une à côté des autres
# ! Si pas d'unité pour w= et h= : défaut "px"
2022-12-18 15:14:28 +01:00
_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
2023-03-07 17:49:50 +01:00
_image:Nom t=https://...# Donne un lien web à l'image
_image:Nom c=CSS t=https://... w=320px h=240 # 240px
2022-11-26 12:34:59 +01:00
```
2023-03-07 17:44:44 +01:00
### Code brut depuis un fichier
2022-11-26 12:34:59 +01:00
```
_raw:Nom
2022-11-26 12:34:59 +01:00
```
### Citations
Possibilité dans toute citation d'utiliser les marqueurs
optionnels `_xxx:`. Pour la date, utilisez le FORMAT INTERNATIONAL
```
2023-03-07 17:57:15 +01:00
# Source: citation complète
[[ CSS_TEST
_cite: echolib
2023-04-16 16:42:31 +02:00
_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 !
))
]]
2023-03-08 11:48:17 +01:00
````
```
2023-03-07 17:57:15 +01:00
# Source: citation basique
[[
Une citation simple, et sans paragraphe
]]
```