2023-12-30 18:52:52 +01:00
# This software needs tests !
2023-12-29 17:56:22 +01:00
This program can be tested and should mainly work. Please report any problems
2023-12-28 00:31:19 +01:00
Tyto - Littérateur is translated in french and english.
2023-12-30 11:42:57 +01:00
Official website not yet udpated for this new version.
2022-11-16 11:45:39 +01:00
2023-09-22 11:52:44 +02:00
# Commands
2022-11-26 12:34:59 +01:00
```
2023-12-28 00:31:19 +01:00
# Get commands help
2023-09-22 11:52:44 +02:00
tyto
2023-12-28 00:31:19 +01:00
# Get all documentation
tyto help all
# How to write words tags (strong...) and anchors
tyto help words anchor
2022-11-26 12:34:59 +01:00
```
2023-12-28 00:31:19 +01:00
2023-11-02 15:32:13 +01:00
# Create new domain
2023-11-10 02:56:50 +01:00
- create a domain directory, like www.domain.tld
2023-11-02 15:32:13 +01:00
- Go to this directory
- type `tyto new domain`
2023-12-29 17:56:22 +01:00
- type `tyto check domain` and PLEASE, CHECK configuration file
2023-12-30 11:42:57 +01:00
- create in new directory domain ".../articles/", an articl file [myfile].tyto (see help)
2023-12-28 00:31:19 +01:00
- type `wip myfile.tyto`
2023-10-14 17:13:12 +02:00
2023-03-07 17:49:50 +01:00
2023-11-01 10:29:43 +01:00
## Exemple d'article .tyto commenté
2023-10-26 18:59:56 +02:00
```
2023-12-28 00:31:19 +01:00
title: Tests
about: Tests divers
date: 2023-02-28
tags: tests
authors: echolib
2023-11-01 10:29:43 +01:00
2023-12-28 00:31:19 +01:00
abbr: CSS
Cascading SteelSheet
en
2023-11-01 10:29:43 +01:00
2023-12-28 00:31:19 +01:00
link: le site est prêt
https://forge.a-lec.org
La forge libre
2023-11-01 10:29:43 +01:00
2023-12-31 12:14:35 +01:00
code: MyPY
@code1 .py
Test d'ajout de code depuis un fichier
2024-01-01 16:44:28 +01:00
file: PyF
@code1 .py
Lien vers un fichier
2023-10-27 17:40:10 +02:00
-----
2023-12-31 12:14:35 +01:00
! TOC
2023-10-26 18:59:56 +02:00
2023-12-28 00:31:19 +01:00
#1 Titre 1
((
Un peu de ::CSS et ::le site est prêt
(( note
Cet article est un test
))
))
2023-10-26 18:59:56 +02:00
2023-12-28 00:31:19 +01:00
#2 Citation
("
cite: Auteur
date: AAAA-MM-JJ
book: Nom du livre
lang: fr
link: https://...
2023-10-27 17:40:10 +02:00
2023-10-26 18:59:56 +02:00
((
2023-12-28 00:31:19 +01:00
Citation complète dans un paragraphe
2023-10-26 18:59:56 +02:00
))
2023-12-28 00:31:19 +01:00
)"
2023-10-26 18:59:56 +02:00
2023-12-28 00:31:19 +01:00
#2 Code (bloc)
2024-01-01 16:44:28 +01:00
{{
2023-12-28 00:31:19 +01:00
# Écrire les marqueurs de mots
# Chaque marqueur à la classe CSS de la configuration
# Astuce : ** + ← + `` + ← + très gras
2023-11-01 10:29:43 +01:00
2023-12-28 00:31:19 +01:00
*`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 enté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
}}
2023-11-13 18:04:12 +01:00
2023-12-28 00:31:19 +01:00
#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
)=
2023-12-31 12:14:35 +01:00
::MyPY
2024-01-01 16:44:28 +01:00
Télécharger le fichier ::PyF. {` Un iCode `}
2023-11-02 15:32:13 +01:00
```
## Output HTML
```
2024-01-01 16:44:28 +01:00
< body >
2023-12-28 00:31:19 +01:00
< div id = "site_container" >
<!-- # include virtual="/template/header.html" -->
<!-- # include virtual="/template/navbar.html" -->
< main id = "article_sidebar" > <!-- Contains <article> and <aside> -->
< article id = "article" >
2024-01-01 16:44:28 +01:00
< time datetime = "2024-01-01 16:12:44" >
2023-12-28 00:31:19 +01:00
< header id = "article_header" >
< h1 id = "article_title" >
< a id = "article_title_link" href = "https://tyto.echolib.re/test.html" title = "Tests -- echolib, 28/02/2023" > Tests< / a >
< / h1 >
< div id = "article_refs" >
echolib, 28/02/2023 [< a id = "post_code" class = "tyto" href = "./test.tyto" title = "Code source : Tests" > Code source< / a > ]
< / div >
< / header >
2023-12-31 12:14:35 +01:00
< h2 class = "toc_title" > Table des matières< / h2 >
< nav class = "toc" aria-labelledby = "navigation-0" >
< ul class = "toc_items" >
< li class = "toc_item" > < a class = "toc_item_link tyto" href = "#toc_1" > Titre 1< / a > < / li >
< ul >
< li class = "toc_item" > < a class = "toc_item_link tyto" href = "#toc_2" > Citation< / a > < / li >
< li class = "toc_item" > < a class = "toc_item_link tyto" href = "#toc_3" > Code (bloc)< / a > < / li >
< li class = "toc_item" > < a class = "toc_item_link tyto" href = "#toc_4" > Une liste< / a > < / li >
< / ul >
< / ul >
< / nav >
< h2 id = "toc_1" class = "tyto" > Titre 1< / h2 >
2023-11-02 15:32:13 +01:00
< p class = "tyto" >
2023-12-28 00:31:19 +01:00
Un peu de < abbr class = "tyto" title = "Cascading SteelSheet" lang = "en" > CSS< / abbr > et < a class = "tyto" href = "https://forge.a-lec.org" title = "La forge libre" > le site est prêt< / a >
< p class = "note" >
Cet article est un test
2023-11-02 15:32:13 +01:00
< / p >
< / p >
2023-12-31 12:14:35 +01:00
< h3 id = "toc_2" class = "tyto" > Citation< / h3 >
2023-12-28 00:31:19 +01:00
< blockquote class = "tyto" cite = "https://..." lang = "fr" title = "-- Auteur, Nom du livre, AAAA-MM-JJ" > < time datetime = "AAAA-MM-JJ" >
2023-11-02 15:32:13 +01:00
< p class = "tyto" >
2023-12-28 00:31:19 +01:00
Citation complète dans un paragraphe
2023-11-02 15:32:13 +01:00
< / p >
2023-12-28 00:31:19 +01:00
< / time > < footer class = "tyto" > < a class = "tyto" href = "https://..." > -- Auteur, Nom du livre, AAAA-MM-JJ< / a > < / footer > < / blockquote >
2023-12-31 12:14:35 +01:00
< h3 id = "toc_3" class = "tyto" > Code (bloc)< / h3 >
2024-01-01 16:44:28 +01:00
< pre class = "bcode_pre" >
< ol class = "bcode_items" >
< li class = "bcode_item" > < code class = "bcode_code" > # Écrire les marqueurs de mots< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > # Chaque marqueur à la classe CSS de la configuration< / code > < / li >
< li class = "bcode_item" >< code class = "bcode_code" > # Astuce : ** + ← + `` + ← + très gras</ code ></ li >
< li class = "bcode_item" > < code class = "bcode_code" > < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > *`très gras`* => < strong> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > +`gras`+ => < b> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > /`italique`/ => < em> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > ;`italique`; => < i> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > _`souligné`_ => < u> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > ~`effacé`~ => < del> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > [`cité`] => < q> # Contenu< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > :`cité`: => < cite> # auteur, nom< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > |`perso`| => < span> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > # Code dans un texte< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > # ! Les marqueurs d' ouverture et de fermeture de code sont sur la MEME LIGNE< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > {` < li> Une entée de liste< /li> `} => < code> < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > < / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > # ! Dans certains cas, il faut ajouter un espace après le 1er marqueur< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > # et/ou avant le second. Ils seront automatiquement supprimés< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > < / code > < / li >
< li class = "bcode_item" >< code class = "bcode_code" > *`DOMAIN/articles/ `* # évite /` : marqueur italique ouvert</ code ></ li >
< / ol > < pre >
2023-12-28 00:31:19 +01:00
< h3 id = "toc_4" class = "tyto" > Une liste< / h3 >
< ul class = "tyto" >
< li class = "tyto" > Première entrée non ordonnée (ul)< / li >
< ul >
< li class = "tyto" > Sous entrée non ordonnée< / li >
< ol >
< li class = "tyto" > Première sous-sous entrée ordonnée (ol)< / li >
< li class = "tyto" > Seconde sous-sous entrée ordonnée< / li >
2023-11-02 15:32:13 +01:00
< / ol >
2023-12-28 00:31:19 +01:00
< / ul >
< li class = "tyto" > Seconde entrée non ordonnée< / li >
< li class = "tyto" > Troisième entrée ... ... non ordonnée< / li >
< / ul >
2023-12-31 12:14:35 +01:00
<!-- Test d'ajout de code depuis un fichier -->
< pre class = "bcode_pre" >
2024-01-01 16:44:28 +01:00
< ol class = "bcode_items" >
< li class = "bcode_item" > < code class = "bcode_code" > #< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > # Code 1< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > #< / code > < / li >
< li class = "bcode_item" > < code class = "bcode_code" > < / code > < / li >
< / ol >
2023-12-31 12:14:35 +01:00
< / pre >
2024-01-01 16:44:28 +01:00
Télécharger le fichier < a class = "tyto file" href = "/files/code1.py" title = "Lien vers un fichier" > PyF< / a > . < code class = "tyto" > Un iCode< / code >
2023-12-28 00:31:19 +01:00
< / time >
< / article >
2023-11-02 15:32:13 +01:00
2023-12-28 00:31:19 +01:00
<!-- # include virtual="/template/sidebar.html" -->
< / main >
<!-- # include virtual="/template/footer.html" -->
</ div > <!-- #site_container -->
< / body >
2023-10-26 18:59:56 +02:00
```
