Créer un nouvel article

De Wiki Clubelek

Créer une nouvelle page (formulaire)

Pour créer une page, rien de plus simple, renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version de votre page ! (Attention, il n'est pas très facile de changer le titre d'une page...)



Lisez les règles de bonnes pratiques/tutoriels de cette page pour associer votre page à la bonne catégorie ou si vous souhaitez en restreindre l'accès à certains membres du Clubelek.

Règles/tutoriel de conception propres au Wiki du Clubelek

Une page Wiki n'est pas un "Readme" !

Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il ne s'agit pas d'un "pense bête" pour la génération courante mais d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.

Il est donc demandé de ne pas multiplier les pages courtes mais d'en faire une seule par projet, quitte à ce qu'elle soit très longue ! (e.g. une seule page par robot de la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, une page Wiki héberge directement tous les fichiers de conception sensibles (s'ils ne sont pas trop lourds) afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), il propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

Une page Wiki doit être reliée à UNE seule catégorie !

Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie[1] (les catégories sont également elles mêmes dans d'autres catégories).

Il est demandé de n'attacher une page qu'à une seule catégorie, afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

Ajouter une catégorie à la page

Pour définir les catégories d'une page, dans l'éditeur de la page (à droite de la barre d'édition du haut, il faut aller dans les "Options de la page" (icone ☰)" puis "Catégories" puis choisir la catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer la catégorie à tout moment)

Si la catégorie que vous souhaitez n'existe pas, créez là au préalable (tutoriel ci-dessous)

Créer des catégories, gérer les restrictions par groupes utilisateurs

Création de catégorie

Une catégorie est une page spéciale dont le nom respecte le format Catégorie:<Nom de la catégorie><Nom de la catégorie> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe.

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

Votre catégorie doit être reliée à UNE SEULE catégorie parent.

Vous DEVEZ associer votre catégorie à une catégorie parent. Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page (détaillée dans la section précédente). Si vous jugez que votre catégorie n'appartient à aucune catégorie existante, vous devez associer à la catégorie "Toutes les catégories". Sinon votre catégorie n'apparaitra pas dans l'arborescence.

Restreindre l'accès aux pages d'une catégorie à certains groupes

Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis. Pour celà, créez votre catégorie normalement (essayez de mettre le périmètre de la restriction dans le nom de la catégorie) puis contactez un sysadmin pour qu'il modifie le fichier LocalSettings.php de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges.

$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];

Cette protection repose sur l'extension CategoryLockdown[2]. Comme le détaille la documentation, une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée. Il faut donc protéger la catégorie qui contient DIRECTEMENT les pages. Si cela permet de protéger le contenu des pages, l'architecture de Médiawiki ne permet pas, en l'état, de protéger les images et autres fichiers. Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.