Table des matières
Ceci est une ancienne révision du document !
Règles de contenu
Il s'agit de règles de contenu pour les auteurs.
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 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 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”. [[
durch <ignore>[[en:
(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.
Anrede
Es wird in der förmlichen “Sie”-Anrede formuliert. Dies ist eine Folge der Übersetzung mit DeepL, in der englische Beschreibungen mit “Sie” als Anrede übersetzt werden verbunden damit, dass viele Beschreibungen zunächst in englischer Sprache erstellt werden.
Sitebar
Die Sitebar wird manuell gepflegt. Es werden lediglich die Seitenname der Zielseiten als Link angegeben, nicht der Anzeigetext. Die Links haben also die Form [[Seitenziel</ignore>]]
.
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 : Graphiques pour les légendes des images
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 {{inlinetoc_3}}
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 :
<ifauth @admin>
//Visible uniquement par les admins//
Visible uniquement par les admins
//Fin : Visible uniquement par les admins//
</ifauth>
TODOs
Les notes pour les auteurs peuvent être ajoutées via le nodisp-Plugin peuvent être marquées :
<nodisp 2>
TODO : Dis ce qu'il faut faire.
</nodisp>
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.