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

[1.11.4] + website_doc/

This commit is contained in:
Cyrille L 2024-01-15 18:32:27 +01:00
parent f4468376d9
commit fae86e8ca7
41 changed files with 2343 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
CHANGELOG.md
View File

@ -8,6 +8,10 @@ Tyto - Littérateur
# CURRENTLY IN DEV (in devel branch) !
## [1.11.4]
- small changes when writing domain config in [WEBSITE_FOOTER]
- check: added marker check (default "=", "+")
## [1.11.3]
- Additional HTML code for accessibility

2
debian/control vendored
View File

@ -1,5 +1,5 @@
Package: tyto
Version: 1.11.3
Version: 1.11.4
Section: custom
Priority: optional
Architecture: all

4
src/usr/bin/tyto
View File

@ -1,6 +1,6 @@
#!/usr/bin/env python3
# version: 1.11.3
# date: 2024-01-12 1705078779
# version: 1.11.4
# date: 2024-01-15 1705339348
# Tyto - Littérateur
# Copyright (C) 2023 Cyrille Louarn <echolib+tyto@a-lec.org>

15
src/var/lib/tyto/program/check.py
View File

@ -190,7 +190,9 @@ def header_sl_tags():
try:
datetime.date.fromisoformat(post.needed_tags["date"])
except ValueError:
debug.out(34, "%s. date: %s ? (YYYY-MM-DD)"%(date_ln, post.needed_tags["date"]), post.uri, True, 2, out)
debug.out(34, "%s. date: %s ? (YYYY-MM-DD)"%(
date_ln, post.needed_tags["date"]
), post.uri, True, 2, out)
return False
# Count authors
@ -413,6 +415,15 @@ def block_tags(tag):
line.lstrip().startswith(mark_o):
tag_i = line.index(mark_o[0])
mark_ln = ln
if tag == "lists":
nxt_l = article_writer[ln - stats["file"]["header_lines"]].lstrip()
if not nxt_l.startswith(post.list_marks):
debug.out(33, "%s. List: %s, %s ?"%(
(ln + 1),
post.list_marks[0], post.list_marks[1]
), post.uri, True, 2, out)
return False
# bcode was opened and mark closed here
elif tag_i != -1 and \
@ -451,7 +462,7 @@ def block_tags(tag):
tag_c = False
block_source = ""
# bcode wan NOT closed
# bcode was NOT closed
if tag_i != -1 and not tag_c:
debug.out(37, "%s. %s: '%s' ?"%(
mark_ln, tag, mark_c

8
src/var/lib/tyto/program/domain.py
View File

@ -431,7 +431,7 @@ def cf_update():
cf_set(
"WEBSITE_FOOTER",
"link_1",
'("%s%s %s", "%s", "%s %s")'%(
'"%s%s %s", "%s", "%s %s"'%(
langs.site.license, langs.logs.pp, license,
license_url,
langs.site.license_title, title
@ -440,21 +440,21 @@ def cf_update():
cf_set(
"WEBSITE_FOOTER",
"link_2",
'("%s", "/", "%s %s")'%(
'"%s", "/", "%s %s"'%(
langs.site.legals, langs.site.legals_title, title
), False
)
cf_set(
"WEBSITE_FOOTER",
"link_3",
'("%s", "/", "%s %s")'%(
'"%s", "/", "%s %s"'%(
langs.site.terms, langs.site.terms_title, title
), False
)
cf_set(
"WEBSITE_FOOTER",
"link_4",
'("%s", "/", "%s %s")'%(
'"%s", "/", "%s %s"'%(
langs.site.bylaws, langs.site.bylaws_title, title
), False
)

5
src/var/lib/tyto/program/modules.py
View File

@ -290,6 +290,11 @@ def set_footer_raw(mod):
try:
tupvalues = ast.literal_eval(value)
if not tupvalues[0] or \
not tupvalues[1] or \
not tupvalues[2]:
debug.out(102, "%s = %s"%(key, value), domain.cf_uri, True, 1, False)
continue
footer_menu = footer_menu + \
footer_link%(tupvalues[1], tupvalues[2], "", tupvalues[0])
except:

6
src/var/lib/tyto/program/post.py
View File

@ -170,7 +170,7 @@ def cf_create():
# Set and reset vars (when multiple articles) #
#---------------------------------------------#
def set_default_vars():
global anchors, block_tags, icodes, options_marks
global anchors, block_tags, list_marks, icodes, options_marks
global needed_tags, option_tags, titles
# form NBR : (source, html)
@ -193,6 +193,9 @@ def set_default_vars():
},
}
# markers in list
list_marks = (block_tags["lists"]["marks"][2], block_tags["lists"]["marks"][3])
# Inline codes
icodes = {
"sources" : {}, # {} : {NBR : ("SOURCE", "B64")}
@ -277,4 +280,3 @@ words_tags = {
}
title_marks = ("#1", "#2", "#3", "#4", "#5") # h2 to h6

12
src/var/lib/tyto/program/wip.py
View File

@ -307,7 +307,7 @@ def lists():
# So many THANX neox ! #
# (Not sure, i was able to do it and even not in a so beautiful way) #
#--------------------------------------------------------------------#
def convert_list(markdown_str, mark_ul, mark_c):
def convert_list(markdown_str, mark_ul, mark_ol):
# First step : reshape lines
items = []
inside_item = 0
@ -323,7 +323,7 @@ def convert_list(markdown_str, mark_ul, mark_c):
# = and +
if strlist[i][0] != mark_ul and \
strlist[i][0] != mark_c:
strlist[i][0] != mark_ol:
if inside_item != 1:
inside_item = 1
else:
@ -356,9 +356,9 @@ def convert_list(markdown_str, mark_ul, mark_c):
text = items[i][items[i].find(" "):].lstrip()
cur_rank = len(descriptor)
if "=" in descriptor:
if mark_ul in descriptor:
state = UL
elif "+" in descriptor:
elif mark_ol in descriptor:
state = OL
else:
raise(Exception)
@ -465,8 +465,8 @@ def images():
# Create HTML line
img = '<img class="%s image" src="%s" alt="%s"%s>'%(
params["c="], uri, alt, styles
img = '<img class="%s image" src="%s" title="%s" alt="%s"%s>'%(
params["c="], uri, alt, alt, styles
)
# Set figure if image has a legend

85
website_doc/404.html Normal file
View File

@ -0,0 +1,85 @@
<!-- Page non trouvée - 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="Page non trouvée">
<meta name="author" content="echolib">
<meta name="description" content="Page d'erreur 404, indiquant que la page demandée n'existe pas/plus">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,404,erreur">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/404.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="Page non trouvée">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/404.html">
<meta property="og:description" content="Page d'erreur 404, indiquant que la page demandée n'existe pas/plus">
<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>Page non trouvée (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-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/404.html" title="Page non trouvée -- echolib, 13/01/2024">Page non trouvée</a>
</h1>
<div id="article_refs">
echolib, 13/01/2024 [<a id="post_code" class="tyto" href="./404.tyto" title="Code source : Page non trouvée">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Ouh-Ouh ! Erreur 404 :(</h2>
<div class="pic_err">
<p class="pic_err">
La page que vous avez demandée n'existe pas ou plus, sûrement parce que ce
site a été enièrement refait, pour convenir à la nouvelle version de
<strong class="tyto">Tyto - Littérateur</strong>.
<br class="tyto">
<br class="tyto">
N'hésitez pas à me contacter, si vous estimez qu'une
information est manquante.
</p>
<a role="link" class="pic_err image" href="/VH_Tyto_404.png"><figure class="pic_err image"><img class="pic_err image" src="/VH_Tyto_404.png" title="Image montrant la chouette, Tyto, perdue" alt="Image montrant la chouette, Tyto, perdue"><figcaption class="pic_err">Licence : CC-by Valérie Honvault</figcaption></figure></a>
</div>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

25
website_doc/404.tyto Normal file
View File

@ -0,0 +1,25 @@
title: Page non trouvée
about: Page d'erreur 404, indiquant que la page demandée n'existe pas/plus
date: 2024-01-13
tags: 404,erreur
authors: echolib
image: 404
VH_Tyto_404.png
Image montrant la chouette, Tyto, perdue
-------------------------------------------------------------------------------
#1 Ouh-Ouh ! Erreur 404 :(
[[ pic_err
(( pic_err
La page que vous avez demandée n'existe pas ou plus, sûrement parce que ce
site a été enièrement refait, pour convenir à la nouvelle version de
*`Tyto - Littérateur`*.
|
|
N'hésitez pas à me contacter, si vous estimez qu'une
information est manquante.
))
::404 "c=pic_err", "f=Licence : CC-by Valérie Honvault"
]]

BIN
website_doc/VH_Tyto_404.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 89 KiB

125
website_doc/a-propos/index.html Normal file
View File

@ -0,0 +1,125 @@
<!-- Mentions Légales - 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="Mentions Légales">
<meta name="author" content="echolib">
<meta name="description" content="Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,mentions légales,C.G.U,licence">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/a-propos/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="Mentions Légales">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/a-propos/index.html">
<meta property="og:description" content="Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/images/logos/justice_scales_cc0.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Mentions Légales (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-15 18:28:34">
<header id="article_header">
<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">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/a-propos/index.html" title="Mentions Légales -- echolib, 14/01/2024">Mentions Légales</a>
</h1>
<div id="article_refs">
echolib, 14/01/2024 [<a id="post_code" class="tyto" href="./index.tyto" title="Code source : Mentions Légales">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">Informations</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Hébergeur du site :</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Conditions d'utilisation</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Propriété intellectuelle</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Politique de confidentialité</a></li>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Informations</h2>
<p class="tyto">
<ul role="list" class="tyto">
<li role="listitem" class="tyto">Éditeur et directeur du site : <cite class="tyto">Cyrille Louarn</cite></li>
<li role="listitem" class="tyto">courriel : <q class="tyto">echolib+tyto@a-lec.org</q></li>
<li role="listitem" class="tyto">XMPP: echolib@a-lec.org</li>
</ul>
<p class="tyto">
Pour toute question ou réclamation concernant ce site, n'hésitez pas à me
contacter.
</p>
</p>
<h2 role="heading" aria-level="2" id="toc_2" class="tyto">Hébergeur du site :</h2>
<p class="tyto">
<ul role="list" class="tyto">
<li role="listitem" class="tyto">Hébergeur : <a role="link" class="tyto" href="https://pulseheberg.com/" title="L'univers des solutions web">https://pulseheberg.com/</a></li>
</ul>
</p>
<h2 role="heading" aria-level="2" id="toc_3" class="tyto">Conditions d'utilisation</h2>
<p class="tyto">
L'utilisation de ce site est soumise aux conditions générales d'utilisation
suivantes
<ol role="list" class="tyto">
<li role="listitem" class="tyto">Le contenu de ce site est fourni à titre informatif uniquement. L'éditeur ne garantit pas l'exactitude, la pertinence ou l'exhaustivité du contenu.</li>
<li role="listitem" class="tyto">L'utilisateur est seul responsable de l'utilisation qu'il fait des informations disponibles sur le site.</li>
<li role="listitem" class="tyto">L'éditeur se réserve le droit de modifier, de compléter ou de supprimer tout ou partie du contenu du site sans préavis.</li>
<li role="listitem" class="tyto">Ce site ne collecte pas d'informations personnelles sans votre consentement.</li>
</ol>
</p>
<h2 role="heading" aria-level="2" id="toc_4" class="tyto">Propriété intellectuelle</h2>
<p class="tyto">
Le contenu de ce site, y compris les textes, images, graphiques, logos, est
sous licence <a role="link" class="tyto" href="https://www.gnu.org/licenses/fdl-1.3.txt" title="GNU Free Documentation License Version 1.3, 3 November 2008">gfdl-1.3</a> (<a role="link" class="tyto" href="https://fr.wikipedia.org/wiki/Licence_de_documentation_libre_GNU" title="Licence de documentation libre GNU (wikipédia)">plus d'informations en français</a>), sauf mentions
contraires et indiquées.
</p>
<h2 role="heading" aria-level="2" id="toc_5" class="tyto">Politique de confidentialité</h2>
<p class="tyto">
Ce site ne collecte aucune information personnelle sans votre consentement.
<strong class="tyto">Aucun cookie n'est utilisé</strong> à des fins de suivi. Les informations que vous
pourriez nous transmettre via les méthodes de contact ne seront utilisées
que dans le but de répondre à vos demandes et ne seront en aucun cas
partagées avec des tiers.
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

78
website_doc/a-propos/index.tyto Normal file
View File

@ -0,0 +1,78 @@
title: Mentions Légales
about: Mentions légales, condition d'utilisation et licence du site web officiel de Tyto - Littérateur
date: 2024-01-14
tags: mentions légales,C.G.U,licence
authors: echolib
logo: @logos/justice_scales_cc0.png
link: https://pulseheberg.com/
https://pulseheberg.com/
L'univers des solutions web
link: gfdl-1.3
https://www.gnu.org/licenses/fdl-1.3.txt
GNU Free Documentation License Version 1.3, 3 November 2008
link: plus d'informations en français
https://fr.wikipedia.org/wiki/Licence_de_documentation_libre_GNU
Licence de documentation libre GNU (wikipédia)
! LOGO
-------------------------------------------------------------------------------
! TOC
#1 Informations
((
(=
= Éditeur et directeur du site : :`Cyrille Louarn`:
= courriel : [`echolib+tyto@a-lec.org`]
= XMPP: echolib@a-lec.org
)=
((
Pour toute question ou réclamation concernant ce site, n'hésitez pas à me
contacter.
))
))
#1 Hébergeur du site :
((
(=
= Hébergeur : ::https://pulseheberg.com/
)=
))
#1 Conditions d'utilisation
((
L'utilisation de ce site est soumise aux conditions générales d'utilisation
suivantes
(=
+ Le contenu de ce site est fourni à titre informatif uniquement. L'éditeur
ne garantit pas l'exactitude, la pertinence ou l'exhaustivité du contenu.
+ L'utilisateur est seul responsable de l'utilisation qu'il fait des
informations disponibles sur le site.
+ L'éditeur se réserve le droit de modifier, de compléter ou de supprimer
tout ou partie du contenu du site sans préavis.
+ Ce site ne collecte pas d'informations personnelles sans votre
consentement.
)=
))
#1 Propriété intellectuelle
((
Le contenu de ce site, y compris les textes, images, graphiques, logos, est
sous licence ::gfdl-1.3 (::plus d'informations en français), sauf mentions
contraires et indiquées.
))
#1 Politique de confidentialité
((
Ce site ne collecte aucune information personnelle sans votre consentement.
*`Aucun cookie n'est utilisé`* à des fins de suivi. Les informations que vous
pourriez nous transmettre via les méthodes de contact ne seront utilisées
que dans le but de répondre à vos demandes et ne seront en aucun cas
partagées avec des tiers.
))

162
website_doc/article/index.html Normal file
View File

@ -0,0 +1,162 @@
<!-- Écrire un article au format .tyto - 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 un article au format .tyto">
<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="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/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="Écrire un article au format .tyto">
<meta property="og:type" content="article">
<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:image" content="https://tyto.echolib.re/images/logos/format_tyto.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Écrire un article au format .tyto (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-15 18:28:34">
<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">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/index.html" title="Écrire un article au format .tyto -- echolib, 06/01/2024">Écrire un article au format .tyto</a>
</h1>
<div id="article_refs">
echolib, 06/01/2024 [<a id="post_code" class="tyto" href="./index.tyto" title="Code source : Écrire un article au format .tyto">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 format ".tyto" ?</a></li>
<ul>
<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>
<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_5">Les métadonnées optionnelles</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_6">Les marqueurs de gestion</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_7">Dans la rédaction</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_8">Rappel</a></li>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le format ".tyto" ?</h2>
<p class="tyto">
Pour que <cite class="tyto">Tyto</cite> puisse convertir un contenu rédactionnel dans un fichier
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
éditeur de texte. Ce fichier doit :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">avoir l'extension [...]<strong class="tyto">.tyto</strong></li>
<li role="listitem" class="tyto">contenir un séparateur d'au moins 5 tirets <code class="tyto">-----</code></li>
</ul>
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Le séparateur ?</h3>
<p class="tyto">
Le séparateur permet de créer 2 parties dans l'article source, <strong class="tyto">Au dessus du
séparateur : l'entête</strong>. Elle contient les métadonnées, comme le titre de
l'article, sa date de création, et encore, les liens et images à configurer.
<strong class="tyto">Sous le séparateur : la rédaction</strong>. Elle contient les textes et les
marqueurs dédiés au formattge des textes.
</p>
<h3 role="heading" aria-level="3" id="toc_3" class="tyto">Dans l'entête</h3>
<p class="tyto">
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 :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">Les métadonnées indispensables</li>
<li role="listitem" class="tyto">les métadonnées optionnelles</li>
</ul>
</p>
<h4 role="heading" aria-level="4" id="toc_4" class="tyto">Les métadonnées indispensables</h4>
<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
configurés sur une seule ligne.
</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 class="tyto">
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
les contenus rédactionnels, préfixée par <code class="tyto">::</code>.
<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_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>
</p>
<h4 role="heading" aria-level="4" id="toc_6" class="tyto">Les marqueurs de gestion</h4>
<p class="tyto">
Les marqueurs de gestion sont uniques, ptionnels et sans métadonnée.
<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">! 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>
</ul>
</p>
<h3 role="heading" aria-level="3" id="toc_7" class="tyto">Dans la rédaction</h3>
<p class="tyto">
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
plus lisibles et aérés. Il est également utile d'indenter les marqueurs
de blocs et leurs contenus.
<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>
</ul>
</p>
<h2 role="heading" aria-level="2" id="toc_8" class="tyto">Rappel</h2>
<p class="tyto">
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
tous les marqueurs, ou simplement taper <code class="tyto">tyto help anchor</code> pour savoir
comment définir une ancre et le lien pointant vers elle.
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

111
website_doc/article/index.tyto Normal file
View File

@ -0,0 +1,111 @@
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
date: 2024-01-06
tags: format .tyto,écrire,
authors: echolib
logo: @logos/format_tyto.png
link: Les métadonnées indispensables
./metas_obligatoires.html
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
./metas_liens.html
Comment écrire des liens pour Tyto - Littérateur
link: Les URIs spécifiques
./metas_uris.html
Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur
link: Écrire les titres
./redac_titres.html
Comment écrire les titres et les sous-titres pour Tyto - Littérateur
! LOGO
-------------------------------------------------------------------------------
! TOC
#1 Le format ".tyto" ?
((
Pour que :`Tyto`: puisse convertir un contenu rédactionnel dans un fichier
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
éditeur de texte. Ce fichier doit :
(=
= avoir l'extension [...]*` .tyto `*
= contenir un séparateur d'au moins 5 tirets {` ----- `}
)=
))
#2 Le séparateur ?
((
Le séparateur permet de créer 2 parties dans l'article source, *`Au dessus du
séparateur : l'entête`*. Elle contient les métadonnées, comme le titre de
l'article, sa date de création, et encore, les liens et images à configurer.
*`Sous le séparateur : la rédaction`*. Elle contient les textes et les
marqueurs dédiés au formattge des textes.
))
#2 Dans l'entête
((
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 :
(=
= Les métadonnées indispensables
= 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
((
Les métadonnées optionnels peuvent avoir des marqueurs multiples qui 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é
doit être unique (toutes identités confondues), et doit être reprise dans
les contenus rédactionnels, préfixée par {` :: `}.
(=
= ::Écrire/créer des liens
= ::Les URIs spécifiques
)=
))
#3 Les marqueurs de gestion
((
Les marqueurs de gestion sont uniques, ptionnels et sans métadonnée.
(=
= +`! NOMAP`+ : article non présent dans le sitemap
= +`! NORSS`+ : article non présent dans le flux RSS
= +`! LOGO`+ : Montre le logo de l'article près de son titre
)=
))
#2 Dans la rédaction
((
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
plus lisibles et aérés. Il est également utile d'indenter les marqueurs
de blocs et leurs contenus.
(=
= ::Écrire les titres, créer la table des matières
)=
))
#1 Rappel
((
La commande {` tyto help `} regroupe différentes sections d'aides. Vous
pouvez par exemple taper {` tyto help article `} pour avoir un aperçu de
tous les marqueurs, ou simplement taper {` tyto help anchor`} pour savoir
comment définir une ancre et le lien pointant vers elle.
))

136
website_doc/article/metas_liens.html Normal file
View File

@ -0,0 +1,136 @@
<!-- Écrire/créer des liens - 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/créer des liens">
<meta name="author" content="echolib">
<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">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/metas_liens.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/créer des liens">
<meta property="og:type" content="article">
<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: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>Écrire/créer des liens (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-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/article/metas_liens.html" title="Écrire/créer des liens -- echolib, 08/01/2024">Écrire/créer des liens</a>
</h1>
<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>]
</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">Métadonnées d'entête</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Lien "link:"</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Lien "image:", "file:"</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Les URIs spécifiques</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Configurer les marqueurs de liens</a></li>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Métadonnées d'entête</h2>
<p class="tyto">
Pour créer un lien, il faut d'abord le référencer dans l'entête de l'article,
au dessus du séparateur <code class="tyto">-----</code>. Chaque marqueurs peut-être utilisé
plusieurs fois et se configure sur 3 lignes. Mais chaque identité du marqueur
doit être unique (tous marqueurs confondus). Il existe 2 types de marqueurs
de lien :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">vers une URL / un URI ; marqueur <code class="tyto">link:</code> uniquement</li>
<li role="listitem" class="tyto">vers un fichier interne (PDF, image...) ; autres marqueurs</li>
</ul>
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Lien "link:"</h3>
<p class="tyto">
L'URL (ou l'URI) du marqueur <code class="tyto">link:</code> n'est pas vérifiée. Vous pouvez
pointer vers un document interne (comme une autre page du site avec
<code class="tyto">../doc/index.html</code>), mais n'oubliez pas de vérifier que le lien, dans
la page HTML, pointe bien vers le document.
</p>
<h3 role="heading" aria-level="3" id="toc_3" class="tyto">Lien "image:", "file:"</h3>
<p class="tyto">
Les marqueurs <code class="tyto">image:</code> et <code class="tyto">file:</code> étant destinés à créer des liens
vers des ressources internes, ils n'acceptent que les URIs. <cite class="tyto">Tyto</cite>
vérifie la présence des fichiers pointés dans le dossier de travail
</p>
<h3 role="heading" aria-level="3" id="toc_4" class="tyto">Les URIs spécifiques</h3>
<p class="tyto">
Vous pouvez en lire plus sur <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>
</p>
<h3 role="heading" aria-level="3" id="toc_5" class="tyto">Configurer les marqueurs de liens</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># De manière générale:</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># marqueur: identité</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># URL / URI</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># texte descriptif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Lien vers une URL ou fichier (interne)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">link: ma page web</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> https://... ou ./index.html</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Lien vers un fichier interne</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">file: mon fichier</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> fichier.pdf</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Lien vers une image interne</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: mon image</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> @paysages/montagne.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

70
website_doc/article/metas_liens.tyto Normal file
View File

@ -0,0 +1,70 @@
title: Écrire/créer des liens
about: Comment écrire des liens pour Tyto - Littérateur
date: 2024-01-08
tags: format .tyto,écrire,liens
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
-------------------------------------------------------------------------------
! TOC
#1 Métadonnées d'entête
((
Pour créer un lien, il faut d'abord le référencer dans l'entête de l'article,
au dessus du séparateur {` ----- `}. Chaque marqueurs peut-être utilisé
plusieurs fois et se configure sur 3 lignes. Mais chaque identité du marqueur
doit être unique (tous marqueurs confondus). Il existe 2 types de marqueurs
de lien :
(=
= vers une URL / un URI ; marqueur {` link: `} uniquement
= vers un fichier interne (PDF, image...) ; autres marqueurs
)=
))
#2 Lien "link:"
((
L'URL (ou l'URI) du marqueur {` link: `} n'est pas vérifiée. Vous pouvez
pointer vers un document interne (comme une autre page du site avec
{` ../doc/index.html `}), mais n'oubliez pas de vérifier que le lien, dans
la page HTML, pointe bien vers le document.
))
#2 Lien "image:", "file:"
((
Les marqueurs {` image: `} et {` file: `} étant destinés à créer des liens
vers des ressources internes, ils n'acceptent que les URIs. :`Tyto`:
vérifie la présence des fichiers pointés dans le dossier de travail
))
#2 Les URIs spécifiques
((
Vous pouvez en lire plus sur ::les URIs spécifiques
))
#2 Configurer les marqueurs de liens
{{
# De manière générale:
# marqueur: identité
# URL / URI
# texte descriptif
# Lien vers une URL ou fichier (interne)
link: ma page web
https://... ou ./index.html
Texte alternatif
# Lien vers un fichier interne
file: mon fichier
fichier.pdf
Texte alternatif
# Lien vers une image interne
image: mon image
@paysages/montagne.png
Texte alternatif
}}

130
website_doc/article/metas_obligatoires.html Normal file
View File

@ -0,0 +1,130 @@
<!-- Écrire les métadonnées indispensables - 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 les métadonnées indispensables">
<meta name="author" content="echolib">
<meta name="description" content="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,métadonnées,entête">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/metas_obligatoires.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 les métadonnées indispensables">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/metas_obligatoires.html">
<meta property="og:description" content="Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_5_metas.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Écrire les métadonnées indispensables (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-15 18:28:34">
<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">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/metas_obligatoires.html" title="Écrire les métadonnées indispensables -- echolib, 06/01/2024">Écrire les métadonnées indispensables</a>
</h1>
<div id="article_refs">
echolib, 06/01/2024 [<a id="post_code" class="tyto" href="./metas_obligatoires.tyto" title="Code source : Écrire les métadonnées indispensables">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 5 marqueurs obligatoires</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Configurer les marqueurs</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Le titre de l'article</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">La date de l'article</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Les étiquettes de l'article</a></li>
</ul>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Les 5 marqueurs obligatoires</h2>
<p class="tyto">
Ces marqueurs et leurs métadonnées sont indispensables. <cite class="tyto">Tyto</cite> en a besoin,
afin de les reprendre, notamment dans les balises HTML <code class="tyto">&lt;meta&gt;</code>. Chacun
de ces marqueur doit être <strong class="tyto">écrit sur une seule ligne</strong>. Leur ordre est
aléatoire. Vous pouvez indenter leurs contenus pour une meilleure
lisibilité. Comme toutes métadonnées d'entête, elles doivent être
écrites au dessus du séparateur <code class="tyto">-----</code>. Vous pouvez également utiliser
des commentaires (la ligne comence par <code class="tyto">#</code>)
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Configurer les marqueurs</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># Marqueur: Contenus</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">title: Le titre de l&apos;article</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">about: La description de l&apos;article</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">date: La date de l&apos;article (AAAA-MM-JJ)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">tags: étiquette,mots clés,</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">authors: Auteur 1,Auteur 2</code></li>
</ol></pre>
<h4 role="heading" aria-level="4" id="toc_3" class="tyto">Le titre de l'article</h4>
<p class="tyto">
Le titre de l'article est utilisé en tant que balise <code class="tyto">&lt;h1&gt;</code> dans la
balise <code class="tyto">&lt;article&gt;</code> de la page HTML. Il est également utilisé en tant que
<code class="tyto">title=&quot;&quot;</code> dans l'onglet de la barre de menu (si le fichier est nommé
<q class="tyto">index.tyto</q>, et son dossier source ajouté dans le fichier du module
"navbar.raw").
</p>
<h4 role="heading" aria-level="4" id="toc_4" class="tyto">La date de l'article</h4>
<p class="tyto">
La date doit être valide et respecter le format <code class="tyto">AAAA-MM-JJ</code> ; exemple :
<code class="tyto">2024-02-29</code>. Dans les pages HTML du site, si ce dernier est configuré
en langue "fr", les dates sont modifiées pour respecter le format
d'affichage "JJ/MM/AAAA" dans la page HTML.
</p>
<h4 role="heading" aria-level="4" id="toc_5" class="tyto">Les étiquettes de l'article</h4>
<p class="tyto">
Elles sont séparées par une virgule. Il est inutile d'ajouter un espace
après. Dans la page HTML de l'article, la balise HTML
<code class="tyto">&lt;meta name=&quot;keywords&quot;</code>, contient aussi les étiquettes fournies dans la
configuration du domaine (section [DOMAIN], clé "tags"). Il est donc inutile
de les réécrire.
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

63
website_doc/article/metas_obligatoires.tyto Normal file
View File

@ -0,0 +1,63 @@
title: Écrire les métadonnées indispensables
about: Comment écrire les métadonnées obligatoires dans l'entête de l'article source pour Tyto - Littérateur
date: 2024-01-06
tags: format .tyto,écrire,métadonnées,entête
authors: echolib
logo: @logos/tyto_5_metas.png
! LOGO
-------------------------------------------------------------------------------
! TOC
#1 Les 5 marqueurs obligatoires
((
Ces marqueurs et leurs métadonnées sont indispensables. :`Tyto`: en a besoin,
afin de les reprendre, notamment dans les balises HTML {` <meta> `}. Chacun
de ces marqueur doit être *`écrit sur une seule ligne`*. Leur ordre est
aléatoire. Vous pouvez indenter leurs contenus pour une meilleure
lisibilité. Comme toutes métadonnées d'entête, elles doivent être
écrites au dessus du séparateur {` ----- `}. Vous pouvez également utiliser
des commentaires (la ligne comence par {` # `})
))
#2 Configurer les marqueurs
{{
# Marqueur: Contenus
title: Le titre de l'article
about: La description de l'article
date: La date de l'article (AAAA-MM-JJ)
tags: étiquette,mots clés,
authors: Auteur 1,Auteur 2
}}
#3 Le titre de l'article
((
Le titre de l'article est utilisé en tant que balise {` <h1> `} dans la
balise {` <article> `} de la page HTML. Il est également utilisé en tant que
{` title="" `} dans l'onglet de la barre de menu (si le fichier est nommé
[` index.tyto`], et son dossier source ajouté dans le fichier du module
"navbar.raw").
))
#3 La date de l'article
((
La date doit être valide et respecter le format {`AAAA-MM-JJ`} ; exemple :
{`2024-02-29`}. Dans les pages HTML du site, si ce dernier est configuré
en langue "fr", les dates sont modifiées pour respecter le format
d'affichage "JJ/MM/AAAA" dans la page HTML.
))
#3 Les étiquettes de l'article
((
Elles sont séparées par une virgule. Il est inutile d'ajouter un espace
après. Dans la page HTML de l'article, la balise HTML
{` <meta name="keywords" `}, contient aussi les étiquettes fournies dans la
configuration du domaine (section [DOMAIN], clé "tags"). Il est donc inutile
de les réécrire.
))

130
website_doc/article/metas_uris.html Normal file
View File

@ -0,0 +1,130 @@
<!-- Les URIs spécifiques - 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="Les URIs spécifiques">
<meta name="author" content="echolib">
<meta name="description" content="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,liens,URIs">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/metas_uris.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="Les URIs spécifiques">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/metas_uris.html">
<meta property="og:description" content="Comment cibler un fichier avec les URIs spécifiques des 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-15 18:28:34" id="date">
<title>Les URIs spécifiques (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-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/article/metas_uris.html" title="Les URIs spécifiques -- echolib, 08/01/2024">Les URIs spécifiques</a>
</h1>
<div id="article_refs">
echolib, 08/01/2024 [<a id="post_code" class="tyto" href="./metas_uris.tyto" title="Code source : Les URIs spécifiques">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 URIs dans les métadonnées</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Exemples d'URIs</a></li>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Les URIs dans les métadonnées</h2>
<p class="tyto">
Hormis pour le marqueur <code class="tyto">link:</code>, et pour le marqueur <code class="tyto">abbr:</code> (qui
n'a pas de référence à un URI), les autres marqueurs ont besoin, en seconde
ligne de configuration, d'un URI. <cite class="tyto">Tyto</cite> reconnaît 3 types d'URIs
différents, en fonction du premier caractère utilisé dans l'URI. Ainsi, la
présence du fichier demandé est vérifiée, et le bon lien dans la page HTML
est créé. L'URI commence par :
<ul role="list" class="tyto">
<li role="listitem" class="tyto"><code class="tyto">@</code>...</li>
<ul>
<li role="listitem" class="tyto">marqueur <code class="tyto">image:</code> ; fichier depuis <q class="tyto">articles/images/</q></li>
<li role="listitem" class="tyto">autres marqueurs ; fichier depuis <q class="tyto">articles/files/</q></li>
</ul>
<li role="listitem" class="tyto"><code class="tyto">/</code>...</li>
<ul>
<li role="listitem" class="tyto">tous marqueurs ; fichier depuis <q class="tyto">articles/</q> </li>
</ul>
<li role="listitem" class="tyto">"autres"... ;</li>
<ul>
<li role="listitem" class="tyto">tous marqueurs : fichier depuis l'emplacement de l'article source</li>
</ul>
</ul>
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Exemples d'URIs</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># URI d&apos;une image : .../articles/images/logos/logo1.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: ID1</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> @logos/logo1.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte Alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># URI d&apos;une image : .../articles/dossier_images/logo2.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: ID2</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> /dossier_images/logo2.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte Alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># UDI d&apos;un fichier dans .../articles/files/PDFs/doc_1.pdf</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">file: ID3</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> @PDFs/doc_1.pdf</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># URI d&apos;un fichier dans un sous dossier de l&apos;article source</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># URI de l&apos;article source : .../articles/about/index.tyto</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># URI du fichier : .../articles/about/PDFs/doc.pdf</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">file: ID4</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> PDFs/doc.pdf</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte Alteratif</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

53
website_doc/article/metas_uris.tyto Normal file
View File

@ -0,0 +1,53 @@
title: Les URIs spécifiques
about: Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur
date: 2024-01-08
tags: format .tyto,écrire,liens,URIs
authors: echolib
-------------------------------------------------------------------------------
! TOC
#1 Les URIs dans les métadonnées
((
Hormis pour le marqueur {` link: `}, et pour le marqueur {` abbr: `} (qui
n'a pas de référence à un URI), les autres marqueurs ont besoin, en seconde
ligne de configuration, d'un URI. :`Tyto`: reconnaît 3 types d'URIs
différents, en fonction du premier caractère utilisé dans l'URI. Ainsi, la
présence du fichier demandé est vérifiée, et le bon lien dans la page HTML
est créé. L'URI commence par :
(=
= {` @ `}...
== marqueur {` image: `} ; fichier depuis [` articles/images/ `]
== autres marqueurs ; fichier depuis [` articles/files/ `]
= {` / `}...
== tous marqueurs ; fichier depuis [` articles/ `]
= "autres"... ;
== tous marqueurs : fichier depuis l'emplacement de l'article source
)=
))
#2 Exemples d'URIs
{{
# URI d'une image : .../articles/images/logos/logo1.png
image: ID1
@logos/logo1.png
Texte Alternatif
# URI d'une image : .../articles/dossier_images/logo2.png
image: ID2
/dossier_images/logo2.png
Texte Alternatif
# UDI d'un fichier dans .../articles/files/PDFs/doc_1.pdf
file: ID3
@PDFs/doc_1.pdf
Texte alternatif
# URI d'un fichier dans un sous dossier de l'article source
# URI de l'article source : .../articles/about/index.tyto
# URI du fichier : .../articles/about/PDFs/doc.pdf
file: ID4
PDFs/doc.pdf
Texte Alteratif
}}

114
website_doc/article/redac_titres.html Normal file
View File

@ -0,0 +1,114 @@
<!-- Écrire les titres et sous-titres - 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 les titres et sous-titres">
<meta name="author" content="echolib">
<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">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/redac_titres.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 les titres et sous-titres">
<meta property="og:type" content="article">
<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:image" content="https://tyto.echolib.re/images/logos/tyto_titles_toc.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Écrire les titres et sous-titres (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-15 18:28:34">
<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">
<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>
</h1>
<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>]
</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 titres</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Les marqueurs</a></li>
</ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">La table des matières</a></li>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Les titres</h2>
<p class="tyto">
En HTML, les 6 titres et sous-titres sont écrits avec les balises <code class="tyto">&lt;h1&gt;</code>
à <code class="tyto">&lt;h6&gt;</code>. Toutefois, <cite class="tyto">Tyto</cite> crée le squelette du site HTML, en
mettant le titre principal de l'article dans la balise <code class="tyto">&lt;h1&gt;</code> - elle-même
dans la balise <code class="tyto">&lt;article&gt;</code>. De ce fait, le contenu rédactionnel dipose
de 5 titres et sous-titres.
</p>
<p class="tyto">
Tous les titres ont la même classe CSS : celle dans la configuration du
domaine ("tyto" par défaut). Chacun des titres a également l'identifiant CSS
incrémentée par ordre d'apparition. Le 1er titre aura donc <code class="tyto">id=&quot;toc_1&quot;</code>,
le 4ème titre, <code class="tyto">id=&quot;toc_4&quot;</code>...
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Les marqueurs</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code">#1 Titre &lt;h2&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#2 Titre &lt;h3&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#3 Titre &lt;h4&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#4 Titre &lt;h5&gt;</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">#5 Titre &lt;h6&gt;</code></li>
</ol></pre>
<h2 role="heading" aria-level="2" id="toc_3" class="tyto">La table des matières</h2>
<p class="tyto">
Il est possible, très facilement, de créer une table des matière
automatiquement grâce au marqueur <code class="tyto">! TOC</code>, à mettre, de préférence au
début du contenu rédactionnel. Cette <strong class="tyto">table des matières</strong>, (comme celles
que vous pouvez observer dans la majorité des pages de cette documentation),
est composée avec tous les titres et sous-titres, et permet de créer des
liens vers leurs ancres.
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

51
website_doc/article/redac_titres.tyto Normal file
View File

@ -0,0 +1,51 @@
title: Écrire les titres et sous-titres
about: Comment écrire les titres et les sous-titres pour Tyto - Littérateur
date: 2024-01-07
tags: format .tyto,écrire,rédaction,titres,table des matières
authors: echolib
logo: @logos/tyto_titles_toc.png
! LOGO
-------------------------------------------------------------------------------
! TOC
# Titre 1 : id="toc_1"
#1 Les titres
((
En HTML, les 6 titres et sous-titres sont écrits avec les balises {` <h1> `}
à {` <h6> `}. Toutefois, :`Tyto`: crée le squelette du site HTML, en
mettant le titre principal de l'article dans la balise {` <h1> `} - elle-même
dans la balise {` <article> `}. De ce fait, le contenu rédactionnel dipose
de 5 titres et sous-titres.
))
((
Tous les titres ont la même classe CSS : celle dans la configuration du
domaine ("tyto" par défaut). Chacun des titres a également l'identifiant CSS
incrémentée par ordre d'apparition. Le 1er titre aura donc {` id="toc_1" `},
le 4ème titre, {` id="toc_4" `}...
))
# Titre 2 : id="toc_2"
#2 Les marqueurs
{{
#1 Titre <h2>
#2 Titre <h3>
#3 Titre <h4>
#4 Titre <h5>
#5 Titre <h6>
}}
# Titre 3 : id="toc_3"
#1 La table des matières
((
Il est possible, très facilement, de créer une table des matière
automatiquement grâce au marqueur {` ! TOC `}, à mettre, de préférence au
début du contenu rédactionnel. Cette *`table des matières`*, (comme celles
que vous pouvez observer dans la majorité des pages de cette documentation),
est composée avec tous les titres et sous-titres, et permet de créer des
liens vers leurs ancres.
))

BIN
website_doc/images/logos/format_tyto.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.2 KiB

BIN
website_doc/images/logos/justice_scales_cc0.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.6 KiB

BIN
website_doc/images/logos/tyto_5_metas.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.2 KiB

BIN
website_doc/images/logos/tyto_titles_toc.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 6.1 KiB

BIN
website_doc/images/logos/tyto_welcome.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.2 KiB

141
website_doc/index.html Normal file
View File

@ -0,0 +1,141 @@
<!-- Bienvenue, librement - 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="Bienvenue, librement">
<meta name="author" content="echolib">
<meta name="description" content="Page d'accueil de la documentation de Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,accueil,projet,description">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/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="Bienvenue, librement">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/index.html">
<meta property="og:description" content="Page d'accueil de la documentation de Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/images/logos/tyto_welcome.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Bienvenue, librement (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-15 18:28:34">
<header id="article_header">
<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">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/index.html" title="Bienvenue, librement -- echolib, 29/11/2023">Bienvenue, librement</a>
</h1>
<div id="article_refs">
echolib, 29/11/2023 [<a id="post_code" class="tyto" href="./index.tyto" title="Code source : Bienvenue, librement">Code source</a>]
</div>
</header>
<p class="alert">
Ce site web est en cours de construction. De nouvelles pages et rubriques
seront prochaînement ajoutées. Tyto - Littérateur est également en cours de
développement. Cependant, même si Tyto est en train de naître, il devrait
être utilisable. N'hésitez donc pas à le tester localement et à me contacter
par mail ou, de préférence, via <a role="link" class="tyto" href="xmpp://im@echolib.re" title="Messagerie XMPP privée personnelle du développeur de Tyto Littérateur">XMPP: im@echolib.re</a>.
</p>
<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 projet</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Le format .tyto</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_5">Traductions</a></li>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Le projet</h2>
<p class="tyto">
<strong class="tyto">Tyto - Littérateur</strong> ou <cite class="tyto">Tyto</cite> pour les intimes, est un <strong class="tyto">générateur
de sites web</strong> statiques, créé en Python sous licence libre. Sa fonction
première est d'être un <strong class="tyto">littérateur</strong>, ce qui signifie qu'il <b class="tyto">transforme
le conenu d'un fichier textuel en page HTML5</b>. C'est chouette non ?
</p>
<h2 role="heading" aria-level="2" id="toc_2" class="tyto">Le format .tyto</h2>
<p class="tyto">
Pour que <cite class="tyto">Tyto</cite> puisse comprendre qu'une partie du texte doit être placée
dans un paragraphe, ou encore que des mots doivent être écrits en gras, il
faut utiliser des marqueurs dans l'article source. Ce site web, sous forme de
documentation (généré par Tyto - Littérateur), est là pour vous aider à
comprendre comment écrire un article au <b class="tyto">format .tyto</b>.
</p>
<p class="tyto">
Vous pouvez avoir un aperçu des fichiers sources de ce site, en cliquant sur
"Code source" dans chacune des pages. Ne vous inquiétez pas, même si la
<a role="link" class="tyto" href="https://fr.wikipedia.org/wiki/Chouette_effraie" title="Tyto alba • Effraie des clochers">chouette effraie</a>, Tyto 'alba', ça ne fait pas peur !
</p>
<h2 role="heading" aria-level="2" id="toc_3" class="tyto">Gestion et personnalisation</h2>
<p class="tyto">
Tyto - Littérateur, a d'autres fonctions. il est capable de vous aider
à gérer de multiples sites web très facilement. Chaque site web - ayant son
propre domaine, se trouve dans son propre dossier, et dispose d'une version
de contrôle ou d'aperçu du site web. Vous pouvez donc vérifier chaque page
avant de la publier officiellement !
</p>
<p class="tyto">
Vous pouvez aussi personnaliser les différentes parties, composant une page
web : des balises metas HTML, au pied de page, en passant par l'entête, le
menu de navigation, et la barre latérale.
</p>
<h2 role="heading" aria-level="2" id="toc_4" class="tyto">Utilisation</h2>
<p class="tyto">
Tyto s'utilise depuis un terminal sous GNU/Linux, que ce soit chez vous, ou
dans un serveur distant. Mais rassurez-vous, les quelques commandes à écrire,
une fois expliquées (taper juste <code class="tyto">tyto</code> pour obtenir de l'aide), sont
intuitives. En fait, vous en utiliserez majoritairement que 2 :
<ul role="list" class="tyto">
<li role="listitem" class="tyto"><code class="tyto">tyto wip monarticle.tyto</code></li>
<li role="listitem" class="tyto"><code class="tyto">tyto publish monarticle.tyto</code></li>
</ul>
</p>
<h2 role="heading" aria-level="2" id="toc_5" class="tyto">Traductions</h2>
<p class="tyto">
Chaque site, tout comme les messages d'informations (logs) sont disponibles
en français et en anglais par défaut. Les logs dépendent de la langue
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
des langues supplémentaires.
</p>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>

89
website_doc/index.tyto Normal file
View File

@ -0,0 +1,89 @@
title: Bienvenue, librement
about: Page d'accueil de la documentation de Tyto - Littérateur
date: 2023-11-29
tags: accueil,projet,description
authors: echolib
logo: @logos/tyto_welcome.png
link: XMPP: im@echolib.re
xmpp://im@echolib.re
Messagerie XMPP privée personnelle du développeur de Tyto Littérateur
link: chouette effraie
https://fr.wikipedia.org/wiki/Chouette_effraie
Tyto alba • Effraie des clochers
! LOGO
-------------------------------------------------------------------------------
(( alert
Ce site web est en cours de construction. De nouvelles pages et rubriques
seront prochaînement ajoutées. Tyto - Littérateur est également en cours de
développement. Cependant, même si Tyto est en train de naître, il devrait
être utilisable. N'hésitez donc pas à le tester localement et à me contacter
par mail ou, de préférence, via ::XMPP: im@echolib.re.
))
! TOC
#1 Le projet
((
*`Tyto - Littérateur`* ou :`Tyto`: pour les intimes, est un *`générateur
de sites web`* statiques, créé en Python sous licence libre. Sa fonction
première est d'être un *`littérateur`*, ce qui signifie qu'il +`transforme
le conenu d'un fichier textuel en page HTML5`+. C'est chouette non ?
))
#1 Le format .tyto
((
Pour que :`Tyto`: puisse comprendre qu'une partie du texte doit être placée
dans un paragraphe, ou encore que des mots doivent être écrits en gras, il
faut utiliser des marqueurs dans l'article source. Ce site web, sous forme de
documentation (généré par Tyto - Littérateur), est là pour vous aider à
comprendre comment écrire un article au +`format .tyto`+.
))
((
Vous pouvez avoir un aperçu des fichiers sources de ce site, en cliquant sur
"Code source" dans chacune des pages. Ne vous inquiétez pas, même si la
::chouette effraie, Tyto 'alba', ça ne fait pas peur !
))
#1 Gestion et personnalisation
((
Tyto - Littérateur, a d'autres fonctions. il est capable de vous aider
à gérer de multiples sites web très facilement. Chaque site web - ayant son
propre domaine, se trouve dans son propre dossier, et dispose d'une version
de contrôle ou d'aperçu du site web. Vous pouvez donc vérifier chaque page
avant de la publier officiellement !
))
((
Vous pouvez aussi personnaliser les différentes parties, composant une page
web : des balises metas HTML, au pied de page, en passant par l'entête, le
menu de navigation, et la barre latérale.
))
#1 Utilisation
((
Tyto s'utilise depuis un terminal sous GNU/Linux, que ce soit chez vous, ou
dans un serveur distant. Mais rassurez-vous, les quelques commandes à écrire,
une fois expliquées (taper juste {`tyto`} pour obtenir de l'aide), sont
intuitives. En fait, vous en utiliserez majoritairement que 2 :
(=
= {`tyto wip monarticle.tyto`}
= {`tyto publish monarticle.tyto`}
)=
))
#1 Traductions
((
Chaque site, tout comme les messages d'informations (logs) sont disponibles
en français et en anglais par défaut. Les logs dépendent de la langue
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
des langues supplémentaires.
))

151
website_doc/rss.xml Normal file
View File

@ -0,0 +1,151 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- #==========================================# -->
<!-- # RSS/Feed generated by Tyto - Littérateur # -->
<!-- #==========================================# -->
<!-- Creation date: Mon, 15 Jan 2024 18:28:34 -->
<!-- Feed URL: https://tyto.echolib.re/rss.xmlrss.xml -->
<rss version="2.0">
<channel>
<title>Tyto - Littérateur</title>
<link>https://tyto.echolib.re/</link>
<description>Documentation officielle du littérateur libre</description>
<image>'
<url>https://tyto.echolib.re/template/VH_Tyto_logo.png</url>
<title>Tyto - Littérateur (logo)</title>
<link>https://tyto.echolib.re/</link>
</image>
<language>fr</language>
<category>Tyto,littérateur,logiciel libre,documentation</category>
<lastBuildDate>Mon, 15 Jan 2024 18:28:34</lastBuildDate>
<copyright>gfdl-1.3</copyright>
<webMaster>echolib+tyto@a-lec.org</webMaster>
<generator>Tyto - Littérateur</generator>
<!-- Articles ordred by last update -->
<!-- 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>
<title>Bienvenue, librement</title>
<link>https://tyto.echolib.re/index.html</link>
<guid>https://tyto.echolib.re/index.html</guid>
<pubDate>Wed, 29 Nov 2023</pubDate>
<description>Page d'accueil de la documentation de Tyto - Littérateur</description>
<author>echolib</author>
<image>
<url>https://tyto.echolib.re/images/logos/tyto_welcome.png</url>
<title>Bienvenue, librement (logo)</title>
<link>https://tyto.echolib.re/index.html</link>
</image>
<category>accueil,projet,description</category>
</item>
</channel>
</rss>

85
website_doc/sitemap.html Normal file
View File

@ -0,0 +1,85 @@
<!-- 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 Normal file
View File

@ -0,0 +1,25 @@
# 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>
)=
))

BIN
website_doc/template/VH_Tyto_logo.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 86 KiB

BIN
website_doc/template/favicon.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

36
website_doc/template/footer.html Normal file
View File

@ -0,0 +1,36 @@
<!-- footer from user file configuration: footer.raw -->
<footer id="footer">
<div id="footer_title">À propos de <strong>Tyto - Littérateur</strong></div>
<div id="footer_about_menu">
<div id="footer_about">
<!-- contents from footer_about.html -->
<p class="footer_about_p">
<strong class="tyto">Tyto - Littérateur</strong> est un <b class="tyto">générateur de sites web statiques</b>,
créés à partir de simples fichiers textuels. C'est un <b class="tyto">logiciel libre</b>
écrit sous <a class="tyto" href="https://forge.a-lec.org/echolib/tyto-litterateur/raw/branch/master/LICENSE">licence GPLv3</a>
en Python par <cite class="tyto">Cyrille Louarn</cite> (<cite class="tyto">echolib</cite>).
</p>
<p class="footer_about_p">
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.
</p>
<p class="footer_about_p">
Tyto - Littérateur (<time datetime="2024-01-15">version 1.11.4</time>) est fait avec amour <3
et passion, et c'est ça qui est <em class="tyto">chouette</em> !
</p>
</div>
<nav id="footer_menu" aria-labelledby="navigation-3">
<ul role="list" id="footer_items">
<!-- Links from domain configuration [WEBSITE_FOOTER] -->
<li role="listitem" class="footer_item"><a role="link" class="footer_item_link" href="https://www.gnu.org/licenses/fdl-1.3.txt" title="Licence du site web de Tyto - Littérateur ">Licence : gfdl-1.3</a></li>
<li role="listitem" class="footer_item"><a role="link" class="footer_item_link" href="/" title="Mentions légales de Tyto - Littérateur ">Mentions légales</a></li>
<li role="listitem" class="footer_item"><a role="link" class="footer_item_link" href="/sitemap.html" title="Plan du site Tyto - Littérateur">Plan du site</a></li>
<li role="listitem" class="footer_item"><a role="link" class="footer_item_link" href="/rss.xml" title="Flux RSS 2.0 Tyto - Littérateur">Flux RSS 2.0</a></li>
</ul>
</nav>
</div>
<div id="footer_credit">
<p id="footer_copyright">Copyright © 2022 - 2024 Tyto - Littérateur</p>
<p id="footer_tyto">Site web géneré par <a role="link" class="footer_cr_link" href="https://tyto.echolib.re/" title="Site web officiel">Tyto - Littérateur</a> [<a role="link" class="footer_cr_link" href="https://forge.a-lec.org/echolib/tyto-litterateur" title="Tyto - Littérateur">Code source</a>]</p>
</div>
</footer>

12
website_doc/template/header.html Normal file
View File

@ -0,0 +1,12 @@
<!-- header from user file configuration: header.raw -->
<a id="site_link" href="/" title="Accueil Tyto - Littérateur">
<header id="header">
<div id="header_logo">
<img id="header_logo_image" src="/template/VH_Tyto_logo.png" title="logo: Tyto - Littérateur. Licence CC-by Valérie Honvault" alt="logo: Tyto - Littérateur">
</div>
<div id="header_abouts">
<p id="header_title">Tyto - Littérateur</p>
<p id="header_about">Documentation officielle du littérateur libre</p>
</div>
</header>
</a>

6
website_doc/template/metas.html Normal file
View File

@ -0,0 +1,6 @@
<!-- metas from user file configuration: metas.raw -->
<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">

6
website_doc/template/navbar.html Normal file
View File

@ -0,0 +1,6 @@
<!-- 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>

1
website_doc/template/sidebar.html Normal file
View File

@ -0,0 +1 @@
<!-- sidebar from user file configuration: sidebar.raw -->

418
website_doc/template/styles.css Normal file
View File

@ -0,0 +1,418 @@
body {
margin: 0;
padding: 0;
background-color: #000;
font-size: 1rem;
font-family: "verdana", sans-serif;
line-height: 1.6;
}
a {
text-decoration: none;
color: #00A7FF;
}
a:focus, a:hover {
text-decoration: underline;
color: #FFDC00;
}
a:focus {
outline: 1px solid #00A7FF;
text-decoration: none;
}
div#site_container {
max-width: 799px;
padding: 10px;
margin: 0 auto 0 auto;
color: #F5F4CB;
}
/* ----------------------------------------------------------------------------
* Header
*/
header#header {
display: flex;
border-bottom: 2px dotted gray;
}
a#site_link {
color: #FFF;
}
img#header_logo_image {
width: 150px;
height: 150px;
}
div#header_abouts {
padding: 0 20px;
}
p#header_title {
font-size: 2rem;
padding: 22px 0 0 20px;
margin: 0;
}
p#header_about {
padding: 0;
margin: 0;
padding-left: 20px;
font-size: 1.5rem;
}
/* ----------------------------------------------------------------------------
* Menu (navbar)
*/
nav#menu {
margin: 0;
border: 2px dotted gray;
border-top: 0;
}
menu#menu_items {
margin: 0;
padding: 5px;
text-align: right;
}
li.menu_item {
list-style-type: none;
margin: 0 5px;
text-transform: capitalize;
font-size: 1.2rem;
display: inline;
}
li.menu_item a {
color: #FFDC00;
}
li.menu_item a:hover {
color: #00A7FF;
}
/* ----------------------------------------------------------------------------
* Article
*/
article#article {
font-size: 1.2rem;
}
img#article_logo {
width: 160px;
height: 90px;
border-top: 0;
float: inline-end;
margin-left: 10px;
}
/* Page 404 structure */
div.pic_err {
display: flex;
margin-bottom: 20px;
}
figure.pic_err {
width: 400px;
}
img.pic_err {
width: 400px;
}
figcaption.pic_err {
text-align: center;
color: gray;
}
/* Article structure*/
h1#article_title {
font-size: 1.8rem;
padding-top: 10px;
margin: 0;
}
div#article_refs {
text-align: right;
font-size: 1.1rem;
}
h2.tyto, h3.tyto, h4.tyto, h5.tyto, h6.tyto {
margin: 5px 0;
color: #FFF;
font-weight: bold;
}
h2.tyto {
font-size: 1.7rem;
}
h2.tyto {
font-size: 1.6rem;
}
h3.tyto {
font-size: 1.5rem;
}
h4.tyto {
font-size: 1.4rem;
}
h5.tyto {
font-size: 1.3rem;
}
h6.tyto {
font-size: 1.2rem;
}
p.alert {
color: #FFFDA5;
font-weight: bold;
}
p.alert::before {
content: "!";
color: red;
font-size: 4rem;
float: inline-start;
margin-right: 10px;
}
code.tyto {
background-color: #4C4C4C;
padding: 0 5px;
color: #FFF;
}
/* bcodes and codes */
pre.bcode_pre {
font-size: .8rem;
}
ol.bcode_items {
border-left: 2px dotted #4C4C4C;
}
ol.bcode_items li.bcode_item::marker {
color: #4C4C4C;;
}
li.bcode_item {
line-height: 4px;
}
code.bcode_code {
margin-left: 10px;
color: #B2B2B2;
font-weight: bolder;
}
/* Blockquotes */
blockquote.tyto {
color: white;
margin: 0 30px;
width: 60%
}
blockquote.tyto p {
margin: 0;
padding: 0;
line-height: 26px;
}
blockquote.tyto p::before, blockquote.tyto p::after {
position: relative;
color: yellow;
font-size: 2rem;
}
blockquote.tyto p::before {
top: 10px;
content: "“";
}
blockquote.tyto p::after {
top: 25px;
content: "”";
}
footer.tyto {
margin: 0;
padding: 0;
text-align: right;
}
footer.tyto a {
color: yellow;
}
/* Lists */
ul.tyto, ol.tyto {
margin: 0 0 0 20px;
}
ul.tyto :is(ol, ul) {
border-left: 1px dashed gray;
}
/* ----------------------------------------------------------------------------
* Footer
*/
footer#footer {
border-top: 2px dotted gray;
color: #FFF;
}
div#footer_title {
color: #FFF;
font-size: 1.8rem;
}
div#footer_about_menu {
display: flex;
}
div#footer_about {
width: 75%
}
nav#footer_menu {
width: 25%
}
p.footer_about_p {
text-align: justify;
font-size: .8rem;
}
div#footer_credit {
text-align: center;
font-size: 1rem;
line-height: 8px
}
/*---------------------------------------------------------------------
* For small screens
* under 500px
*/
@media all and (max-width: 500px) {
div#site_container {
max-width: 100%;
}
/*
* Header
*/
header#header {
display: block;
margin-bottom: 20px;
border: 0;
}
img#header_logo_image {
display: block;
margin: 5px auto;
}
p#header_title {
font-size: 2rem;
padding: 5px;
text-align: center;
}
p#header_about {
font-size: 1.4rem;
padding: 0;
text-align: center;
}
/*
* Menu (navbar)
*/
nav#menu {
margin: 5px 0;
border: 0;
border: 2px dotted gray;
}
li.menu_item {
font-size: 1.1rem;
}
/*
* Article
*/
article#article {
font-size: 1.2rem;
}
h1#article_title {
font-size: 1.3rem;
text-align: center;
}
div#article_refs {
text-align: center;
font-size: .9rem;
}
img#article_logo {
float: none;
display: block;
margin: 10px auto;
}
h2.tyto {
font-size: 1.4rem;
}
h3.tyto {
font-size: 1.3rem;
}
h4.tyto {
font-size: 1.2rem;
}
h5.tyto {
font-size: 1.1rem;
}
h6.tyto {
font-size: 1rem;
}
article#article ul {
padding: 0;
margin: 0;
margin-left: 20px;
}
pre.bcode_pre {
width: 60%;
font-size: .8rem;
}
ol.bcode_items {
margin: 0;
padding: 0 25px;
}
code.bcode_code {
margin: 0;
}
/* Page 404 structure */
div.pic_err {
display: grid;
}
p.pic_err {
order: 2;
}
figure.pic_err {
width: 300px;
margin: 15px auto;
}
img.pic_err {
width: 300px;
}
figcaption.pic_err {
font-size: 1rem;
}
/*
* Footer
*/
div#footer_title {
font-size: 1.2rem;
}
div#footer_about_menu {
display: block;
}
div#footer_about {
width: 100%;
font-size: .8rem;
}
nav#footer_menu {
width: 100%
}
div#footer_credit {
font-size: .7rem;
}
}