tyto-litterateur/website_doc/index.html

142 lines
7.0 KiB
HTML

<!-- 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>