tyto-litterateur/README.md

237 lines
7.9 KiB
Markdown
Raw Normal View History

2023-12-30 18:52:52 +01:00
# This software needs tests !
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
# Create new domain
2023-11-10 02:56:50 +01:00
- create a domain directory, like www.domain.tld
2024-01-02 15:01:52 +01:00
- go to this directory
- type `tyto new domain`
- type `tyto check domain` and PLEASE, CHECK configuration file
2024-01-02 15:01:52 +01:00
# Create an article
- go to domain directory ".../articles/"
- create an article file [myfile].tyto (see `tyto help article`)
- type `tyto wip myfile.tyto`
- [myfile].html is created in wip/ domain server directory
2023-03-07 17:49:50 +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-12-28 00:31:19 +01:00
abbr: CSS
Cascading SteelSheet
en
2023-12-28 00:31:19 +01:00
link: le site est prêt
https://forge.a-lec.org
La forge libre
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-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
2024-01-02 15:01:52 +01:00
{` <li>Une entrée de liste</li> `} => <code>
2023-12-28 00:31:19 +01:00
# ! 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 `}
```
## 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>
<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
</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">
<p class="tyto">
2023-12-28 00:31:19 +01:00
Citation complète dans un paragraphe
</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`* =&gt; &lt;strong&gt;</code></li>
<li class="bcode_item"><code class="bcode_code">+`gras`+ =&gt; &lt;b&gt;</code></li>
<li class="bcode_item"><code class="bcode_code">/`italique`/ =&gt; &lt;em&gt;</code></li>
<li class="bcode_item"><code class="bcode_code">;`italique`; =&gt; &lt;i&gt;</code></li>
<li class="bcode_item"><code class="bcode_code">_`souligné`_ =&gt; &lt;u&gt;</code></li>
<li class="bcode_item"><code class="bcode_code">~`effacé`~ =&gt; &lt;del&gt;</code></li>
<li class="bcode_item"><code class="bcode_code">[`cité`] =&gt; &lt;q&gt; # Contenu</code></li>
<li class="bcode_item"><code class="bcode_code">:`cité`: =&gt; &lt;cite&gt; # auteur, nom</code></li>
<li class="bcode_item"><code class="bcode_code">|`perso`| =&gt; &lt;span&gt;</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&apos;ouverture et de fermeture de code sont sur la MEME LIGNE</code></li>
<li class="bcode_item"><code class="bcode_code"></code></li>
2024-01-02 15:01:52 +01:00
<li class="bcode_item"><code class="bcode_code">{` &lt;li&gt;Une entrée de liste&lt;/li&gt; `} =&gt; &lt;code&gt;</code></li>
2024-01-01 16:44:28 +01:00
<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>
</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-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
```