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.
))