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-10-27 17:40:10 +02:00
-----
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)
{{
# É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-11-02 15:32:13 +01:00
```
## Output HTML
```
2023-12-28 00:31:19 +01:00
< body >
< 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" >
< time datetime = "2023-12-27 17:45:57" >
< 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 >
< h2 id = "toc_4" 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-28 00:31:19 +01:00
< h3 id = "toc_4" class = "tyto" > Citation< / h3 >
< 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 >
< h3 id = "toc_4" class = "tyto" > Code (bloc)< / h3 >
< pre class = "bcode" >
< code class = "bcode" > < span class = "bcode ln" > 1< / span > < span class = "bcode line" > # Écrire les marqueurs de mots< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 2< / span > < span class = "bcode line" > # Chaque marqueur à la classe CSS de la configuration< / span > < / code >
< code class = "bcode" >< span class = "bcode ln" > 3</ span >< span class = "bcode line" > # Astuce : ** + ← + `` + ← + très gras</ span ></ code >
< code class = "bcode" > < span class = "bcode ln" > 4< / span > < span class = "bcode line" > < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 5< / span > < span class = "bcode line" > *`très gras`* => < strong> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 6< / span > < span class = "bcode line" > +`gras`+ => < b> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 7< / span > < span class = "bcode line" > /`italique`/ => < em> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 8< / span > < span class = "bcode line" > ;`italique`; => < i> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 9< / span > < span class = "bcode line" > _`souligné`_ => < u> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 10< / span > < span class = "bcode line" > ~`effacé`~ => < del> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 11< / span > < span class = "bcode line" > [`cité`] => < q> # Contenu< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 12< / span > < span class = "bcode line" > :`cité`: => < cite> # auteur, nom< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 13< / span > < span class = "bcode line" > |`perso`| => < span> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 14< / span > < span class = "bcode line" > < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 15< / span > < span class = "bcode line" > # Code dans un texte< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 16< / span > < span class = "bcode line" > # ! Les marqueurs d' ouverture et de fermeture de code sont sur la MEME LIGNE< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 17< / span > < span class = "bcode line" > < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 18< / span > < span class = "bcode line" > {` < li> Une entée de liste< /li> `} => < code> < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 19< / span > < span class = "bcode line" > < / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 20< / span > < span class = "bcode line" > # ! Dans certains cas, il faut ajouter un espace après le 1er marqueur< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 21< / span > < span class = "bcode line" > # et/ou avant le second. Ils seront automatiquement supprimés< / span > < / code >
< code class = "bcode" > < span class = "bcode ln" > 22< / span > < span class = "bcode line" > < / span > < / code >
< code class = "bcode" >< span class = "bcode ln" > 23</ span >< span class = "bcode line" > *`DOMAIN/articles/ `* # évite /` : marqueur italique ouvert</ span ></ code >
< / pre >
< 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 >
< / 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
```
