Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:conventions_for_editors [2025/11/14 09:08] – supprimée julia
+++ fr:conventions_for_editors [2025/11/14 09:09] (Version actuelle) – créée julia
@@ Ligne 1: / Ligne 1: @@
+===== Règles de contenu =====
+Il s'agit de règles de contenu pour les auteurs.
+{{INLINETOC 2-3}}
+==== Langue ====
+  * La langue principale du wiki est l'allemand.
+  * Les pages sont traduites de l'allemand vers l'anglais.
+  * Les captures d'écran sont toujours insérées en anglais.
+  * Pour la traduction, le plugin [[https://www.dokuwiki.org/plugin:deeplautotranslate|Deepl Auto Translate]] est utilisé.
+    * Une page est automatiquement traduite de la langue principale (allemand) vers l'anglais, si la page anglaise était vide.
+    * Pour traduire à nouveau : Vider la page et la traduire à nouveau, puis réviser la page complète et corriger éventuellement les liens externes (voir remarque ci-dessous) ou autres.
+    * Pour la traduction de parties de pages, on utilise également deepL
+//Remarque : lors de la traduction de [[fr:sidebar]] de l'allemand vers l'anglais, tous les liens doivent être complétés par en :, car l'attribution automatique à la langue ne fonctionne pas automatiquement pour les pages qui sont déjà attribuées à un namespace. Cela peut être réalisé en ajoutant dans le texte traduit de la barre de site tous les mots "en". ''<nowiki>[[</nowiki>'' durch ''<nowiki>[[en:</nowiki>'' (Leerzeichen zwischen den Klammern entfernen) ersetzt werden. Externe Links, z. B. zu Wikipedia, müssen manuell durch ihre Entsprechung in der anderen Sprache ersetzt werden.//
+==== Formule de politesse ====
+Il est formulé dans la formule formelle "vous". C'est une conséquence de la traduction avec DeepL, dans laquelle les descriptions anglaises sont traduites avec "vous" comme formule de politesse, liée au fait que de nombreuses descriptions sont d'abord rédigées en anglais.
+==== Sitebar ====
+La Sitebar est gérée manuellement. Seuls les noms des pages cibles sont indiqués sous forme de liens, pas le texte d'affichage. Les liens ont donc la forme ''<nowiki>[[Cible de la page]]</nowiki>''.
+==== Structure des pages ====
+Les différentes pages wiki sont créées avec la structure suivante.
+=== Titres ===
+Chaque page commence par un titre de 2e taille. Ceci est réalisé par un texte entouré de 5 signes d'égalité. L'en-tête 1ère taille (6 signes d'égalité) est réservé et n'est pas utilisé dans un premier temps.
+=== Sous-chapitres ===
+Les sous-chapitres reçoivent des titres de la taille immédiatement inférieure. Il y a au moins deux sous-chapitres, l'un d'eux n'est donc jamais seul.
+==== Ancres ====
+Un plugin est utilisé pour les ancres : https://www.dokuwiki.org/plugin:anchor#examples_usage
+==== Images ====
+Les images sont insérées en anglais et utilisées de la même manière pour toutes les traductions. Si cela est utile pour l'utilisateur, les captures d'écran sont numérotées, ce qui est abordé dans le texte. Ces graphiques sont utilisés à cet effet : {{ pfeile.zip | Graphiques pour les légendes des images}}
+==== Remarques pour les administrateurs ====
+Si des passages de texte dans Dokuwiki ne doivent être visibles que pour les administrateurs, cela peut être résolu de la manière suivante :
+''
+<nowiki><ifauth @admin></nowiki> \\
+  <nowiki><WRAP caution></nowiki> \\
+  Visible uniquement par les admins \\
+  <nowiki></WRAP></nowiki> \\
+<nowiki></ifauth></nowiki>
+''
+Cela ressemble alors à ceci :
+<ifauth @admin>
+<WRAP caution>
+Visible uniquement par les admins
+</WRAP>
+</ifauth>
+L'arrière-plan jaune est créé par la classe ''caution'' est ajoutée.
+==== Indications dans le casque ====
+Si des passages de texte dans le Dokuwiki ne doivent être visibles que dans le casque, cela peut être résolu comme suit :
+''
+<nowiki><WRAP only-headset></nowiki> \\
+Ce texte n'est visible que dans le casque et en tant qu'administrateur du wiki. \\
+<nowiki></WRAP></nowiki> \\
+''
+<WRAP only-headset>
+Ce texte n'est visible que dans le casque et en tant qu'administrateur du wiki.
+</WRAP>
+Le fond jaune pâle est créé par la classe ''only-headset'' est ajoutée.
+===== Remarques sur les plugins =====
+==== Table des matières ====
+La table des matières résulte des titres et s'affiche dans la barre latérale.
+Elle peut être consultée via ''<nowiki>{{inlinetoc_3}}</nowiki>'' une table des matières peut être affichée sur la page. Voir : https://www.dokuwiki.org/plugin:toctweak
+==== Cacher le contenu ====
+Ce plugin permet d'afficher le contenu uniquement pour certains groupes d'utilisateurs : https://www.dokuwiki.org/plugin:ifauthex
+//Remarques ://
+- Un titre est néanmoins visible pour tous. C'est pourquoi il ne faut pas utiliser d'en-têtes.
+- Il faut toujours ajouter des commentaires de bloc pour que la section ne soit lisible que par les admins.
+//Exemple ://
+''
+<nowiki><ifauth @admin></nowiki> \\
+  <nowiki>//Visible uniquement par les admins//</nowiki> \\
+  Visible uniquement par les admins \\
+  <nowiki>//Fin : Visible uniquement par les admins//</nowiki> \\
+<nowiki></ifauth></nowiki>
+''
+==== TODOs ====
+Les notes pour les auteurs peuvent être ajoutées via le [[https://www.dokuwiki.org/plugin:nodisp|nodisp-Plugin]] peuvent être marquées :
+''<nowiki>
+<nodisp 2>
+TODO : Dis ce qu'il faut faire.
+</nodisp>
+</nowiki>
+''
+Ces endroits ne sont alors visibles que pour les éditeurs.
+Les TODO sont accessibles par la saisie de ''TODO :'' dans la recherche.
+==== Traductions ====
+Pour les traductions manuelles sans le plugin translation, on utilise DeepL.