echolib/tyto-litterateur
echolib
/
tyto-litterateur
1
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity

new usr/share/docs§www/ Tyto website

This commit is contained in:
Cyrille L 2024-01-17 18:23:52 +01:00
parent 6894a51ba4
commit aa809cf7ce
47 changed files with 2067 additions and 301 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
website_doc/404.html → src/usr/share/tyto/docs/www/404.html
View File

@ -33,7 +33,7 @@
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png"> <meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Page non trouvée (echolib) | Tyto - Littérateur</title> <title>Page non trouvée (echolib) | Tyto - Littérateur</title>
</head> </head>
@ -46,7 +46,7 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">

3
website_doc/404.tyto → src/usr/share/tyto/docs/www/404.tyto
View File

@ -4,6 +4,9 @@ date: 2024-01-13
tags: 404,erreur tags: 404,erreur
authors: echolib authors: echolib
! NOMAP
! NORSS
image: 404 image: 404
VH_Tyto_404.png VH_Tyto_404.png
Image montrant la chouette, Tyto, perdue Image montrant la chouette, Tyto, perdue

0
website_doc/VH_Tyto_404.png → src/usr/share/tyto/docs/www/VH_Tyto_404.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 89 KiB

After

Width:  |  Height:  |  Size: 89 KiB

4
website_doc/a-propos/index.html → src/usr/share/tyto/docs/www/a-propos/index.html
View File

@ -33,7 +33,7 @@
<meta property="og:image" content="https://tyto.echolib.re/images/logos/justice_scales_cc0.png"> <meta property="og:image" content="https://tyto.echolib.re/images/logos/justice_scales_cc0.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Mentions Légales (echolib) | Tyto - Littérateur</title> <title>Mentions Légales (echolib) | Tyto - Littérateur</title>
</head> </head>
@ -46,7 +46,7 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<img id="article_logo" src="https://tyto.echolib.re/images/logos/justice_scales_cc0.png" alt="Mentions Légales"> <img id="article_logo" src="https://tyto.echolib.re/images/logos/justice_scales_cc0.png" alt="Mentions Légales">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">

0
website_doc/a-propos/index.tyto → src/usr/share/tyto/docs/www/a-propos/index.tyto
View File

53
website_doc/article/index.html → src/usr/share/tyto/docs/www/article/index.html
View File

@ -15,7 +15,7 @@
<!-- metas generated from article --> <!-- metas generated from article -->
<meta name="title" content="Écrire un article au format .tyto"> <meta name="title" content="Écrire un article au format .tyto">
<meta name="author" content="echolib"> <meta name="author" content="echolib">
<meta name="description" content="Page d'index référençant les articles dédiés à l'écriture des marqueurs utilisés par Tyto - Littérateur"> <meta name="description" content="Comment écrire un article pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,"> <meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,">
<!-- metas links to template files --> <!-- metas links to template files -->
@ -29,11 +29,11 @@
<meta property="og:title" content="Écrire un article au format .tyto"> <meta property="og:title" content="Écrire un article au format .tyto">
<meta property="og:type" content="article"> <meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/index.html"> <meta property="og:url" content="https://tyto.echolib.re/article/index.html">
<meta property="og:description" content="Page d'index référençant les articles dédiés à l'écriture des marqueurs utilisés par Tyto - Littérateur"> <meta property="og:description" content="Comment écrire un article pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/images/logos/format_tyto.png"> <meta property="og:image" content="https://tyto.echolib.re/images/logos/format_tyto.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Écrire un article au format .tyto (echolib) | Tyto - Littérateur</title> <title>Écrire un article au format .tyto (echolib) | Tyto - Littérateur</title>
</head> </head>
@ -46,7 +46,7 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<img id="article_logo" src="https://tyto.echolib.re/images/logos/format_tyto.png" alt="Écrire un article au format .tyto"> <img id="article_logo" src="https://tyto.echolib.re/images/logos/format_tyto.png" alt="Écrire un article au format .tyto">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">
@ -64,13 +64,12 @@ echolib, 06/01/2024 [<a id="post_code" class="tyto" href="./index.tyto" title="C
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Le séparateur ?</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Le séparateur ?</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Dans l'entête</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Dans l'entête</a></li>
<ul> <ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Les métadonnées indispensables</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Les métadonnées optionnelles</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Les métadonnées optionnelles</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Les marqueurs de gestion</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Les marqueurs de gestion</a></li>
</ul> </ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_7">Dans la rédaction</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Dans la rédaction</a></li>
</ul> </ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_8">Rappel</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_7">Rappel</a></li>
</ul> </ul>
</nav> </nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le format ".tyto" ?</h2> <h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le format ".tyto" ?</h2>
@ -80,7 +79,9 @@ textuel brut en page HTML5, il faut utiliser des marqueurs, et respecter une
structure dans le fichier source. Il est recommandé d'utiliser un simple structure dans le fichier source. Il est recommandé d'utiliser un simple
éditeur de texte. Ce fichier doit : éditeur de texte. Ce fichier doit :
<ul role="list" class="tyto"> <ul role="list" class="tyto">
<li role="listitem" class="tyto">être depuis le dossier <q class="tyto">...articles/</q></li>
<li role="listitem" class="tyto">avoir l'extension [...]<strong class="tyto">.tyto</strong></li> <li role="listitem" class="tyto">avoir l'extension [...]<strong class="tyto">.tyto</strong></li>
<li role="listitem" class="tyto">contenir <a role="link" class="tyto" href="./metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur">les métadonnées indispensables</a></li>
<li role="listitem" class="tyto">contenir un séparateur d'au moins 5 tirets <code class="tyto">-----</code></li> <li role="listitem" class="tyto">contenir un séparateur d'au moins 5 tirets <code class="tyto">-----</code></li>
</ul> </ul>
</p> </p>
@ -97,49 +98,47 @@ marqueurs dédiés au formattge des textes.
Une métadonnée est composée par un marqueur, et ses contenus. Il y a 2 types Une métadonnée est composée par un marqueur, et ses contenus. Il y a 2 types
de métadonnées dans l'entête : de métadonnées dans l'entête :
<ul role="list" class="tyto"> <ul role="list" class="tyto">
<li role="listitem" class="tyto">Les métadonnées indispensables</li> <li role="listitem" class="tyto"><a role="link" class="tyto" href="./metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur">les métadonnées indispensables</a></li>
<li role="listitem" class="tyto">les métadonnées optionnelles</li> <li role="listitem" class="tyto">les métadonnées optionnelles</li>
</ul> </ul>
</p> </p>
<h4 role="heading" aria-level="4" id="toc_4" class="tyto">Les métadonnées indispensables</h4> <h4 role="heading" aria-level="4" id="toc_4" class="tyto">Les métadonnées optionnelles</h4>
<p class="tyto"> <p class="tyto">
<a role="link" class="tyto" href="./metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur">Les métadonnées indispensables</a> ont des marqueurs uniques qui doivent être Les métadonnées optionnelles peuvent avoir des marqueurs multiples qui
configurés sur une seule ligne. doivent être configurés sur 3 lignes, hormis pour <a class="tyto" href="#toc_6">les marqueurs de gestion</a>
</p>
<h4 role="heading" aria-level="4" id="toc_5" class="tyto">Les métadonnées optionnelles</h4>
<p class="tyto">
Les métadonnées optionnels peuvent avoir des marqueurs multiples qui doivent
être configurés sur 3 lignes, hormis pour <a class="tyto" href="#toc_6">les marqueurs de gestion</a>
</p> </p>
<p class="tyto"> <p class="tyto">
La 1ère ligne comprend le marqueur, suvi par son identité. Cette identité La 1ère ligne comprend le marqueur, suvi par son identité. Cette identité
doit être unique (toutes identités confondues), et doit être reprise dans doit être unique (toutes identités confondues), et doit être reprise dans
les contenus rédactionnels, préfixée par <code class="tyto">::</code>. les contenus rédactionnels, préfixée par <code class="tyto">::</code>.
<ul role="list" class="tyto"> <ul role="list" class="tyto">
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./metas_liens.html" title="Comment écrire des liens pour Tyto - Littérateur">Écrire/créer des liens</a></li> <li role="listitem" class="tyto"><a role="link" class="tyto" href="./metas_liens.html" title="Comment écrire des liens pour Tyto - Littérateur">Créer des liens</a></li>
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur">Les URIs spécifiques</a></li> <li role="listitem" class="tyto"><a role="link" class="tyto" href="./metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur">Les URIs spécifiques</a></li>
</ul> </ul>
</p> </p>
<h4 role="heading" aria-level="4" id="toc_6" class="tyto">Les marqueurs de gestion</h4> <h4 role="heading" aria-level="4" id="toc_5" class="tyto">Les marqueurs de gestion</h4>
<p class="tyto"> <p class="tyto">
Les marqueurs de gestion sont uniques, ptionnels et sans métadonnée. Les marqueurs de gestion sont uniques, optionnels et sans métadonnée.
<ul role="list" class="tyto"> <ul role="list" class="tyto">
<li role="listitem" class="tyto"><b class="tyto">! NOMAP</b> : article non présent dans le sitemap</li> <li role="listitem" class="tyto"><b class="tyto">! NOMAP</b> : article non présent dans le sitemap</li>
<li role="listitem" class="tyto"><b class="tyto">! NORSS</b> : article non présent dans le flux RSS</li> <li role="listitem" class="tyto"><b class="tyto">! NORSS</b> : article non présent dans le flux RSS</li>
<li role="listitem" class="tyto"><b class="tyto">! LOGO</b> : Montre le logo de l'article près de son titre </li> <li role="listitem" class="tyto"><b class="tyto">! LOGO</b> : Montre le logo de l'article près de son titre </li>
</ul> </ul>
</p> </p>
<h3 role="heading" aria-level="3" id="toc_7" class="tyto">Dans la rédaction</h3> <h3 role="heading" aria-level="3" id="toc_6" class="tyto">Dans la rédaction</h3>
<p class="tyto"> <p class="tyto">
Dans la zone des contenus rédactionnels - sous le séparateur, les retours Dans la zone des contenus rédactionnels - sous le séparateur, les retours
à la lignes n'ont aucun effet sur la page HTML, afin de rendre les documents à la lignes n'ont aucun effet sur la page HTML. Vous pouvez en profiter pour
plus lisibles et aérés. Il est également utile d'indenter les marqueurs rendre vos documents plus lisibles et aérés. Il est également utile
de blocs et leurs contenus. d'indenter les marqueurs de blocs et leurs contenus.
<ul role="list" class="tyto"> <ul role="list" class="tyto">
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./redac_titres.html" title="Comment écrire les titres et les sous-titres pour Tyto - Littérateur">Écrire les titres</a>, créer la table des matières</li> <li role="listitem" class="tyto"><a role="link" class="tyto" href="./redac_titres.html" title="Comment écrire les titres et les sous-titres pour Tyto - Littérateur">Écrire des titres</a>, créer une table des matières</li>
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./redac_paragraphes.html" title="Comment écrire des paragraphes pour Tyto - Littérateur">Écrire des paragraphes</a></li>
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./mere_images.html" title="Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur">Afficher des images</a></li>
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./redac_blockcodes.html" title="Comment afficher du code en bloc pour Tyto - Littérateur">Afficher du code en bloc</a></li>
</ul> </ul>
</p> </p>
<h2 role="heading" aria-level="2" id="toc_8" class="tyto">Rappel</h2> <h2 role="heading" aria-level="2" id="toc_7" class="tyto">Rappel</h2>
<p class="tyto"> <p class="tyto">
La commande <code class="tyto">tyto help</code> regroupe différentes sections d'aides. Vous La commande <code class="tyto">tyto help</code> regroupe différentes sections d'aides. Vous
pouvez par exemple taper <code class="tyto">tyto help article</code> pour avoir un aperçu de pouvez par exemple taper <code class="tyto">tyto help article</code> pour avoir un aperçu de

49
website_doc/article/index.tyto → src/usr/share/tyto/docs/www/article/index.tyto
View File

@ -1,15 +1,15 @@
title: Écrire un article au format .tyto title: Écrire un article au format .tyto
about: Page d'index référençant les articles dédiés à l'écriture des marqueurs utilisés par Tyto - Littérateur about: Comment écrire un article pour Tyto - Littérateur
date: 2024-01-06 date: 2024-01-06
tags: format .tyto,écrire, tags: format .tyto,écrire,
authors: echolib authors: echolib
logo: @logos/format_tyto.png logo: @logos/format_tyto.png
link: Les métadonnées indispensables link: les métadonnées indispensables
./metas_obligatoires.html ./metas_obligatoires.html
Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur
link: Écrire/créer des liens link: Créer des liens
./metas_liens.html ./metas_liens.html
Comment écrire des liens pour Tyto - Littérateur Comment écrire des liens pour Tyto - Littérateur
@ -17,10 +17,22 @@ link: Les URIs spécifiques
./metas_uris.html ./metas_uris.html
Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur
link: Écrire les titres link: Écrire des titres
./redac_titres.html ./redac_titres.html
Comment écrire les titres et les sous-titres pour Tyto - Littérateur Comment écrire les titres et les sous-titres pour Tyto - Littérateur
link: Écrire des paragraphes
./redac_paragraphes.html
Comment écrire des paragraphes pour Tyto - Littérateur
link: Afficher des images
./mere_images.html
Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur
link: Afficher du code en bloc
./redac_blockcodes.html
Comment afficher du code en bloc pour Tyto - Littérateur
! LOGO ! LOGO
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
! TOC ! TOC
@ -32,7 +44,9 @@ link: Écrire les titres
structure dans le fichier source. Il est recommandé d'utiliser un simple structure dans le fichier source. Il est recommandé d'utiliser un simple
éditeur de texte. Ce fichier doit : éditeur de texte. Ce fichier doit :
(= (=
= être depuis le dossier [` ...articles/ `]
= avoir l'extension [...]*` .tyto `* = avoir l'extension [...]*` .tyto `*
= contenir ::les métadonnées indispensables
= contenir un séparateur d'au moins 5 tirets {` ----- `} = contenir un séparateur d'au moins 5 tirets {` ----- `}
)= )=
)) ))
@ -53,35 +67,29 @@ link: Écrire les titres
Une métadonnée est composée par un marqueur, et ses contenus. Il y a 2 types Une métadonnée est composée par un marqueur, et ses contenus. Il y a 2 types
de métadonnées dans l'entête : de métadonnées dans l'entête :
(= (=
= Les métadonnées indispensables = ::les métadonnées indispensables
= les métadonnées optionnelles = les métadonnées optionnelles
)= )=
)) ))
#3 Les métadonnées indispensables
((
::Les métadonnées indispensables ont des marqueurs uniques qui doivent être
configurés sur une seule ligne.
))
#3 Les métadonnées optionnelles #3 Les métadonnées optionnelles
(( ((
Les métadonnées optionnels peuvent avoir des marqueurs multiples qui doivent Les métadonnées optionnelles peuvent avoir des marqueurs multiples qui
être configurés sur 3 lignes, hormis pour >`toc_6:les marqueurs de gestion`< doivent être configurés sur 3 lignes, hormis pour >`toc_6:les marqueurs de gestion`<
)) ))
(( ((
La 1ère ligne comprend le marqueur, suvi par son identité. Cette identité La 1ère ligne comprend le marqueur, suvi par son identité. Cette identité
doit être unique (toutes identités confondues), et doit être reprise dans doit être unique (toutes identités confondues), et doit être reprise dans
les contenus rédactionnels, préfixée par {` :: `}. les contenus rédactionnels, préfixée par {` :: `}.
(= (=
= ::Écrire/créer des liens = ::Créer des liens
= ::Les URIs spécifiques = ::Les URIs spécifiques
)= )=
)) ))
#3 Les marqueurs de gestion #3 Les marqueurs de gestion
(( ((
Les marqueurs de gestion sont uniques, ptionnels et sans métadonnée. Les marqueurs de gestion sont uniques, optionnels et sans métadonnée.
(= (=
= +`! NOMAP`+ : article non présent dans le sitemap = +`! NOMAP`+ : article non présent dans le sitemap
= +`! NORSS`+ : article non présent dans le flux RSS = +`! NORSS`+ : article non présent dans le flux RSS
@ -93,11 +101,14 @@ link: Écrire les titres
#2 Dans la rédaction #2 Dans la rédaction
(( ((
Dans la zone des contenus rédactionnels - sous le séparateur, les retours Dans la zone des contenus rédactionnels - sous le séparateur, les retours
à la lignes n'ont aucun effet sur la page HTML, afin de rendre les documents à la lignes n'ont aucun effet sur la page HTML. Vous pouvez en profiter pour
plus lisibles et aérés. Il est également utile d'indenter les marqueurs rendre vos documents plus lisibles et aérés. Il est également utile
de blocs et leurs contenus. d'indenter les marqueurs de blocs et leurs contenus.
(= (=
= ::Écrire les titres, créer la table des matières = ::Écrire des titres, créer une table des matières
= ::Écrire des paragraphes
= ::Afficher des images
= ::Afficher du code en bloc
)= )=
)) ))

207
src/usr/share/tyto/docs/www/article/mere_images.html Normal file
View File

@ -0,0 +1,207 @@
<!-- Afficher des images - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Afficher des images">
<meta name="author" content="echolib">
<meta name="description" content="Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,marqueurs,images">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/mere_images.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Afficher des images">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/mere_images.html">
<meta property="og:description" content="Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Afficher des images (echolib) | Tyto - Littérateur</title>
</head>
<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="2024-01-17 18:17:32">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/mere_images.html" title="Afficher des images -- echolib, 05/12/2023">Afficher des images</a>
</h1>
<div id="article_refs">
echolib, 05/12/2023 [<a id="post_code" class="tyto" href="./mere_images.tyto" title="Code source : Afficher des images">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Le marqueur d'image dans l'entête</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Exemples de configurations</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Paramètres du marqueur d'entête</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Première ligne</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Seconde ligne</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Troisième ligne</a></li>
</ul>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_7">Le marqueur d'appel dans la rédaction</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_8">Paramètres optionels du marqueur d'appel</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_9">Exemples d'appels</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_10">Rappels</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_11">Exemple final</a></li>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le marqueur d'image dans l'entête</h2>
<p class="tyto">
Pour pouvoir afficher des images dans un article, il faut d'abord les
référencer dans l'entête (au dessus du séparateur <code class="tyto">-----</code>). Le marqueur
d'entête <code class="tyto">image:</code> se configure sur 3 lignes.
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Exemples de configurations</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># Dans l&apos;entête de l&apos;article (avant le séparateur)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: Identité1</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> monimage.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Un texte alternatif accessible</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: Identité2</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> @team01.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> L&apos;équipe en image</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: Identité3</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> /divers/photo1.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif décrivant la photo</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_3" class="tyto">Paramètres du marqueur d'entête</h3>
<h4 role="heading" aria-level="4" id="toc_4" class="tyto">Première ligne</h4>
<p class="tyto">
L'identité du marqueur. <code class="tyto">image: UniqueID</code>. L'image doit avoir une
identité unique (y compris des autres marqueurs d'entête).
</p>
<h4 role="heading" aria-level="4" id="toc_5" class="tyto">Seconde ligne</h4>
<p class="tyto">
URI du fichier. Depuis le dossier du domaine <q class="tyto">articles/</q>. L'URI peut
avoir 3 dossiers sources différents, en fonction du premier caractère ; voir
<a role="link" class="tyto" href="./metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur">les URIs spécifiques</a> :
<ul role="list" class="tyto">
<li role="listitem" class="tyto"><code class="tyto">@team01.png</code> : depuis le dossier <q class="tyto">articles/images/</q></li>
<li role="listitem" class="tyto"><code class="tyto">/team01.png</code> : depuis le dossier <q class="tyto">articles/</q></li>
<li role="listitem" class="tyto"><code class="tyto">team01.png</code> : depuis le dossier où se trouve l'article</li>
</ul>
</p>
<h4 role="heading" aria-level="4" id="toc_6" class="tyto">Troisième ligne</h4>
<p class="tyto">
Texte alternatif. le texte décrivant l'image. Ce texte est utilisé dans la
balise HTML <code class="tyto">&lt;img alt=&quot;&quot; title=&quot;&quot;&gt;</code> et permet de rendre l'image plus
accessible.
</p>
<h2 role="heading" aria-level="2" id="toc_7" class="tyto">Le marqueur d'appel dans la rédaction</h2>
<p class="tyto">
Une image référencée peut être appelée par plusieurs marqueurs d'appels dans
la partie dédiée aux contenus rédactionnels. Le marqueur d'appel est
composé par <code class="tyto">::</code>, suivi de l'identité donnée au marqueur d'entête. Vous
ne devez mettre qu'un seul marqueur d'appel par ligne.
</p>
<p class="tyto">
Sans le signe <code class="tyto">|</code> (raccourci de <code class="tyto">&lt;br&gt;</code> en HTML) sur une nouvelle
ligne, les images pourraient être affichées les unes à côté des autres ;
(<a class="tyto" href="#rappel">voir Rappel</a>).
</p>
<h3 role="heading" aria-level="3" id="toc_8" class="tyto">Paramètres optionels du marqueur d'appel</h3>
<p class="tyto">
Il y a 4 paramètres possibles et leur ordre est aléatoire. Après le marqueur
d'appel, ajouter les, en les séparant par une virgule. Si un seul paramètre
est défini, n'oubliez pas de rajouter une virgule. Voir les exemples d'appels
ci-dessous. Les paramètres sont:
<ul role="list" class="tyto">
<li role="listitem" class="tyto"><code class="tyto">&quot;c=CLASS&quot;</code> : CLASS est le nom de la classe CSS.</li>
<li role="listitem" class="tyto"><code class="tyto">&quot;w=WIDTH&quot;</code> : WIDTH est la largeur désirée</li>
<li role="listitem" class="tyto"><code class="tyto">&quot;h=HEIGHT&quot;</code> : HEIGHT est la hauteur désirée</li>
<li role="listitem" class="tyto"><code class="tyto">&quot;f=LEGENDE&quot;</code> : LEGENDE est le texte de légende (crée <code class="tyto">&lt;figure&gt;...</code>) </li>
</ul>
</p>
<p class="tyto">
Par défaut, la classe utilisée est celle dans la <a role="link" class="tyto" href="../config/index.html" title="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur">configuration du domaine</a>,
si le paramètre <code class="tyto">&quot;c=CLASS&quot;</code> n'est pas défini.
</p>
<h3 role="heading" aria-level="3" id="toc_9" class="tyto">Exemples d'appels</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">...</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">::Identité2</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">|</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Un seul paramètre termine par une &quot;,&quot; !</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">::Identité2 &quot;c=ClasseTeam&quot;,</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">|</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">::Identité2 &quot;f=Une légende&quot;, &quot;c=ClasseFigure&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">|</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Sans unité aux dimmensions, &quot;px&quot; est ajouté</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">::Identité2 &quot;w=800&quot;, &quot;h=20%&quot;, &quot;c=Class&quot;, &quot;f=Légende de l&apos;image&quot;</code></li>
</ol></pre>
<a id="rappel"></a>
<h2 role="heading" aria-level="2" id="toc_10" class="tyto">Rappels</h2>
<p class="tyto">
Sachez qu'une image en HTML suit une disposition "en ligne", sauf si vous
ajoutez une légende au marqueur d'appel. Dans ce cas, la balise HTML
<code class="tyto">&lt;figure&gt;</code> (disposition en bloc) est utiliée. Toutefois, chaque image
peut avoir une classe CSS. Dans le fichier <q class="tyto">styles.css</q>, il suffit
d'ajouter, à la classe définie, une propriété de bloc, comme
<code class="tyto">display: block;</code>, pour qu'elle suive une disposition "en bloc".
</p>
<h3 role="heading" aria-level="3" id="toc_11" class="tyto">Exemple final</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># L&apos;image se trouve dans le dossier articles/images/team/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: fred01</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> @team/fred_01.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Fred devant son PC</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Séparateur d&apos;entête</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">-----</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">::fred01 &quot;c=bpic&quot;,</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

139
src/usr/share/tyto/docs/www/article/mere_images.tyto Normal file
View File

@ -0,0 +1,139 @@
title: Afficher des images
about: Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur
tags: marqueurs,images
date: 2023-12-05
authors: echolib
link: les URIs spécifiques
./metas_uris.html
Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur
link: configuration du domaine
../config/index.html
Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur
-------------------------------------------------------------------------------
! TOC
#1 Le marqueur d'image dans l'entête
((
Pour pouvoir afficher des images dans un article, il faut d'abord les
référencer dans l'entête (au dessus du séparateur {` ----- `}). Le marqueur
d'entête {` image: `} se configure sur 3 lignes.
))
#2 Exemples de configurations
{{
# Dans l'entête de l'article (avant le séparateur)
image: Identité1
monimage.png
Un texte alternatif accessible
image: Identité2
@team01.png
L'équipe en image
image: Identité3
/divers/photo1.png
Texte alternatif décrivant la photo
}}
#2 Paramètres du marqueur d'entête
#3 Première ligne
((
L'identité du marqueur. {` image: UniqueID `}. L'image doit avoir une
identité unique (y compris des autres marqueurs d'entête).
))
#3 Seconde ligne
((
URI du fichier. Depuis le dossier du domaine [` articles/ `]. L'URI peut
avoir 3 dossiers sources différents, en fonction du premier caractère ; voir
::les URIs spécifiques :
(=
= {` @team01.png `} : depuis le dossier [` articles/images/ `]
= {` /team01.png `} : depuis le dossier [` articles/ `]
= {` team01.png `} : depuis le dossier où se trouve l'article
)=
))
#3 Troisième ligne
((
Texte alternatif. le texte décrivant l'image. Ce texte est utilisé dans la
balise HTML {` <img alt="" title=""> `} et permet de rendre l'image plus
accessible.
))
#1 Le marqueur d'appel dans la rédaction
((
Une image référencée peut être appelée par plusieurs marqueurs d'appels dans
la partie dédiée aux contenus rédactionnels. Le marqueur d'appel est
composé par {` :: `}, suivi de l'identité donnée au marqueur d'entête. Vous
ne devez mettre qu'un seul marqueur d'appel par ligne.
))
((
Sans le signe {` | `} (raccourci de {` <br> `} en HTML) sur une nouvelle
ligne, les images pourraient être affichées les unes à côté des autres ;
(>`rappel: voir Rappel`<).
))
#2 Paramètres optionels du marqueur d'appel
((
Il y a 4 paramètres possibles et leur ordre est aléatoire. Après le marqueur
d'appel, ajouter les, en les séparant par une virgule. Si un seul paramètre
est défini, n'oubliez pas de rajouter une virgule. Voir les exemples d'appels
ci-dessous. Les paramètres sont:
(=
= {` "c=CLASS" `} : CLASS est le nom de la classe CSS.
= {` "w=WIDTH" `} : WIDTH est la largeur désirée
= {` "h=HEIGHT" `} : HEIGHT est la hauteur désirée
= {` "f=LEGENDE" `} : LEGENDE est le texte de légende (crée {` <figure>... `})
)=
))
((
Par défaut, la classe utilisée est celle dans la ::configuration du domaine,
si le paramètre {` "c=CLASS" `} n'est pas défini.
))
#2 Exemples d'appels
{{
...
::Identité2
|
# Un seul paramètre termine par une "," !
::Identité2 "c=ClasseTeam",
|
::Identité2 "f=Une légende", "c=ClasseFigure"
|
# Sans unité aux dimmensions, "px" est ajouté
::Identité2 "w=800", "h=20%", "c=Class", "f=Légende de l'image"
}}
-> rappel
#1 Rappels
((
Sachez qu'une image en HTML suit une disposition "en ligne", sauf si vous
ajoutez une légende au marqueur d'appel. Dans ce cas, la balise HTML
{` <figure> `} (disposition en bloc) est utiliée. Toutefois, chaque image
peut avoir une classe CSS. Dans le fichier [` styles.css `], il suffit
d'ajouter, à la classe définie, une propriété de bloc, comme
{` display: block; `}, pour qu'elle suive une disposition "en bloc".
))
#2 Exemple final
{{
# L'image se trouve dans le dossier articles/images/team/
image: fred01
@team/fred_01.png
Fred devant son PC
# Séparateur d'entête
-----
::fred01 "c=bpic",
}}

16
website_doc/article/metas_liens.html → src/usr/share/tyto/docs/www/article/metas_liens.html
View File

@ -1,4 +1,4 @@
<!-- Écrire/créer des liens - Tyto - Littérateur (page generated by Tyto - Littérateur) --> <!-- Créer des liens - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html> <!DocType html>
<html lang="fr"> <html lang="fr">
<head> <head>
@ -13,7 +13,7 @@
<meta name="copyright" content="gfdl-1.3"> <meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article --> <!-- metas generated from article -->
<meta name="title" content="Écrire/créer des liens"> <meta name="title" content="Créer des liens">
<meta name="author" content="echolib"> <meta name="author" content="echolib">
<meta name="description" content="Comment écrire des liens pour Tyto - Littérateur"> <meta name="description" content="Comment écrire des liens pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,liens"> <meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,liens">
@ -26,15 +26,15 @@
<!-- Open Graph data --> <!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur"> <meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Écrire/créer des liens"> <meta property="og:title" content="Créer des liens">
<meta property="og:type" content="article"> <meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/metas_liens.html"> <meta property="og:url" content="https://tyto.echolib.re/article/metas_liens.html">
<meta property="og:description" content="Comment écrire des liens pour Tyto - Littérateur"> <meta property="og:description" content="Comment écrire des liens pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png"> <meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Écrire/créer des liens (echolib) | Tyto - Littérateur</title> <title>Créer des liens (echolib) | Tyto - Littérateur</title>
</head> </head>
<body> <body>
@ -46,14 +46,14 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/metas_liens.html" title="Écrire/créer des liens -- echolib, 08/01/2024">Écrire/créer des liens</a> <a role="link" id="article_title_link" href="https://tyto.echolib.re/article/metas_liens.html" title="Créer des liens -- echolib, 08/01/2024">Créer des liens</a>
</h1> </h1>
<div id="article_refs"> <div id="article_refs">
echolib, 08/01/2024 [<a id="post_code" class="tyto" href="./metas_liens.tyto" title="Code source : Écrire/créer des liens">Code source</a>] echolib, 08/01/2024 [<a id="post_code" class="tyto" href="./metas_liens.tyto" title="Code source : Créer des liens">Code source</a>]
</div> </div>
</header> </header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2> <h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>

2
website_doc/article/metas_liens.tyto → src/usr/share/tyto/docs/www/article/metas_liens.tyto
View File

@ -1,4 +1,4 @@
title: Écrire/créer des liens title: Créer des liens
about: Comment écrire des liens pour Tyto - Littérateur about: Comment écrire des liens pour Tyto - Littérateur
date: 2024-01-08 date: 2024-01-08
tags: format .tyto,écrire,liens tags: format .tyto,écrire,liens

4
website_doc/article/metas_obligatoires.html → src/usr/share/tyto/docs/www/article/metas_obligatoires.html
View File

@ -33,7 +33,7 @@
<meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_5_metas.png"> <meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_5_metas.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Écrire les métadonnées indispensables (echolib) | Tyto - Littérateur</title> <title>Écrire les métadonnées indispensables (echolib) | Tyto - Littérateur</title>
</head> </head>
@ -46,7 +46,7 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_5_metas.png" alt="Écrire les métadonnées indispensables"> <img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_5_metas.png" alt="Écrire les métadonnées indispensables">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">

0
website_doc/article/metas_obligatoires.tyto → src/usr/share/tyto/docs/www/article/metas_obligatoires.tyto
View File

4
website_doc/article/metas_uris.html → src/usr/share/tyto/docs/www/article/metas_uris.html
View File

@ -33,7 +33,7 @@
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png"> <meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Les URIs spécifiques (echolib) | Tyto - Littérateur</title> <title>Les URIs spécifiques (echolib) | Tyto - Littérateur</title>
</head> </head>
@ -46,7 +46,7 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">

0
website_doc/article/metas_uris.tyto → src/usr/share/tyto/docs/www/article/metas_uris.tyto
View File

143
src/usr/share/tyto/docs/www/article/redac_blockcodes.html Normal file
View File

@ -0,0 +1,143 @@
<!-- Afficher du code en bloc - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Afficher du code en bloc">
<meta name="author" content="echolib">
<meta name="description" content="Comment afficher du code en bloc pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,rédaction,marqueurs,blockcode">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/redac_blockcodes.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Afficher du code en bloc">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/redac_blockcodes.html">
<meta property="og:description" content="Comment afficher du code en bloc pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Afficher du code en bloc (echolib) | Tyto - Littérateur</title>
</head>
<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="2024-01-17 18:17:32">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/redac_blockcodes.html" title="Afficher du code en bloc -- echolib, 16/01/2024">Afficher du code en bloc</a>
</h1>
<div id="article_refs">
echolib, 16/01/2024 [<a id="post_code" class="tyto" href="./redac_blockcodes.tyto" title="Code source : Afficher du code en bloc">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Les marqueurs</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Exemples de code en bloc</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Sortie HTML</a></li>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Les marqueurs</h2>
<p class="tyto">
Pour afficher du code en bloc, il faut utiliser les marqueurs d'ouverture
<code class="tyto">{{</code> et de fermeture <code class="tyto">}}</code>, et placer les lignes de codes dedans.
Il est recommandé d'indenter les lignes de codes dans le bloc. <cite class="tyto">Tyto</cite>
prend en compte l'indentation de la première ligne de code pour l'affichage
HTML.
</p>
<p class="tyto">
Les marqueurs d'ouverture et de fermeture doivent se trouver <strong class="tyto">au
même niveau d'indentation</strong> dans l'article source, et <strong class="tyto">sonts seuls sur une
ligne</strong>
</p>
<p class="tyto">
Vous pouvez définir une classe CSS après le marqueur d'ouverture. Par défaut,
la classe utilisée est "bcode". La classe est reprise dans les balises HTML.
Voir ci-dessous la sortie HTML des exemples suivants.
</p>
<h2 role="heading" aria-level="2" id="toc_2" class="tyto">Exemples de code en bloc</h2>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># Comment afficher du code pour Tyto - Littérateur</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">{{</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Placer du code ici</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> et encore là...</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">}}</code></li>
</ol></pre>
<pre class="MonCode_pre">
<ol class="MonCode_items">
<li role="listitem" class="MonCode_item"><code class="MonCode_code">{{ MonCode</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> # ! Aucune propriété de style MonCode existe</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> # dans styles.css. Affichage par défaut</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> def tyto_code(hello):</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> if hello:</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> print(hello)</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code">}}</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_3" class="tyto">Sortie HTML</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;pre class=&quot;bcode_pre&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;ol class=&quot;bcode_items&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;bcode_item&quot;&gt;&lt;code class=&quot;bcode_code&quot;&gt;# Comment afficher du code pour Tyto - Littérateur&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;bcode_item&quot;&gt;&lt;code class=&quot;bcode_code&quot;&gt;{{&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;bcode_item&quot;&gt;&lt;code class=&quot;bcode_code&quot;&gt; Placer du code ici&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;bcode_item&quot;&gt;&lt;code class=&quot;bcode_code&quot;&gt; et encore là...&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;bcode_item&quot;&gt;&lt;code class=&quot;bcode_code&quot;&gt;}}&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/ol&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/pre&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;pre class=&quot;MonCode_pre&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;ol class=&quot;MonCode_items&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt;{{ MonCode&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt; # ! Aucune propriété de style MonCode existe&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt; # dans styles.css. Affichage par défaut&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt; def tyto_code(hello):&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt; if hello:&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt; print(hello)&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;MonCode_item&quot;&gt;&lt;code class=&quot;MonCode_code&quot;&gt;}}&lt;/code&gt;&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/ol&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/pre&gt;</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

71
src/usr/share/tyto/docs/www/article/redac_blockcodes.tyto Normal file
View File

@ -0,0 +1,71 @@
title: Afficher du code en bloc
about: Comment afficher du code en bloc pour Tyto - Littérateur
tags: rédaction,marqueurs,blockcode
date: 2024-01-16
authors: echolib
-------------------------------------------------------------------------------
! TOC
#1 Les marqueurs
((
Pour afficher du code en bloc, il faut utiliser les marqueurs d'ouverture
{` {{ `} et de fermeture {` }} `}, et placer les lignes de codes dedans.
Il est recommandé d'indenter les lignes de codes dans le bloc. :`Tyto`:
prend en compte l'indentation de la première ligne de code pour l'affichage
HTML.
))
((
Les marqueurs d'ouverture et de fermeture doivent se trouver *`au
même niveau d'indentation`* dans l'article source, et *`sonts seuls sur une
ligne`*
))
((
Vous pouvez définir une classe CSS après le marqueur d'ouverture. Par défaut,
la classe utilisée est "bcode". La classe est reprise dans les balises HTML.
Voir ci-dessous la sortie HTML des exemples suivants.
))
#1 Exemples de code en bloc
{{
# Comment afficher du code pour Tyto - Littérateur
{{
Placer du code ici
et encore là...
}}
}}
{{ MonCode
{{ MonCode
# ! Aucune propriété de style MonCode existe
# dans styles.css. Affichage par défaut
def tyto_code(hello):
if hello:
print(hello)
}}
}}
#2 Sortie HTML
{{
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># Comment afficher du code pour Tyto - Littérateur</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">{{</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Placer du code ici</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> et encore là...</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">}}</code></li>
</ol>
</pre>
<pre class="MonCode_pre">
<ol class="MonCode_items">
<li role="listitem" class="MonCode_item"><code class="MonCode_code">{{ MonCode</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> # ! Aucune propriété de style MonCode existe</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> # dans styles.css. Affichage par défaut</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> def tyto_code(hello):</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> if hello:</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code"> print(hello)</code></li>
<li role="listitem" class="MonCode_item"><code class="MonCode_code">}}</code></li>
</ol>
</pre>
}}

114
src/usr/share/tyto/docs/www/article/redac_paragraphes.html Normal file
View File

@ -0,0 +1,114 @@
<!-- Écrire des paragraphes - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Écrire des paragraphes">
<meta name="author" content="echolib">
<meta name="description" content="Comment écrire des paragraphes pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,rédaction,marqueurs,paragraphes">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/redac_paragraphes.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Écrire des paragraphes">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/redac_paragraphes.html">
<meta property="og:description" content="Comment écrire des paragraphes pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Écrire des paragraphes (echolib) | Tyto - Littérateur</title>
</head>
<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="2024-01-17 18:17:32">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/redac_paragraphes.html" title="Écrire des paragraphes -- echolib, 05/12/2023">Écrire des paragraphes</a>
</h1>
<div id="article_refs">
echolib, 05/12/2023 [<a id="post_code" class="tyto" href="./redac_paragraphes.tyto" title="Code source : Écrire des paragraphes">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Les marqueurs</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Exemple de paragraphes</a></li>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Les marqueurs</h2>
<p class="tyto">
Les <strong class="tyto">marqueurs de paragraphes</strong> forment un bloc. Pour écrire des
paragraphes <code class="tyto">&lt;p&gt;&lt;/p&gt;</code> en HTML, et même les imbriquer, il faut écrire du
texte entre les marqueurs d'ouverture <code class="tyto">((</code>, et de fermeture <code class="tyto">))</code>.
Ces marqueurs doivent être placés <b class="tyto">seuls au début d'une ligne</b>.
</p>
<p class="tyto">
Vous pouvez définir une classe CSS après le marqueur d'ouverture. Par défaut,
la classe utilisée est celle dans la <a role="link" class="tyto" href="../config/index.html" title="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur">configuration du domaine</a>.
</p>
<p class="astuce">
Les marqueurs peuvent être imbriqués. Pour que votre article reste lisible,
indentez les marqueurs, leurs contenus et aérer avec des retours à la ligne.
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Exemple de paragraphes</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">(( Par_A</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Ceci est un 1er grand paragraphe...</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> ayant pour classe CSS Par_A</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> </code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> (( Par_AA</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Ceci est un sous-paragraphe...</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> ayant pour classe CSS Par_AA</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> ))</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">))</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">(( Par_B</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Ceci est un 2nd grand paragraphes...</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> ayant pour classe CSS PAR_B</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">))</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

49
src/usr/share/tyto/docs/www/article/redac_paragraphes.tyto Normal file
View File

@ -0,0 +1,49 @@
title: Écrire des paragraphes
about: Comment écrire des paragraphes pour Tyto - Littérateur
tags: rédaction,marqueurs,paragraphes
date: 2023-12-05
authors: echolib
link: configuration du domaine
../config/index.html
Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur
-------------------------------------------------------------------------------
! TOC
#1 Les marqueurs
((
Les *`marqueurs de paragraphes`* forment un bloc. Pour écrire des
paragraphes {` <p></p> `} en HTML, et même les imbriquer, il faut écrire du
texte entre les marqueurs d'ouverture {` (( `}, et de fermeture {` )) `}.
Ces marqueurs doivent être placés +`seuls au début d'une ligne`+.
))
((
Vous pouvez définir une classe CSS après le marqueur d'ouverture. Par défaut,
la classe utilisée est celle dans la ::configuration du domaine.
))
(( astuce
Les marqueurs peuvent être imbriqués. Pour que votre article reste lisible,
indentez les marqueurs, leurs contenus et aérer avec des retours à la ligne.
))
#2 Exemple de paragraphes
{{
(( Par_A
Ceci est un 1er grand paragraphe...
ayant pour classe CSS Par_A
(( Par_AA
Ceci est un sous-paragraphe...
ayant pour classe CSS Par_AA
))
))
(( Par_B
Ceci est un 2nd grand paragraphes...
ayant pour classe CSS PAR_B
))
}}

20
website_doc/article/redac_titres.html → src/usr/share/tyto/docs/www/article/redac_titres.html
View File

@ -1,4 +1,4 @@
<!-- Écrire les titres et sous-titres - Tyto - Littérateur (page generated by Tyto - Littérateur) --> <!-- Écrire des titres et sous-titres - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html> <!DocType html>
<html lang="fr"> <html lang="fr">
<head> <head>
@ -13,10 +13,10 @@
<meta name="copyright" content="gfdl-1.3"> <meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article --> <!-- metas generated from article -->
<meta name="title" content="Écrire les titres et sous-titres"> <meta name="title" content="Écrire des titres et sous-titres">
<meta name="author" content="echolib"> <meta name="author" content="echolib">
<meta name="description" content="Comment écrire les titres et les sous-titres pour Tyto - Littérateur"> <meta name="description" content="Comment écrire les titres et les sous-titres pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,rédaction,titres,table des matières"> <meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,rédaction,marqueurs,titres,table des matières">
<!-- metas links to template files --> <!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/redac_titres.html"> <link rel="canonical" href="https://tyto.echolib.re/article/redac_titres.html">
@ -26,15 +26,15 @@
<!-- Open Graph data --> <!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur"> <meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Écrire les titres et sous-titres"> <meta property="og:title" content="Écrire des titres et sous-titres">
<meta property="og:type" content="article"> <meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/redac_titres.html"> <meta property="og:url" content="https://tyto.echolib.re/article/redac_titres.html">
<meta property="og:description" content="Comment écrire les titres et les sous-titres pour Tyto - Littérateur"> <meta property="og:description" content="Comment écrire les titres et les sous-titres pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_titles_toc.png"> <meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_titles_toc.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Écrire les titres et sous-titres (echolib) | Tyto - Littérateur</title> <title>Écrire des titres et sous-titres (echolib) | Tyto - Littérateur</title>
</head> </head>
<body> <body>
@ -46,14 +46,14 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:17:32">
<header id="article_header"> <header id="article_header">
<img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_titles_toc.png" alt="Écrire les titres et sous-titres"> <img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_titles_toc.png" alt="Écrire des titres et sous-titres">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/redac_titres.html" title="Écrire les titres et sous-titres -- echolib, 07/01/2024">Écrire les titres et sous-titres</a> <a role="link" id="article_title_link" href="https://tyto.echolib.re/article/redac_titres.html" title="Écrire des titres et sous-titres -- echolib, 07/01/2024">Écrire des titres et sous-titres</a>
</h1> </h1>
<div id="article_refs"> <div id="article_refs">
echolib, 07/01/2024 [<a id="post_code" class="tyto" href="./redac_titres.tyto" title="Code source : Écrire les titres et sous-titres">Code source</a>] echolib, 07/01/2024 [<a id="post_code" class="tyto" href="./redac_titres.tyto" title="Code source : Écrire des titres et sous-titres">Code source</a>]
</div> </div>
</header> </header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2> <h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>

4
website_doc/article/redac_titres.tyto → src/usr/share/tyto/docs/www/article/redac_titres.tyto
View File

@ -1,7 +1,7 @@
title: Écrire les titres et sous-titres title: Écrire des titres et sous-titres
about: Comment écrire les titres et les sous-titres pour Tyto - Littérateur about: Comment écrire les titres et les sous-titres pour Tyto - Littérateur
date: 2024-01-07 date: 2024-01-07
tags: format .tyto,écrire,rédaction,titres,table des matières tags: rédaction,marqueurs,titres,table des matières
authors: echolib authors: echolib
logo: @logos/tyto_titles_toc.png logo: @logos/tyto_titles_toc.png

258
src/usr/share/tyto/docs/www/config/index.html Normal file
View File

@ -0,0 +1,258 @@
<!-- Créer et configurer un domaine - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Créer et configurer un domaine">
<meta name="author" content="echolib">
<meta name="description" content="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,configuration,domaine">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/config/index.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Créer et configurer un domaine">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/config/index.html">
<meta property="og:description" content="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Créer et configurer un domaine (echolib) | Tyto - Littérateur</title>
</head>
<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="2024-01-17 18:17:32">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/config/index.html" title="Créer et configurer un domaine -- echolib, 05/12/2023">Créer et configurer un domaine</a>
</h1>
<div id="article_refs">
echolib, 05/12/2023 [<a id="post_code" class="tyto" href="./index.tyto" title="Code source : Créer et configurer un domaine">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Créer un domaine</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Les commandes à taper</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Répondre aux questions</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Exemple d'un domaine créé</a></li>
</ul>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Modifier la configuration</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Les valeurs importantes</a></li>
</ul>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Créer un domaine</h2>
<p class="tyto">
<strong class="tyto">Tyto littérateur</strong> fonctionne dans un dossier ayant l'identité d'un nom de
domaine. Il faut qu'il soit au minimum au format "domaine.tld". Vous pouvez
le créer, à l'emplacement de votre choix. Ce dossier est votre
<b class="tyto">dossier de travail</b>. Seulement une fois ce dossier ouvert (dans un
terminal), vous pouvez lancer la procédure de création du domaine afin de
créer votre nouveau site.
</p>
<p class="astuce">
Tyto - Littérateur étant capable de gérer de nombreux domaines, vous pouvez
créer un dossier racine "mes_sites", et créer dedans tous les sous-dossiers
des domaines.
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Les commandes à taper</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># Commande bash pour créer un dossier du domaine</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">mkdir -p domaine.tld</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Se placer dans le dossier créé</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">cd domaine.tld</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Créer et configurer le domaine &quot;domaine.tld&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto new domain </code></li>
</ol></pre>
<h4 role="heading" aria-level="4" id="toc_3" class="tyto">Répondre aux questions</h4>
<p class="tyto">
<a role="link" class="bandeau image" href="/config/tyto_new_domain_form.png"><img class="bandeau image" src="/config/tyto_new_domain_form.png" title="Formulaire lors de la création d'un domaine avec Tyto - Littérateur" alt="Formulaire lors de la création d'un domaine avec Tyto - Littérateur"></a>
<br class="tyto">
Pour configurer le domaine "domaine.tld", Tyto - Littérateur, a besoin de
quelques renseignements concernant ce domaine, et notemment :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">le titre du domaine</li>
<li role="listitem" class="tyto">la date de création (format AAAA ou AAAA-MM ou AAAA-MM-JJ)</li>
<li role="listitem" class="tyto">la description du domaine</li>
<li role="listitem" class="tyto">les étiquettes du domaine (séparées par une virugule)</li>
<li role="listitem" class="tyto">le courriel de l'administrateur</li>
<li role="listitem" class="tyto">la langue du domaine (celle du site web) sur 2 caractères (en, fr...)</li>
<li role="listitem" class="tyto">le dossier du serveur root</li>
</ul>
</p>
<h5 role="heading" aria-level="5" id="toc_4" class="tyto">Exemple d'un domaine créé</h5>
<p class="tyto">
Une fois toutes les questions répondues, le fichier <q class="tyto">tyto_domain.ini</q> est
créé dans le dossier du domaine. Quelques données supplémentaires sont
configurables dans le fichier, qui est au <a role="link" class="tyto" href="https://fr.wikipedia.org/wiki/Fichier_INI" title="Page wikipédia en FR "Fichier INI" ">format INI</a>. Il est plus que
recommandé de l'ouvrir et de <b class="tyto">vérifier son contenu</b>
<strong class="tyto"><u class="tyto">avant de continuer</u></strong>. Vous pouvez le lire avec la commande
<code class="tyto">tyto show domain</code>. Le domaine est désactivé après sa création.
</p>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">[DOMAIN]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">name = tyto.echolib.re</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">work = /home/echolib/Projets/Tyto/websites/tyto.echolib.re/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">activated = True</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">title = Tyto - Littérateur</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">date = 2022</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">about = Documentation officielle du littérateur libre</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tags = Tyto,littérateur,logiciel libre,documentation</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">mail = echolib+tyto@a-lec.org</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[WEBSITE]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">wip_url = https://www-wip.echolib.re/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">www_url = https://tyto.echolib.re/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">css = tyto</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">separator = |</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">article_code = True</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">lang = fr</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">license = gfdl-1.3</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">license_url = https://www.gnu.org/licenses/fdl-1.3.txt</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[WEBSITE_FOOTER]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">link_1 = &quot;Licence : gfdl-1.3&quot;, &quot;https://www.gnu.org/licenses/fdl-1.3.txt&quot;, &quot;Licence du site web de Tyto - Littérateur&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">link_2 = &quot;Mentions légales&quot;, &quot;/&quot;, &quot;Mentions légales de Tyto - Littérateur&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">link_3 = &quot;C.G.U&quot;, &quot;/&quot;, &quot;C.G.U de Tyto - Littérateur&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">link_4 = &quot;Statuts&quot;, &quot;/&quot;, &quot;Statuts de Tyto - Littérateur&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[WEBSITE_MODULES]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">sidebar_title = Articles recommandés</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">sidebar_items = 6</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">rss_items = 100</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">sitemaps = True</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[TEMPLATE_FILENAMES]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">favicon = favicon.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">logo = VH_Tyto_logo.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">styles = styles.css</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">rss = rss.xml</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">stats = tyto_stats.ini</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[SERVER]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">srv_root = /home/echolib/Projets/www/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[TYTO]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">id = 23ac1f4c</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">conf_uri = /home/echolib/Projets/Tyto/websites/tyto.echolib.re/tyto_domain.ini</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">user_uri = /home/echolib/.local/Tyto/23ac1f4c.ini</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_5" class="tyto">Modifier la configuration</h3>
<p class="tyto">
Le fichier <q class="tyto">tyto_domain.ini</q> dispose de catégories, comme [WEBSITE], avec
les paramètres <code class="tyto">clé = valeur</code>. Si vous modifiez une valeur, Tyto vérifiera
et reconstruira à nouveau le fichier. Les pages du site étant statiques, dans
certains cas, il faudra toutes les reconstruire. Si les modifications
concernent la catégorie [WEBSITE_FOOTER], seul le pied de page devra être
reconstruit.
</p>
<h4 role="heading" aria-level="4" id="toc_6" class="tyto">Les valeurs importantes</h4>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">[DOMAIN]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Remplacer par True pour activer</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># ou utiliser la commande tyto start / tyto stop</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">activated = False</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[WEBSITE]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># L&apos;adresse (URL) du site web temporaire (wip)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">wip_url = https://www-wip.domaine.tld/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># L&apos;adresse (URL) du site officiel (publish)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">www_url = https://domaine.tld/</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># La classe CSS par défaut</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">css = tyto</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Le séparateur entre le titre de la page et le titre du site</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># dans la balise HTML &lt;title&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">separator = -</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Valeur booléane True/False (Oui/Non)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Afficher le lien vers le code source de l&apos;article</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">article_code = False</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Langue des pages du site</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># La traduction doit exister (fournies: en, fr)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">lang = fr</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[WEBSITE_MODULES]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Le nom de la barre latérale</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">sidebar_title = Articles recommandés</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Nombre d&apos;articles dans la barre latérale (0 pour désactiver)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">sidebar_items = 6</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Nombre d&apos;articles dans le flux RSS (0 pour désactiver)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">rss_items = 100</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Création automatique du sitemap (sitemap.html)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">sitemaps = True</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[WEBSITE_FOOTER]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Les liens du pied de page dans [WEBSITE_FOOTER]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># les clés link_1 à link_4 sont créés automatiquement</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Pour désactiver, enlever la valeur, laisser la clé !</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Format de clé</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># l&apos;URL peut être locale. Ex : &quot;/about/cgu.html&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">clé = &quot;Nom à afficher&quot;, &quot;URL&quot;, &quot;Contenu de title=&quot;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">[TEMPLATE_FILENAMES]</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Nom des fichiers</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># (à ajouter dans le dossier .../wip/template/)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">favicon = favicon.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">logo = logo.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">styles = styles.css</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

192
src/usr/share/tyto/docs/www/config/index.tyto Normal file
View File

@ -0,0 +1,192 @@
title: Créer et configurer un domaine
about: Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur
tags: configuration,domaine
date: 2023-12-05
authors: echolib
link: format INI
https://fr.wikipedia.org/wiki/Fichier_INI
Page wikipédia en FR "Fichier INI"
image: domain-form
tyto_new_domain_form.png
Formulaire lors de la création d'un domaine avec Tyto - Littérateur
-------------------------------------------------------------------------------
! TOC
#1 Créer un domaine
((
*`Tyto littérateur`* fonctionne dans un dossier ayant l'identité d'un nom de
domaine. Il faut qu'il soit au minimum au format "domaine.tld". Vous pouvez
le créer, à l'emplacement de votre choix. Ce dossier est votre
+`dossier de travail`+. Seulement une fois ce dossier ouvert (dans un
terminal), vous pouvez lancer la procédure de création du domaine afin de
créer votre nouveau site.
))
(( astuce
Tyto - Littérateur étant capable de gérer de nombreux domaines, vous pouvez
créer un dossier racine "mes_sites", et créer dedans tous les sous-dossiers
des domaines.
))
#2 Les commandes à taper
{{
# Commande bash pour créer un dossier du domaine
mkdir -p domaine.tld
# Se placer dans le dossier créé
cd domaine.tld
# Créer et configurer le domaine "domaine.tld"
tyto new domain
}}
#3 Répondre aux questions
((
::domain-form "c=bandeau",
|
Pour configurer le domaine "domaine.tld", Tyto - Littérateur, a besoin de
quelques renseignements concernant ce domaine, et notemment :
(=
= le titre du domaine
= la date de création (format AAAA ou AAAA-MM ou AAAA-MM-JJ)
= la description du domaine
= les étiquettes du domaine (séparées par une virugule)
= le courriel de l'administrateur
= la langue du domaine (celle du site web) sur 2 caractères (en, fr...)
= le dossier du serveur root
)=
))
#4 Exemple d'un domaine créé
((
Une fois toutes les questions répondues, le fichier [`tyto_domain.ini`] est
créé dans le dossier du domaine. Quelques données supplémentaires sont
configurables dans le fichier, qui est au ::format INI. Il est plus que
recommandé de l'ouvrir et de +`vérifier son contenu`+
*`&_`avant de continuer`_&`*. Vous pouvez le lire avec la commande
{`tyto show domain`}. Le domaine est désactivé après sa création.
))
{{
[DOMAIN]
name = tyto.echolib.re
work = /home/echolib/Projets/Tyto/websites/tyto.echolib.re/
activated = True
title = Tyto - Littérateur
date = 2022
about = Documentation officielle du littérateur libre
tags = Tyto,littérateur,logiciel libre,documentation
mail = echolib+tyto@a-lec.org
[WEBSITE]
wip_url = https://www-wip.echolib.re/
www_url = https://tyto.echolib.re/
css = tyto
separator = |
article_code = True
lang = fr
license = gfdl-1.3
license_url = https://www.gnu.org/licenses/fdl-1.3.txt
[WEBSITE_FOOTER]
link_1 = "Licence : gfdl-1.3", "https://www.gnu.org/licenses/fdl-1.3.txt", "Licence du site web de Tyto - Littérateur"
link_2 = "Mentions légales", "/", "Mentions légales de Tyto - Littérateur"
link_3 = "C.G.U", "/", "C.G.U de Tyto - Littérateur"
link_4 = "Statuts", "/", "Statuts de Tyto - Littérateur"
[WEBSITE_MODULES]
sidebar_title = Articles recommandés
sidebar_items = 6
rss_items = 100
sitemaps = True
[TEMPLATE_FILENAMES]
favicon = favicon.png
logo = VH_Tyto_logo.png
styles = styles.css
rss = rss.xml
stats = tyto_stats.ini
[SERVER]
srv_root = /home/echolib/Projets/www/
[TYTO]
id = 23ac1f4c
conf_uri = /home/echolib/Projets/Tyto/websites/tyto.echolib.re/tyto_domain.ini
user_uri = /home/echolib/.local/Tyto/23ac1f4c.ini
}}
#2 Modifier la configuration
((
Le fichier [`tyto_domain.ini`] dispose de catégories, comme [WEBSITE], avec
les paramètres {`clé = valeur`}. Si vous modifiez une valeur, Tyto vérifiera
et reconstruira à nouveau le fichier. Les pages du site étant statiques, dans
certains cas, il faudra toutes les reconstruire. Si les modifications
concernent la catégorie [WEBSITE_FOOTER], seul le pied de page devra être
reconstruit.
))
#3 Les valeurs importantes
{{
[DOMAIN]
# Remplacer par True pour activer
# ou utiliser la commande tyto start / tyto stop
activated = False
[WEBSITE]
# L'adresse (URL) du site web temporaire (wip)
wip_url = https://www-wip.domaine.tld/
# L'adresse (URL) du site officiel (publish)
www_url = https://domaine.tld/
# La classe CSS par défaut
css = tyto
# Le séparateur entre le titre de la page et le titre du site
# dans la balise HTML <title>
separator = -
# Valeur booléane True/False (Oui/Non)
# Afficher le lien vers le code source de l'article
article_code = False
# Langue des pages du site
# La traduction doit exister (fournies: en, fr)
lang = fr
[WEBSITE_MODULES]
# Le nom de la barre latérale
sidebar_title = Articles recommandés
# Nombre d'articles dans la barre latérale (0 pour désactiver)
sidebar_items = 6
# Nombre d'articles dans le flux RSS (0 pour désactiver)
rss_items = 100
# Création automatique du sitemap (sitemap.html)
sitemaps = True
[WEBSITE_FOOTER]
# Les liens du pied de page dans [WEBSITE_FOOTER]
# les clés link_1 à link_4 sont créés automatiquement
# Pour désactiver, enlever la valeur, laisser la clé !
# Format de clé
# l'URL peut être locale. Ex : "/about/cgu.html"
clé = "Nom à afficher", "URL", "Contenu de title="
[TEMPLATE_FILENAMES]
# Nom des fichiers
# (à ajouter dans le dossier .../wip/template/)
favicon = favicon.png
logo = logo.png
styles = styles.css
}}

BIN
src/usr/share/tyto/docs/www/config/tyto_new_domain_form.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 53 KiB

0
website_doc/images/logos/format_tyto.png → src/usr/share/tyto/docs/www/images/logos/format_tyto.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 2.2 KiB

After

Width:  |  Height:  |  Size: 2.2 KiB

0
website_doc/images/logos/justice_scales_cc0.png → src/usr/share/tyto/docs/www/images/logos/justice_scales_cc0.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 8.6 KiB

After

Width:  |  Height:  |  Size: 8.6 KiB

0
website_doc/images/logos/tyto_5_metas.png → src/usr/share/tyto/docs/www/images/logos/tyto_5_metas.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 7.2 KiB

After

Width:  |  Height:  |  Size: 7.2 KiB

0
website_doc/images/logos/tyto_titles_toc.png → src/usr/share/tyto/docs/www/images/logos/tyto_titles_toc.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 6.1 KiB

After

Width:  |  Height:  |  Size: 6.1 KiB

0
website_doc/images/logos/tyto_welcome.png → src/usr/share/tyto/docs/www/images/logos/tyto_welcome.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 8.2 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB

11
website_doc/index.html → src/usr/share/tyto/docs/www/index.html
View File

@ -33,7 +33,7 @@
<meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_welcome.png"> <meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_welcome.png">
<!-- Publication date and title --> <!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date"> <meta itemprop="datePublished" content="2024-01-17 18:19:13" id="date">
<title>Bienvenue, librement (echolib) | Tyto - Littérateur</title> <title>Bienvenue, librement (echolib) | Tyto - Littérateur</title>
</head> </head>
@ -46,7 +46,7 @@
<main id="article_sidebar"> <!-- Contains <article> and <aside> --> <main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article"> <article id="article">
<time datetime="2024-01-15 18:28:34"> <time datetime="2024-01-17 18:19:13">
<header id="article_header"> <header id="article_header">
<img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_welcome.png" alt="Bienvenue, librement"> <img id="article_logo" src="https://tyto.echolib.re/images/logos/tyto_welcome.png" alt="Bienvenue, librement">
<h1 role="heading" aria-level="1" id="article_title"> <h1 role="heading" aria-level="1" id="article_title">
@ -71,6 +71,7 @@ par mail ou, de préférence, via <a role="link" class="tyto" href="xmpp://im@ec
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Gestion et personnalisation</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Gestion et personnalisation</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Utilisation</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Utilisation</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Traductions</a></li> <li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Traductions</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Pour commencer</a></li>
</ul> </ul>
</nav> </nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le projet</h2> <h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le projet</h2>
@ -125,6 +126,12 @@ utilisée par le système, mais chaque site peut utiliser l'une ou l'autre,
via la configuration du domaine. Il est aussi assez facile de rajouter via la configuration du domaine. Il est aussi assez facile de rajouter
des langues supplémentaires. des langues supplémentaires.
</p> </p>
<h2 role="heading" aria-level="2" id="toc_6" class="tyto">Pour commencer</h2>
<ol role="list" class="tyto">
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./config/index.html" title="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur">Configurer un domaine</a></li>
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./article/index.html" title="Comment écrire un article pour Tyto - Littérateur">Écrire un article</a></li>
<li role="listitem" class="tyto"><a role="link" class="tyto" href="./modules/index.html" title="Comment gérer les modules (nginx) de Tyto - Littérateur">Configurer les modules</a></li>
</ol>
</time> </time>
</article> </article>

20
website_doc/index.tyto → src/usr/share/tyto/docs/www/index.tyto
View File

@ -13,6 +13,18 @@ link: chouette effraie
https://fr.wikipedia.org/wiki/Chouette_effraie https://fr.wikipedia.org/wiki/Chouette_effraie
Tyto alba • Effraie des clochers Tyto alba • Effraie des clochers
link: Configurer un domaine
./config/index.html
Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur
link: Écrire un article
./article/index.html
Comment écrire un article pour Tyto - Littérateur
link: Configurer les modules
./modules/index.html
Comment gérer les modules (nginx) de Tyto - Littérateur
! LOGO ! LOGO
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
@ -87,3 +99,11 @@ link: chouette effraie
via la configuration du domaine. Il est aussi assez facile de rajouter via la configuration du domaine. Il est aussi assez facile de rajouter
des langues supplémentaires. des langues supplémentaires.
)) ))
#1 Pour commencer
(=
+ ::Configurer un domaine
+ ::Écrire un article
+ ::Configurer les modules
)=

276
src/usr/share/tyto/docs/www/modules/index.html Normal file
View File

@ -0,0 +1,276 @@
<!-- Gérer les modules dans les pages - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Gérer les modules dans les pages">
<meta name="author" content="echolib">
<meta name="description" content="Comment gérer les modules (nginx) de Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,modules,nginx,metas,header,navbar,sidebar,footer">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/modules/index.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Gérer les modules dans les pages">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/modules/index.html">
<meta property="og:description" content="Comment gérer les modules (nginx) de Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-17 18:17:32" id="date">
<title>Gérer les modules dans les pages (echolib) | Tyto - Littérateur</title>
</head>
<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="2024-01-17 18:17:32">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/modules/index.html" title="Gérer les modules dans les pages -- echolib, 18/12/2023">Gérer les modules dans les pages</a>
</h1>
<div id="article_refs">
echolib, 18/12/2023 [<a id="post_code" class="tyto" href="./index.tyto" title="Code source : Gérer les modules dans les pages">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Définitions des modules</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Le module "metas"</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Exemple HTML des metas</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Le module "header"</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Exemple HTML d'une entête</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Le module "navbar"</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_7">Exemple HTML d'un menu</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_8">Le module "sidebar"</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_9">Exemple HTML d'une barre latérale</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_10">Le module "footer"</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_11">Exemple HTML de pied de page</a></li>
</ul>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_12">Forcer une nouvelle génération des modules HTML</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_13">Afficher les modules dans les pages avec nginx</a></li>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Définitions des modules</h2>
<p class="tyto">
<strong class="tyto">Tyto - Littérateur</strong> intègre dans chaque page du site, différents modules.
Ils sont créés automatiquement lors du 1er "wip" d'un article, ou si le
contenu du fichier de configuration du module a changé. Vous pouvez les gérer,
et modifier leurs contenus grâce aux fichiers ".../modules/[module].raw"
dans le dossier de travail du domaine. Chaque fichier dispose d'une petite
aide explicative, et de rappel d'URIs dans son entête. Vous pouvez forcer
la génération d'un module avec la commande <code class="tyto">tyto wip [module_name]</code>
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Le module "metas"</h3>
<p class="tyto">
Le module "metas", issu du fichier de configuration "metas.raw" insère des
balises HTML <code class="tyto">&lt;meta&gt;</code>, prioritaires. Les balises utilisées par défaut :
</p>
<h4 role="heading" aria-level="4" id="toc_3" class="tyto">Exemple HTML des metas</h4>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;meta charset=&quot;UTF-8&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;meta name=&quot;robots&quot; content=&quot;all&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;meta name=&quot;medium&quot; content=&quot;website&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;meta name=&quot;revisit-after&quot; content=&quot;3 days&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot;&gt;</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_4" class="tyto">Le module "header"</h3>
<p class="tyto">
Le module "header", issu du fichier de configuration "header.raw" insère
<b class="tyto">l'entête</b> HTML dans les pages du site. Son contenu dépend de la
::configuration du domaine. Voici un exemple de sa structure HTML et des
identificateurs CSS :
</p>
<h4 role="heading" aria-level="4" id="toc_5" class="tyto">Exemple HTML d'une entête</h4>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;a role=&quot;link&quot; id=&quot;site_link&quot; href=&quot;/&quot; title=&quot;%s&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;header id=&quot;header&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;header_logo&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;img id=&quot;header_logo_image&quot; src=&quot;%s&quot; alt=&quot;%s&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt; </code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;header_abouts&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;p id=&quot;header_title&quot;&gt;%s&lt;/p&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;p id=&quot;header_about&quot;&gt;%s&lt;/p&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt; </code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/header&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/a&gt;</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_6" class="tyto">Le module "navbar"</h3>
<p class="tyto">
Le module "navbar" issu du fichier de configuration "navbar.raw" insère
la <b class="tyto">barre de manu</b> principale, libellée pour l'accessibilité, "navigation-1".
Son contenu par défaut est vide.
</p>
<p class="tyto">
Pour ajouter un onglet au menu du site :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">créer un dossier dans le dossier de travail du domaine ".../articles/"</li>
<li role="listitem" class="tyto">créer un article "index.tyto" dans le nouveau dossier </li>
<li role="listitem" class="tyto">créer l'article HTML via la commande "wip"</li>
<li role="listitem" class="tyto">éditer le fichier navbar.raw, en ajoutant le nom du nouveau dossier</li>
</ul>
</p>
<h4 role="heading" aria-level="4" id="toc_7" class="tyto">Exemple HTML d'un menu</h4>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;nav id=&quot;menu&quot; aria-labelledby=&quot;navigation-1&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;menu role=&quot;menu&quot; id=&quot;menu_items&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;menuitem&quot; class=&quot;menu_item&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;a role=&quot;link&quot; class=&quot;menu_link&quot; href=&quot;%s&quot; title=&quot;%s&quot;&gt;%s&lt;/a&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/menu&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/nav&gt;</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_8" class="tyto">Le module "sidebar"</h3>
<p class="tyto">
Le module "sidebar" issu du fichier de configuration "sidebar.raw" insère
la <em class="tyto">barre latérale</em> contenant des articles à mettre en avant. Son contenu
par défaut est vide. Le nombre d'articles maximum est 6 par défaut, dans la
::configuration du domaine. La barre latérale est libéllée pour
l'accessibilité "navigation-2"
</p>
<p class="tyto">
Pour ajouter un article à la barre latérale :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">créer un article .tyto</li>
<li role="listitem" class="tyto">créer l'article HTML via la commande "wip"</li>
<li role="listitem" class="tyto">éditer le fichier sidebar.raw en ajoutant l'URI de l'article (URI depuis le dossier de travail du domaine ".../article/")</li>
</ul>
</p>
<h4 role="heading" aria-level="4" id="toc_9" class="tyto">Exemple HTML d'une barre latérale</h4>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;aside id=&quot;sidebar&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;sidebar_title&quot;&gt;%s&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;nav role=&quot;navigation&quot; id=&quot;sidebar_menu&quot; aria-labelledby=&quot;navigation-2&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;ul role=&quot;list&quot; id=&quot;sidebar_items&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;sidebar_item&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div class=&quot;sidebar_post_title&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;a role=&quot;link&quot; class=&quot;sidebar_post_link&quot; href=&quot;%s&quot;&gt;%s&lt;/a&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div class=&quot;sidebar_post_about&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;p class=&quot;sidebar_post_about_p&quot; title=&quot;%s -- %s, %s&quot;&gt;%s&lt;/p&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/ul&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/nav&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/aside&gt;</code></li>
</ol></pre>
<h3 role="heading" aria-level="3" id="toc_10" class="tyto">Le module "footer"</h3>
<p class="tyto">
Le module "footer" issu du fichier de configuration "footer.raw" insère le
<b class="tyto">pied de page</b> HTML dans les pages du site. Son contenu dépend de la
::configuration du domaine. Un menu de navigation, libellé pour
l'accessibilité "navigation-3", est créé automatiquement.
</p>
<h4 role="heading" aria-level="4" id="toc_11" class="tyto">Exemple HTML de pied de page</h4>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;footer id=&quot;footer&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;footer_title&quot;&gt;%s &lt;strong&gt;%s&lt;/strong&gt;&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;footer_about_menu&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;footer_about&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">%s</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;nav id=&quot;footer_menu&quot; aria-labelledby=&quot;navigation-3&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;ul role=&quot;list&quot; id=&quot;footer_items&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;li role=&quot;listitem&quot; class=&quot;footer_item&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;a role=&quot;link&quot; class=&quot;footer_item_link&quot; href=&quot;%s&quot; title=&quot;%s %s&quot;&gt;%s&lt;/a&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/li&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/ul&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/nav&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;div id=&quot;footer_credit&quot;&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;p id=&quot;footer_copyright&quot;&gt;%s&lt;/p&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;p id=&quot;footer_tyto&quot;&gt;%s&lt;/p&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/div&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">&lt;/footer&gt;</code></li>
</ol></pre>
<h2 role="heading" aria-level="2" id="toc_12" class="tyto">Forcer une nouvelle génération des modules HTML</h2>
<p class="tyto">
Même si un module a déjà été généré, si vous avez besoin de forcer une
nouvelle génération de modules, il suffit de le demander, via l'action "wip".
<br class="tyto">
Les modules HTML se trouvent dans le dossier du serveur "...wip/template/"
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto wip modules # Créer TOUS les modules HTML</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto wip metas # Créer le module metas.html</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto wip header # Créer le module header.html</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto wip navbar # Créer le module navbar.html</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto wip sidebar # Créer le module sidebar.html</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tyto wip footer # Créer le module footer.html</code></li>
</ol></pre>
</p>
<p class="note">
Vous pouvez forcer la création d'un module HTML, mais, si le fichier de
configuration a été modifié, il sera automatiquement mis à jour à la
prochaine création d'un article via la commande "wip". Il faut toutefois
forcer la génération, si une <a role="link" class="tyto" href="../article/metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur">métadonnée indispensable</a> d'un article se
trouvant dans le module, a été modifiée
</p>
<h2 role="heading" aria-level="2" id="toc_13" class="tyto">Afficher les modules dans les pages avec nginx</h2>
<p class="tyto">
Même si les pages du site sont statiques, les modules doivent être appelés
par le serveur. Nginx dispose d'une configuration qui lui permet d'insérer
le contenu d'un fichier dans une page. L'action se déclenche lorsqu'un
commentaire HTML conttient <code class="tyto"># include_virtual=&quot;&quot;</code>. Dans la configuration
du serveur nginx, il faut ajouter :
</p>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">ssi on;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">ssi_last_modified on;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">absolute_redirect off;</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

201
src/usr/share/tyto/docs/www/modules/index.tyto Normal file
View File

@ -0,0 +1,201 @@
title: Gérer les modules dans les pages
about: Comment gérer les modules (nginx) de Tyto - Littérateur
date: 2023-12-18
tags: modules,nginx,metas,header,navbar,sidebar,footer
authors: echolib
link: configuration du domaine
../config/index.html
Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur
link: métadonnée indispensable
../article/metas_obligatoires.html
Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur
-------------------------------------------------------------------------------
! TOC
#1 Définitions des modules
((
*`Tyto - Littérateur`* intègre dans chaque page du site, différents modules.
Ils sont créés automatiquement lors du 1er "wip" d'un article, ou si le
contenu du fichier de configuration du module a changé. Vous pouvez les gérer,
et modifier leurs contenus grâce aux fichiers ".../modules/[module].raw"
dans le dossier de travail du domaine. Chaque fichier dispose d'une petite
aide explicative, et de rappel d'URIs dans son entête. Vous pouvez forcer
la génération d'un module avec la commande {` tyto wip [module_name]`}
))
#2 Le module "metas"
((
Le module "metas", issu du fichier de configuration "metas.raw" insère des
balises HTML {`<meta>`}, prioritaires. Les balises utilisées par défaut :
))
#3 Exemple HTML des metas
{{
<meta charset="UTF-8">
<meta name="robots" content="all">
<meta name="medium" content="website">
<meta name="revisit-after" content="3 days">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
}}
#2 Le module "header"
((
Le module "header", issu du fichier de configuration "header.raw" insère
+`l'entête`+ HTML dans les pages du site. Son contenu dépend de la
::configuration du domaine. Voici un exemple de sa structure HTML et des
identificateurs CSS :
))
#3 Exemple HTML d'une entête
{{
<a role="link" id="site_link" href="/" title="%s">
<header id="header">
<div id="header_logo">
<img id="header_logo_image" src="%s" alt="%s">
</div>
<div id="header_abouts">
<p id="header_title">%s</p>
<p id="header_about">%s</p>
</div>
</header>
</a>
}}
#2 Le module "navbar"
((
Le module "navbar" issu du fichier de configuration "navbar.raw" insère
la +`barre de manu`+ principale, libellée pour l'accessibilité, "navigation-1".
Son contenu par défaut est vide.
))
((
Pour ajouter un onglet au menu du site :
(=
= créer un dossier dans le dossier de travail du domaine ".../articles/"
= créer un article "index.tyto" dans le nouveau dossier
= créer l'article HTML via la commande "wip"
= éditer le fichier navbar.raw, en ajoutant le nom du nouveau dossier
)=
))
#3 Exemple HTML d'un menu
{{
<nav id="menu" aria-labelledby="navigation-1">
<menu role="menu" id="menu_items">
<li role="menuitem" class="menu_item">
<a role="link" class="menu_link" href="%s" title="%s">%s</a>
</li>
</menu>
</nav>
}}
#2 Le module "sidebar"
((
Le module "sidebar" issu du fichier de configuration "sidebar.raw" insère
la /`barre latérale`/ contenant des articles à mettre en avant. Son contenu
par défaut est vide. Le nombre d'articles maximum est 6 par défaut, dans la
::configuration du domaine. La barre latérale est libéllée pour
l'accessibilité "navigation-2"
))
((
Pour ajouter un article à la barre latérale :
(=
= créer un article .tyto
= créer l'article HTML via la commande "wip"
= éditer le fichier sidebar.raw en ajoutant l'URI de l'article
(URI depuis le dossier de travail du domaine ".../article/")
)=
))
#3 Exemple HTML d'une barre latérale
{{
<aside id="sidebar">
<div id="sidebar_title">%s</div>
<nav role="navigation" id="sidebar_menu" aria-labelledby="navigation-2">
<ul role="list" id="sidebar_items">
<li role="listitem" class="sidebar_item">
<div class="sidebar_post_title">
<a role="link" class="sidebar_post_link" href="%s">%s</a>
</div>
<div class="sidebar_post_about">
<p class="sidebar_post_about_p" title="%s -- %s, %s">%s</p>
</div>
</li>
</ul>
</nav>
</aside>
}}
#2 Le module "footer"
((
Le module "footer" issu du fichier de configuration "footer.raw" insère le
+`pied de page`+ HTML dans les pages du site. Son contenu dépend de la
::configuration du domaine. Un menu de navigation, libellé pour
l'accessibilité "navigation-3", est créé automatiquement.
))
#3 Exemple HTML de pied de page
{{
<footer id="footer">
<div id="footer_title">%s <strong>%s</strong></div>
<div id="footer_about_menu">
<div id="footer_about">
%s
</div>
<nav id="footer_menu" aria-labelledby="navigation-3">
<ul role="list" id="footer_items">
<li role="listitem" class="footer_item">
<a role="link" class="footer_item_link" href="%s" title="%s %s">%s</a>
</li>
</ul>
</nav>
</div>
<div id="footer_credit">
<p id="footer_copyright">%s</p>
<p id="footer_tyto">%s</p>
</div>
</footer>
}}
#1 Forcer une nouvelle génération des modules HTML
((
Même si un module a déjà été généré, si vous avez besoin de forcer une
nouvelle génération de modules, il suffit de le demander, via l'action "wip".
|
Les modules HTML se trouvent dans le dossier du serveur "...wip/template/"
{{
tyto wip modules # Créer TOUS les modules HTML
tyto wip metas # Créer le module metas.html
tyto wip header # Créer le module header.html
tyto wip navbar # Créer le module navbar.html
tyto wip sidebar # Créer le module sidebar.html
tyto wip footer # Créer le module footer.html
}}
))
(( note
Vous pouvez forcer la création d'un module HTML, mais, si le fichier de
configuration a été modifié, il sera automatiquement mis à jour à la
prochaine création d'un article via la commande "wip". Il faut toutefois
forcer la génération, si une ::métadonnée indispensable d'un article se
trouvant dans le module, a été modifiée
))
#1 Afficher les modules dans les pages avec nginx
((
Même si les pages du site sont statiques, les modules doivent être appelés
par le serveur. Nginx dispose d'une configuration qui lui permet d'insérer
le contenu d'un fichier dans une page. L'action se déclenche lorsqu'un
commentaire HTML conttient {`# include_virtual=""`}. Dans la configuration
du serveur nginx, il faut ajouter :
))
{{
ssi on;
ssi_last_modified on;
absolute_redirect off;
}}

274
website_doc/rss.xml → src/usr/share/tyto/docs/www/rss.xml
View File

@ -3,7 +3,7 @@
<!-- #==========================================# --> <!-- #==========================================# -->
<!-- # RSS/Feed generated by Tyto - Littérateur # --> <!-- # RSS/Feed generated by Tyto - Littérateur # -->
<!-- #==========================================# --> <!-- #==========================================# -->
<!-- Creation date: Mon, 15 Jan 2024 18:28:34 --> <!-- Creation date: Wed, 17 Jan 2024 18:19:13 -->
<!-- Feed URL: https://tyto.echolib.re/rss.xmlrss.xml --> <!-- Feed URL: https://tyto.echolib.re/rss.xmlrss.xml -->
@ -20,118 +20,13 @@
</image> </image>
<language>fr</language> <language>fr</language>
<category>Tyto,littérateur,logiciel libre,documentation</category> <category>Tyto,littérateur,logiciel libre,documentation</category>
<lastBuildDate>Mon, 15 Jan 2024 18:28:34</lastBuildDate> <lastBuildDate>Wed, 17 Jan 2024 18:19:13</lastBuildDate>
<copyright>gfdl-1.3</copyright> <copyright>gfdl-1.3</copyright>
<webMaster>echolib+tyto@a-lec.org</webMaster> <webMaster>echolib+tyto@a-lec.org</webMaster>
<generator>Tyto - Littérateur</generator> <generator>Tyto - Littérateur</generator>
<!-- Articles ordred by last update --> <!-- Articles ordred by last update -->
<!-- Item 1/100 --> <!-- Item 1/100 -->
<item>
<title>Écrire les titres et sous-titres</title>
<link>https://tyto.echolib.re/article/redac_titres.html</link>
<guid>https://tyto.echolib.re/article/redac_titres.html</guid>
<pubDate>Sun, 07 Jan 2024</pubDate>
<description>Comment écrire les titres et les sous-titres pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/tyto_titles_toc.png</url>
<title>Écrire les titres et sous-titres (logo)</title>
<link>https://tyto.echolib.re/article/redac_titres.html</link>
</image>
<category>format .tyto,écrire,rédaction,titres,table des matières</category>
</item>
<!-- Item 2/100 -->
<item>
<title>Mentions Légales</title>
<link>https://tyto.echolib.re/a-propos/index.html</link>
<guid>https://tyto.echolib.re/a-propos/index.html</guid>
<pubDate>Sun, 14 Jan 2024</pubDate>
<description>Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/justice_scales_cc0.png</url>
<title>Mentions Légales (logo)</title>
<link>https://tyto.echolib.re/a-propos/index.html</link>
</image>
<category>mentions légales,C.G.U,licence</category>
</item>
<!-- Item 3/100 -->
<item>
<title>Écrire un article au format .tyto</title>
<link>https://tyto.echolib.re/article/index.html</link>
<guid>https://tyto.echolib.re/article/index.html</guid>
<pubDate>Sat, 06 Jan 2024</pubDate>
<description>Page d'index référençant les articles dédiés à l'écriture des marqueurs utilisés par Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/format_tyto.png</url>
<title>Écrire un article au format .tyto (logo)</title>
<link>https://tyto.echolib.re/article/index.html</link>
</image>
<category>format .tyto,écrire,</category>
</item>
<!-- Item 4/100 -->
<item>
<title>Écrire les métadonnées indispensables</title>
<link>https://tyto.echolib.re/article/metas_obligatoires.html</link>
<guid>https://tyto.echolib.re/article/metas_obligatoires.html</guid>
<pubDate>Sat, 06 Jan 2024</pubDate>
<description>Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/tyto_5_metas.png</url>
<title>Écrire les métadonnées indispensables (logo)</title>
<link>https://tyto.echolib.re/article/metas_obligatoires.html</link>
</image>
<category>format .tyto,écrire,métadonnées,entête</category>
</item>
<!-- Item 5/100 -->
<item>
<title>Les URIs spécifiques</title>
<link>https://tyto.echolib.re/article/metas_uris.html</link>
<guid>https://tyto.echolib.re/article/metas_uris.html</guid>
<pubDate>Mon, 08 Jan 2024</pubDate>
<description>Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Les URIs spécifiques (logo)</title>
<link>https://tyto.echolib.re/article/metas_uris.html</link>
</image>
<category>format .tyto,écrire,liens,URIs</category>
</item>
<!-- Item 6/100 -->
<item>
<title>Écrire/créer des liens</title>
<link>https://tyto.echolib.re/article/metas_liens.html</link>
<guid>https://tyto.echolib.re/article/metas_liens.html</guid>
<pubDate>Mon, 08 Jan 2024</pubDate>
<description>Comment écrire des liens pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Écrire/créer des liens (logo)</title>
<link>https://tyto.echolib.re/article/metas_liens.html</link>
</image>
<category>format .tyto,écrire,liens</category>
</item>
<!-- Item 7/100 -->
<item>
<title>Page non trouvée</title>
<link>https://tyto.echolib.re/404.html</link>
<guid>https://tyto.echolib.re/404.html</guid>
<pubDate>Sat, 13 Jan 2024</pubDate>
<description>Page d'erreur 404, indiquant que la page demandée n'existe pas/plus</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Page non trouvée (logo)</title>
<link>https://tyto.echolib.re/404.html</link>
</image>
<category>404,erreur</category>
</item>
<!-- Item 8/100 -->
<item> <item>
<title>Bienvenue, librement</title> <title>Bienvenue, librement</title>
<link>https://tyto.echolib.re/index.html</link> <link>https://tyto.echolib.re/index.html</link>
@ -146,6 +41,171 @@
</image> </image>
<category>accueil,projet,description</category> <category>accueil,projet,description</category>
</item> </item>
<!-- Item 2/100 -->
<item>
<title>Afficher du code en bloc</title>
<link>https://tyto.echolib.re/article/redac_blockcodes.html</link>
<guid>https://tyto.echolib.re/article/redac_blockcodes.html</guid>
<pubDate>Tue, 16 Jan 2024</pubDate>
<description>Comment afficher du code en bloc pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Afficher du code en bloc (logo)</title>
<link>https://tyto.echolib.re/article/redac_blockcodes.html</link>
</image>
<category>rédaction,marqueurs,blockcode</category>
</item>
<!-- Item 3/100 -->
<item>
<title>Les URIs spécifiques</title>
<link>https://tyto.echolib.re/article/metas_uris.html</link>
<guid>https://tyto.echolib.re/article/metas_uris.html</guid>
<pubDate>Mon, 08 Jan 2024</pubDate>
<description>Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Les URIs spécifiques (logo)</title>
<link>https://tyto.echolib.re/article/metas_uris.html</link>
</image>
<category>format .tyto,écrire,liens,URIs</category>
</item>
<!-- Item 4/100 -->
<item>
<title>Créer des liens</title>
<link>https://tyto.echolib.re/article/metas_liens.html</link>
<guid>https://tyto.echolib.re/article/metas_liens.html</guid>
<pubDate>Mon, 08 Jan 2024</pubDate>
<description>Comment écrire des liens pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Créer des liens (logo)</title>
<link>https://tyto.echolib.re/article/metas_liens.html</link>
</image>
<category>format .tyto,écrire,liens</category>
</item>
<!-- Item 5/100 -->
<item>
<title>Écrire les métadonnées indispensables</title>
<link>https://tyto.echolib.re/article/metas_obligatoires.html</link>
<guid>https://tyto.echolib.re/article/metas_obligatoires.html</guid>
<pubDate>Sat, 06 Jan 2024</pubDate>
<description>Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/tyto_5_metas.png</url>
<title>Écrire les métadonnées indispensables (logo)</title>
<link>https://tyto.echolib.re/article/metas_obligatoires.html</link>
</image>
<category>format .tyto,écrire,métadonnées,entête</category>
</item>
<!-- Item 6/100 -->
<item>
<title>Écrire des paragraphes</title>
<link>https://tyto.echolib.re/article/redac_paragraphes.html</link>
<guid>https://tyto.echolib.re/article/redac_paragraphes.html</guid>
<pubDate>Tue, 05 Dec 2023</pubDate>
<description>Comment écrire des paragraphes pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Écrire des paragraphes (logo)</title>
<link>https://tyto.echolib.re/article/redac_paragraphes.html</link>
</image>
<category>rédaction,marqueurs,paragraphes</category>
</item>
<!-- Item 7/100 -->
<item>
<title>Mentions Légales</title>
<link>https://tyto.echolib.re/a-propos/index.html</link>
<guid>https://tyto.echolib.re/a-propos/index.html</guid>
<pubDate>Sun, 14 Jan 2024</pubDate>
<description>Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/justice_scales_cc0.png</url>
<title>Mentions Légales (logo)</title>
<link>https://tyto.echolib.re/a-propos/index.html</link>
</image>
<category>mentions légales,C.G.U,licence</category>
</item>
<!-- Item 8/100 -->
<item>
<title>Écrire des titres et sous-titres</title>
<link>https://tyto.echolib.re/article/redac_titres.html</link>
<guid>https://tyto.echolib.re/article/redac_titres.html</guid>
<pubDate>Sun, 07 Jan 2024</pubDate>
<description>Comment écrire les titres et les sous-titres pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/tyto_titles_toc.png</url>
<title>Écrire des titres et sous-titres (logo)</title>
<link>https://tyto.echolib.re/article/redac_titres.html</link>
</image>
<category>rédaction,marqueurs,titres,table des matières</category>
</item>
<!-- Item 9/100 -->
<item>
<title>Écrire un article au format .tyto</title>
<link>https://tyto.echolib.re/article/index.html</link>
<guid>https://tyto.echolib.re/article/index.html</guid>
<pubDate>Sat, 06 Jan 2024</pubDate>
<description>Comment écrire un article pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/format_tyto.png</url>
<title>Écrire un article au format .tyto (logo)</title>
<link>https://tyto.echolib.re/article/index.html</link>
</image>
<category>format .tyto,écrire,</category>
</item>
<!-- Item 10/100 -->
<item>
<title>Afficher des images</title>
<link>https://tyto.echolib.re/article/mere_images.html</link>
<guid>https://tyto.echolib.re/article/mere_images.html</guid>
<pubDate>Tue, 05 Dec 2023</pubDate>
<description>Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Afficher des images (logo)</title>
<link>https://tyto.echolib.re/article/mere_images.html</link>
</image>
<category>marqueurs,images</category>
</item>
<!-- Item 11/100 -->
<item>
<title>Gérer les modules dans les pages</title>
<link>https://tyto.echolib.re/modules/index.html</link>
<guid>https://tyto.echolib.re/modules/index.html</guid>
<pubDate>Mon, 18 Dec 2023</pubDate>
<description>Comment gérer les modules (nginx) de Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Gérer les modules dans les pages (logo)</title>
<link>https://tyto.echolib.re/modules/index.html</link>
</image>
<category>modules,nginx,metas,header,navbar,sidebar,footer</category>
</item>
<!-- Item 12/100 -->
<item>
<title>Créer et configurer un domaine</title>
<link>https://tyto.echolib.re/config/index.html</link>
<guid>https://tyto.echolib.re/config/index.html</guid>
<pubDate>Tue, 05 Dec 2023</pubDate>
<description>Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Créer et configurer un domaine (logo)</title>
<link>https://tyto.echolib.re/config/index.html</link>
</image>
<category>configuration,domaine</category>
</item>
</channel> </channel>
</rss> </rss>

89
src/usr/share/tyto/docs/www/sitemap.html Normal file
View File

@ -0,0 +1,89 @@
<!-- Plan du site - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Plan du site">
<meta name="author" content="Tyto">
<meta name="description" content="Plan du site généré par Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,Plan du site">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/sitemap.html">
<link rel="stylesheet" href="./template/styles.css">
<link rel="shortcut icon" type="image/png" href="./template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="./rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Plan du site">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/sitemap.html">
<meta property="og:description" content="Plan du site généré par Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-17 18:19:13" id="date">
<title>Plan du site (Tyto) | Tyto - Littérateur</title>
</head>
<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="2024-01-17 18:19:13">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/sitemap.html" title="Plan du site -- Tyto, 17/01/2024">Plan du site</a>
</h1>
<div id="article_refs">
Tyto, 17/01/2024 [<a id="post_code" class="tyto" href="./sitemap.tyto" title="Code source : Plan du site">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Liste des articles (12)</h2>
<p class="sitemap">
<ol role="list" class="sitemap_items">
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/" title="Page d'accueil de la documentation de Tyto - Littérateur -- echolib, 29/11/2023">Bienvenue, librement</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/redac_blockcodes.html" title="Comment afficher du code en bloc pour Tyto - Littérateur -- echolib, 16/01/2024">Afficher du code en bloc</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur -- echolib, 08/01/2024">Les URIs spécifiques</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/metas_liens.html" title="Comment écrire des liens pour Tyto - Littérateur -- echolib, 08/01/2024">Créer des liens</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur -- echolib, 06/01/2024">Écrire les métadonnées indispensables</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/redac_paragraphes.html" title="Comment écrire des paragraphes pour Tyto - Littérateur -- echolib, 05/12/2023">Écrire des paragraphes</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/a-propos/" title="Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur -- echolib, 14/01/2024">Mentions Légales</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/redac_titres.html" title="Comment écrire les titres et les sous-titres pour Tyto - Littérateur -- echolib, 07/01/2024">Écrire des titres et sous-titres</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/" title="Comment écrire un article pour Tyto - Littérateur -- echolib, 06/01/2024">Écrire un article au format .tyto</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/article/mere_images.html" title="Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur -- echolib, 05/12/2023">Afficher des images</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/modules/" title="Comment gérer les modules (nginx) de Tyto - Littérateur -- echolib, 18/12/2023">Gérer les modules dans les pages</a></li>
<li role="listitem" class="sitemap_items"><a role="link" class="tyto sitemap" href="/config/" title="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur -- echolib, 05/12/2023">Créer et configurer un domaine</a></li>
</ol>
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

29
src/usr/share/tyto/docs/www/sitemap.tyto Normal file
View File

@ -0,0 +1,29 @@
# Tyto - Littérateur
! NOMAP
! NORSS
title: Plan du site
about: Plan du site généré par Tyto - Littérateur
tags: Plan du site
authors: Tyto
date: 2024-01-17
-----
#1 Liste des articles (12)
(( sitemap
(= sitemap_items
+ <a role="link" class="tyto sitemap" href="/" title="Page d'accueil de la documentation de Tyto - Littérateur -- echolib, 29/11/2023">Bienvenue, librement</a>
+ <a role="link" class="tyto sitemap" href="/article/redac_blockcodes.html" title="Comment afficher du code en bloc pour Tyto - Littérateur -- echolib, 16/01/2024">Afficher du code en bloc</a>
+ <a role="link" class="tyto sitemap" href="/article/metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur -- echolib, 08/01/2024">Les URIs spécifiques</a>
+ <a role="link" class="tyto sitemap" href="/article/metas_liens.html" title="Comment écrire des liens pour Tyto - Littérateur -- echolib, 08/01/2024">Créer des liens</a>
+ <a role="link" class="tyto sitemap" href="/article/metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur -- echolib, 06/01/2024">Écrire les métadonnées indispensables</a>
+ <a role="link" class="tyto sitemap" href="/article/redac_paragraphes.html" title="Comment écrire des paragraphes pour Tyto - Littérateur -- echolib, 05/12/2023">Écrire des paragraphes</a>
+ <a role="link" class="tyto sitemap" href="/a-propos/" title="Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur -- echolib, 14/01/2024">Mentions Légales</a>
+ <a role="link" class="tyto sitemap" href="/article/redac_titres.html" title="Comment écrire les titres et les sous-titres pour Tyto - Littérateur -- echolib, 07/01/2024">Écrire des titres et sous-titres</a>
+ <a role="link" class="tyto sitemap" href="/article/" title="Comment écrire un article pour Tyto - Littérateur -- echolib, 06/01/2024">Écrire un article au format .tyto</a>
+ <a role="link" class="tyto sitemap" href="/article/mere_images.html" title="Comment afficher des images et utiliser leurs marqueurs pour Tyto - Littérateur -- echolib, 05/12/2023">Afficher des images</a>
+ <a role="link" class="tyto sitemap" href="/modules/" title="Comment gérer les modules (nginx) de Tyto - Littérateur -- echolib, 18/12/2023">Gérer les modules dans les pages</a>
+ <a role="link" class="tyto sitemap" href="/config/" title="Comment créer un nouveau domaine valide et le configurer avec Tyto - Littérateur -- echolib, 05/12/2023">Créer et configurer un domaine</a>
)=
))

0
website_doc/template/VH_Tyto_logo.png → src/usr/share/tyto/docs/www/template/VH_Tyto_logo.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 86 KiB

After

Width:  |  Height:  |  Size: 86 KiB

0
website_doc/template/favicon.png → src/usr/share/tyto/docs/www/template/favicon.png
View File

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

2
website_doc/template/footer.html → src/usr/share/tyto/docs/www/template/footer.html
View File

@ -12,7 +12,7 @@ en Python par <cite class="tyto">Cyrille Louarn</cite> (<cite class="tyto">echol
</p> </p>
<p class="footer_about_p"> <p class="footer_about_p">
Le code source est composé (hors fichiers de traductions) de 18 fichiers Le code source est composé (hors fichiers de traductions) de 18 fichiers
totalisant 5048 lignes dont 1231 lignes commentées, soit 2851 lignes de scripts. totalisant 5051 lignes dont 1231 lignes commentées, soit 2853 lignes de scripts.
</p> </p>
<p class="footer_about_p"> <p class="footer_about_p">
Tyto - Littérateur (<time datetime="2024-01-15">version 1.11.4</time>) est fait avec amour <3 Tyto - Littérateur (<time datetime="2024-01-15">version 1.11.4</time>) est fait avec amour <3

0
website_doc/template/header.html → src/usr/share/tyto/docs/www/template/header.html
View File

0
website_doc/template/metas.html → src/usr/share/tyto/docs/www/template/metas.html
View File

9
src/usr/share/tyto/docs/www/template/navbar.html Normal file
View File

@ -0,0 +1,9 @@
<!-- navbar from user file configuration: navbar.raw -->
<nav id="menu" aria-labelledby="navigation-1">
<menu role="menu" id="menu_items">
<li role="menuitem" class="menu_item"><a role="link" class="menu_link" href="/config" title="Créer et configurer un domaine">config</a></li>
<li role="menuitem" class="menu_item"><a role="link" class="menu_link" href="/article" title="Écrire un article au format .tyto">article</a></li>
<li role="menuitem" class="menu_item"><a role="link" class="menu_link" href="/modules" title="Gérer les modules dans les pages">modules</a></li>
<li role="menuitem" class="menu_item"><a role="link" class="menu_link" href="/publier" title="Publier un article">publier</a></li>
</menu>
</nav>

0
website_doc/template/sidebar.html → src/usr/share/tyto/docs/www/template/sidebar.html
View File

5
website_doc/template/styles.css → src/usr/share/tyto/docs/www/template/styles.css
View File

@ -166,6 +166,10 @@ h6.tyto {
font-size: 1.2rem; font-size: 1.2rem;
} }
img.bandeau {
max-width: 100%
}
p.alert { p.alert {
color: #FFFDA5; color: #FFFDA5;
font-weight: bold; font-weight: bold;
@ -254,6 +258,7 @@ ul.tyto :is(ol, ul) {
footer#footer { footer#footer {
border-top: 2px dotted gray; border-top: 2px dotted gray;
color: #FFF; color: #FFF;
margin-top: 40px;
} }
div#footer_title { div#footer_title {

85
website_doc/sitemap.html
View File

@ -1,85 +0,0 @@
<!-- Plan du site - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Plan du site">
<meta name="author" content="Tyto">
<meta name="description" content="Plan du site généré par Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,Plan du site">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/sitemap.html">
<link rel="stylesheet" href="./template/styles.css">
<link rel="shortcut icon" type="image/png" href="./template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="./rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Plan du site">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/sitemap.html">
<meta property="og:description" content="Plan du site généré par Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Plan du site (Tyto) | Tyto - Littérateur</title>
</head>
<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="2024-01-15 18:28:34">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/sitemap.html" title="Plan du site -- Tyto, 15/01/2024">Plan du site</a>
</h1>
<div id="article_refs">
Tyto, 15/01/2024 [<a id="post_code" class="tyto" href="./sitemap.tyto" title="Code source : Plan du site">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Liste des articles (8)</h2>
<p class="sitemap">
<ol role="list" class="sitemap_items">
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/article/redac_titres.html" title="Comment écrire les titres et les sous-titres pour Tyto - Littérateur -- echolib, 07/01/2024">Écrire les titres et sous-titres</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/a-propos/" title="Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur -- echolib, 14/01/2024">Mentions Légales</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/article/" title="Page d'index référençant les articles dédiés à l'écriture des marqueurs utilisés par Tyto - Littérateur -- echolib, 06/01/2024">Écrire un article au format .tyto</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/article/metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur -- echolib, 06/01/2024">Écrire les métadonnées indispensables</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/article/metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur -- echolib, 08/01/2024">Les URIs spécifiques</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/article/metas_liens.html" title="Comment écrire des liens pour Tyto - Littérateur -- echolib, 08/01/2024">Écrire/créer des liens</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/404.html" title="Page d'erreur 404, indiquant que la page demandée n'existe pas/plus -- echolib, 13/01/2024">Page non trouvée</a></li>
<li role="listitem" class="sitemap_items"><a class="tyto sitemap" href="/" title="Page d'accueil de la documentation de Tyto - Littérateur -- echolib, 29/11/2023">Bienvenue, librement</a></li>
</ol>
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

25
website_doc/sitemap.tyto
View File

@ -1,25 +0,0 @@
# Tyto - Littérateur
! NOMAP
! NORSS
title: Plan du site
about: Plan du site généré par Tyto - Littérateur
tags: Plan du site
authors: Tyto
date: 2024-01-15
-----
#1 Liste des articles (8)
(( sitemap
(= sitemap_items
+ <a class="tyto sitemap" href="/article/redac_titres.html" title="Comment écrire les titres et les sous-titres pour Tyto - Littérateur -- echolib, 07/01/2024">Écrire les titres et sous-titres</a>
+ <a class="tyto sitemap" href="/a-propos/" title="Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur -- echolib, 14/01/2024">Mentions Légales</a>
+ <a class="tyto sitemap" href="/article/" title="Page d'index référençant les articles dédiés à l'écriture des marqueurs utilisés par Tyto - Littérateur -- echolib, 06/01/2024">Écrire un article au format .tyto</a>
+ <a class="tyto sitemap" href="/article/metas_obligatoires.html" title="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur -- echolib, 06/01/2024">Écrire les métadonnées indispensables</a>
+ <a class="tyto sitemap" href="/article/metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur -- echolib, 08/01/2024">Les URIs spécifiques</a>
+ <a class="tyto sitemap" href="/article/metas_liens.html" title="Comment écrire des liens pour Tyto - Littérateur -- echolib, 08/01/2024">Écrire/créer des liens</a>
+ <a class="tyto sitemap" href="/404.html" title="Page d'erreur 404, indiquant que la page demandée n'existe pas/plus -- echolib, 13/01/2024">Page non trouvée</a>
+ <a class="tyto sitemap" href="/" title="Page d'accueil de la documentation de Tyto - Littérateur -- echolib, 29/11/2023">Bienvenue, librement</a>
)=
))

6
website_doc/template/navbar.html
View File

@ -1,6 +0,0 @@
<!-- navbar from user file configuration: navbar.raw -->
<nav id="menu" aria-labelledby="navigation-1">
<menu role="menu" id="menu_items">
<li role="menuitem" class="menu_item"><a class="menu_link" href="/article" title="Écrire un article au format .tyto">article</a></li>
</menu>
</nav>