Définitions des modules
-Forcer une nouvelle génération des modules HTML
-Afficher les modules dans les pages avec nginx
+Forcer une nouvelle génération des modules HTML
+Afficher les modules dans les pages avec nginx
Définitions des modules
Tyto - Littérateur intègre dans chaque page du site, différents modules.
-Ils sont créés automatiquement lors du 1er "wip" d'un article, ou si le
-contenu du fichier de configuration du module a changé. Vous pouvez les gérer,
-et modifier leurs contenus grâce aux fichiers ".../modules/[module].raw"
-dans le dossier de travail du domaine. Chaque fichier dispose d'une petite
-aide explicative, et de rappel d'URIs dans son entête. Vous pouvez forcer
-la génération d'un module avec la commande tyto wip [module_name]
+Ils sont créés automatiquement lors du 1er "wip" d'un article, ou mis à
+jour avec cette action, si le contenu du fichier de configuration du module
+a changé. Vous pouvez les gérer, et modifier leurs contenus grâce aux
+fichiers ".../modules/[module].raw" dans le dossier de travail du domaine.
+Chaque fichier dispose d'une petite aide explicative, et de rappel d'URIs
+dans son entête.
-Le module "metas"
+Générer et publier les modules
+
+Vous pouvez forcer la génération HTML d'un module avec la commande
+tyto wip [module_name], et publier le dossier "...wip/template/" dans
+le serveur ".../www/template/" avec la commande tyto publish.
+
+Le module "metas"
Le module "metas", issu du fichier de configuration "metas.raw" insère des
balises HTML <meta>, prioritaires. Les balises utilisées par défaut :
-Exemple HTML des metas
+Exemple HTML des metas
<meta charset="UTF-8"><meta>, prioritaires. Les balises u
<meta name="revisit-after" content="3 days"><meta name="viewport" content="width=device-width, initial-scale=1.0">
-Le module "header"
+Le module "header"
Le module "header", issu du fichier de configuration "header.raw" insère
l'entête HTML dans les pages du site. Son contenu dépend de la
-::configuration du domaine. Voici un exemple de sa structure HTML et des
-identificateurs CSS :
+::configuration du domaine. Voici un exemple de sa structure HTML par
+défaut, et des identificateurs CSS :
-Exemple HTML d'une entête
+Exemple HTML d'une entête
<a role="link" id="site_link" href="/" title="%s"></header></a>
-Le module "navbar"
+Le module "navbar"
Le module "navbar" issu du fichier de configuration "navbar.raw" insère
la barre de manu principale, libellée pour l'accessibilité, "navigation-1".
@@ -147,7 +154,7 @@ Pour ajouter un onglet au menu du site :
éditer le fichier navbar.raw, en ajoutant le nom du nouveau dossier
-Exemple HTML d'un menu
+Exemple HTML d'un menu
<nav id="menu" aria-labelledby="navigation-1"></menu></nav>
-Le module "sidebar"
+Le module "sidebar"
Le module "sidebar" issu du fichier de configuration "sidebar.raw" insère
la barre latérale contenant des articles à mettre en avant. Son contenu
@@ -174,7 +181,7 @@ Pour ajouter un article à la barre latérale :
éditer le fichier sidebar.raw en ajoutant l'URI de l'article (URI depuis le dossier de travail du domaine ".../article/")
-Exemple HTML d'une barre latérale
+Exemple HTML d'une barre latérale
<aside id="sidebar"></nav></aside>
-Le module "footer"
+Le module "footer"
Le module "footer" issu du fichier de configuration "footer.raw" insère le
-pied de page HTML dans les pages du site. Son contenu dépend de la
-::configuration du domaine. Un menu de navigation, libellé pour
+pied de page HTML dans les pages du site. Son contenu par défaut, dépend
+de la ::configuration du domaine. Un menu de navigation, libellé pour
l'accessibilité "navigation-3", est créé automatiquement.
-Exemple HTML de pied de page
+Exemple HTML de pied de page
<footer id="footer"></div></footer>
-Forcer une nouvelle génération des modules HTML
+Forcer une nouvelle génération des modules HTML
Même si un module a déjà été généré, si vous avez besoin de forcer une
nouvelle génération de modules, il suffit de le demander, via l'action "wip".
-
-Les modules HTML se trouvent dans le dossier du serveur "...wip/template/"
+Les modules HTML créés se trouvent dans le dossier du serveur
+"...wip/template/"
tyto wip modules # Créer TOUS les modules HTMLAfficher les modules dans les pages avec nginx
+Afficher les modules dans les pages avec nginx
Même si les pages du site sont statiques, les modules doivent être appelés
par le serveur. Nginx dispose d'une configuration qui lui permet d'insérer
diff --git a/src/usr/share/tyto/docs/www/modules/index.tyto b/src/usr/share/tyto/docs/www/modules/index.tyto
index d1ef6d9..82853f0 100644
--- a/src/usr/share/tyto/docs/www/modules/index.tyto
+++ b/src/usr/share/tyto/docs/www/modules/index.tyto
@@ -19,12 +19,19 @@ link: métadonnée indispensable
#1 Définitions des modules
((
*`Tyto - Littérateur`* intègre dans chaque page du site, différents modules.
- Ils sont créés automatiquement lors du 1er "wip" d'un article, ou si le
- contenu du fichier de configuration du module a changé. Vous pouvez les gérer,
- et modifier leurs contenus grâce aux fichiers ".../modules/[module].raw"
- dans le dossier de travail du domaine. Chaque fichier dispose d'une petite
- aide explicative, et de rappel d'URIs dans son entête. Vous pouvez forcer
- la génération d'un module avec la commande {` tyto wip [module_name]`}
+ Ils sont créés automatiquement lors du 1er "wip" d'un article, ou mis à
+ jour avec cette action, si le contenu du fichier de configuration du module
+ a changé. Vous pouvez les gérer, et modifier leurs contenus grâce aux
+ fichiers ".../modules/[module].raw" dans le dossier de travail du domaine.
+ Chaque fichier dispose d'une petite aide explicative, et de rappel d'URIs
+ dans son entête.
+))
+
+#2 Générer et publier les modules
+((
+ Vous pouvez forcer la génération HTML d'un module avec la commande
+ {` tyto wip [module_name]`}, et publier le dossier "...wip/template/" dans
+ le serveur ".../www/template/" avec la commande {` tyto publish `}.
))
#2 Le module "metas"
@@ -47,8 +54,8 @@ link: métadonnée indispensable
((
Le module "header", issu du fichier de configuration "header.raw" insère
+`l'entête`+ HTML dans les pages du site. Son contenu dépend de la
- ::configuration du domaine. Voici un exemple de sa structure HTML et des
- identificateurs CSS :
+ ::configuration du domaine. Voici un exemple de sa structure HTML par
+ défaut, et des identificateurs CSS :
))
#3 Exemple HTML d'une entête
@@ -133,8 +140,8 @@ link: métadonnée indispensable
#2 Le module "footer"
((
Le module "footer" issu du fichier de configuration "footer.raw" insère le
- +`pied de page`+ HTML dans les pages du site. Son contenu dépend de la
- ::configuration du domaine. Un menu de navigation, libellé pour
+ +`pied de page`+ HTML dans les pages du site. Son contenu par défaut, dépend
+ de la ::configuration du domaine. Un menu de navigation, libellé pour
l'accessibilité "navigation-3", est créé automatiquement.
))
@@ -166,8 +173,8 @@ link: métadonnée indispensable
((
Même si un module a déjà été généré, si vous avez besoin de forcer une
nouvelle génération de modules, il suffit de le demander, via l'action "wip".
- |
- Les modules HTML se trouvent dans le dossier du serveur "...wip/template/"
+ Les modules HTML créés se trouvent dans le dossier du serveur
+ "...wip/template/"
{{
tyto wip modules # Créer TOUS les modules HTML
tyto wip metas # Créer le module metas.html
@@ -191,7 +198,7 @@ link: métadonnée indispensable
Même si les pages du site sont statiques, les modules doivent être appelés
par le serveur. Nginx dispose d'une configuration qui lui permet d'insérer
le contenu d'un fichier dans une page. L'action se déclenche lorsqu'un
- commentaire HTML conttient {`# include_virtual=""`}. Dans la configuration
+ commentaire HTML conttient {` # include_virtual="" `}. Dans la configuration
du serveur nginx, il faut ajouter :
))
{{
diff --git a/src/usr/share/tyto/docs/www/publier/index.html b/src/usr/share/tyto/docs/www/publier/index.html
index a06f305..2453097 100644
--- a/src/usr/share/tyto/docs/www/publier/index.html
+++ b/src/usr/share/tyto/docs/www/publier/index.html
@@ -33,7 +33,7 @@
-
+
Publier un article (echolib) | Tyto - Littérateur
@@ -46,7 +46,7 @@
-