Tyto - Littérateur

Documentation officielle de Tyto - Littérateur

wip, l'action qui crée une page web

wip, une action de convertion d'un article Tyto en page HTML

Définition de l'action "wip"

L'action wip permet de convertir un article au format Tyto en page HTML. Grâce aux marqueurs dans l'article, Tyto - Littérateur les transforme en balises HTML, qu'un navigateur web traduit. C'est ce qu'on appelle un littérateur. Cette action peut être utilisée pour faire du traitement de masse

Pourquoi wip ? Tyto - Littérateur permet de créer 2 sites web d'un même domaine. La version 'wip' permet au webmestre de vérifier le contenu et le rendu d'une page (ou du site web entier). Cette action est obligatoire avant de procéder à sa mise en ligne officielle dans 'www' (avec à la commande [publish]). Utiliser l'action wip n'affecte jamais la version officielle du site web.

Convertir un article Tyto en page HTML

Avec tyto wip monarticle.tyto, vous transformez l'article dans le fichier monarticle.tyto en page web. Celle-ci est nommée monarticle.html dans le dossier wip/ du serveur, et l'arborescence originelle est conservée. Enfin, les fichiers intégrables de l'article (images, fichiers) sont également copiés.

wip, une action de convertion d'un article Tyto en page HTML

Créer les fichiers HTML des modules

Après avoir personnalisé un fichier de configuration de module, avec la commande [edit], Tyto - Littérateur crée automatiquement le nouveau fichier HTML dans le dossier wip/template/. Mais il est possible de le construire manuellement (si vous l'éditez autrement).

  • Les cibles [target] utilisables sont :
    • metas
    • navbar
    • sidebar
    • footer
    • template

Avec la commande tyto wip sidebar, Tyto - Littérateur crée le fichier sidebar.html dans le dossier wip/template/. Son contenu sera ajouté à toutes les pages du site web 'wip'.

[tyto wip sidebar] crée le fichier sidebar.html dans le dossier

Avec la commande tyto wip template, Tyto - Littérateur crée tous les fichiers HTML des modules dans le dossier wip/template/.

[tyto wip template] construit tous les fichiers HTML des modules dans le site web d'aperçu

Convertir les articles par traitement de masse

Convertir tous les nouveaux articles

Avec tyto wip added, Tyto - Littérateur transforme seulement les articles qui n'ont pas eté ajoutés au serveur 'wip', ou dont la base de données a été supprimée et recréée (suite à un article non valide)

Forcer la convertion des articles à jour

Avec tyto wip again, Tyto - Littérateur transforme tous les articles qui ont une base de données et qui ont déjà été transformés. Même si un article existe sur le serveur 'wip', si, il a été non valide après avoir été vérifié, il ne sera pas pris en compte.

Convertir seulement les articles modifiés

Avec tyto wip updated, Tyto - Littérateur transforme tous les articles qui ont une base de données, et qui ont été modifiés (et restés valides).

Astuces

Après avoir modifié plusieurs articles, vous pouvez les vérifier et les convertir en une seule ligne de commandes : tyto check updated && tyto wip updated (à condition que les modifications soient restés valides)

Tyto - Littérateur conserve l'arborescence du dossier source "articles/". Un article dans des sous-dossiers ira dans ces mêmes sous-dossiers sur les serveurs.

Pour avoir un aperçu rapide des différentes commandes dans Tyto - Littérateur, vous pouvez simplement lancer la commande tyto (sans arguments) depuis le terminal.

Rappels

Pour qu'un article puisse être transformé en page HTML avec Tyto - Littérateur, il faut l'avoir vérifié avant, et qu'il soit valide grâce à la commande [check].

Il faut être dans l'arborescence d'un domaine pour pouvoir convertir un article. L'autocompletion (touche TAB) facilite l'écriture du nom du fichier.

echolib, le {Code source}