Voir la source de Créer un nouvel article

== Créer une nouvelle page ==
Pour créer une nouvelle 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 !''' (Attention, il n'est pas très facile de changer le titre d'une page par la suite, choisissez bien votre titre)


<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>



'''<u>Lisez les règles de bonnes pratiques de cette page</u>''' pour associer votre page à la bonne catégorie et y inclure les bonnes informations.

Si vous souhaitez en restreindre l'accès (lecture/écriture) à certains membres du Clubelek, lisez également cette page.



== Règles 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 centralise l'ensemble. Il ne s'agit pas d'un "pense bête" pour les personnes travaillant sur le projet mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.''' Dans l'idéal, toutes les informations incluses (ou recensées) dans le Wiki, doivent permettre de reproduire entièrement le projet.

Il est donc demandé de '''<u>ne pas multiplier les pages courtes</u>''' mais d'en faire '''<u>une seule par projet</u>''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par participation à 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 importants (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), elle propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources. 

=== Une page Wiki doit être reliée à une 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<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories). 

La plupart des pages seront dans une seule catégorie, cependant, vous pouvez relier une page à plusieurs catégories. Pour ne pas compliquer la lecture de l'arborescence, n'attachez pas une page une catégorie "parent" d'une catégorie dans laquelle votre page est déjà. ''Par exemple, vous pouvez attacher un article sur l'asservissement de robots au catégories "Coupe de Robotique > Techniques pour la coupe de robotique" et la catégorie "Articles Techniques de robotique".''

Certaines catégories sont restreintes en lecture et en écriture (''e.g.  [[:Catégorie:Gestion courante (réservé bureau)|Gestion courante (réservé bureau)]]''). Vous pouvez y ajouter votre page si vous souhaitez qu'elle ne soit pas publique. '''Il est demandé de n'attacher les pages non publiques 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).

== Tutoriels :  Gestions des catégories et restrictions par groupes utilisateurs ==

=== Ajouter une page à une catégorie ===
Pour définir les catégories d'une page, dans l'éditeur de la page, il faut aller dans les '''"Options de la page" (icône ☰) puis "Catégories"''', choisir les catégories adéquates dans la liste déroulante, puis il suffit de cliquer sur "Appliquer les modifications". C'est tout ! Votre page devrait désormais apparaître au bon endroit dans l'arborescence ! (vous pouvez changer les catégories à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez-là au préalable.'''

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> 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. Dans l'idéal, le nom de la catégorie doit être explicite sans connaitre le nom de la catégorie parent. ''(e.g. ne pas faire "Coupe de France de robotique > Robots" mais "Coupe de France de robotique > Robots de la Coupe de France de Robotique")'' 

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.

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivez la même procédure que pour ajouter une catégorie à une page. '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories" (qui est la racine)'''. Sinon votre catégorie n’apparaîtra pas dans l'arborescence.  

=== Modifier la barre de navigation ===
Pour modifier la barre de navigation, éditez la page [[MediaWiki:Sidebar]]. Plus d'informations sur [[mediawikiwiki:Manual:Interface/Sidebar/fr|la documentation officielle.]]  

=== 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 cela, créez votre catégorie puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges (exemple ci-dessous).

<syntaxhighlight lang="php">
$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'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, il faut protéger la catégorie qui contient DIRECTEMENT les pages. Une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée (si cette catégorie enfant n'est pas explicitement protégée). 

<big>CategoryLockdown permet de protéger le texte des pages, l'architecture de Médiawiki ne permet néanmoins pas, de protéger les images et autres fichiers. '''<u>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.</u>'''</big>