tyto-litterateur/website_doc/index.tyto

90 lines
3.2 KiB
Plaintext
Raw Normal View History

2024-01-15 18:32:27 +01:00
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.
))