Ensiwiki:Rédacteurs

De Ensiwiki
Aller à : navigation, rechercher

Si vous êtes enseignant ou étudiant à l'Ensimag, vous devez avoir un identifiant et un mot de passe. Une fois identifié, vous pourrez modifier la quasi-totalité des articles du Wiki. Si vous ne faites pas partie de l'école, vous n'aurez pas accès en écriture au wiki (contacter Matthieu Moy par exemple si vous avez de bonnes raisons de penser que vous devriez avoir les droits).

Attention : en contribuant à ce Wiki, vous acceptez les conditions précisées sur la page Ensiwiki:Copyright (pour faire court, vos contributions seront propriété de l'Ensimag, et mise sous licence creative common).

EnsiWiki utilise le moteur de rendu MediaWiki, développé au départ pour Wikipédia. Nous ne rappellerons pas ici les détails de l'édition, qui sont déjà trés bien documentés sur les pages « Comment modifier une page » et « Aide:Syntaxe » de Wikipédia. Mais pour faire court, les pages sont éditées via une syntaxe textuelle, et MediaWiki s'occupe de faire un joli rendu. Si vous débutez, rendez-vous sur la page Bac A Sable, où vous pourrez faire des essais sans risquer de casser des pages intéressantes.

Création d'une page

Pour créer une page, il faut commencer par lui choisir un nom. Choisissez un nom expressif, même s'il est un peu long. Le titre de la page apparaitra dans l'URL de la page, et en haut de la page en question. Pour l'instant, seul le titre de la page est pertinent, on n'a pas encore besoin de se poser la question « où vais-je mettre la page ».

  • Le mieux est de commencer par éditer une page pour créer un lien (pour l'instant cassé) vers la page à créer. Par exemple, on peut ajouter le lien dans une page comme Informatique 1A. Le lien apparaitra ensuite comme ceci : Lien vers une page à créer. Il suffit de cliquer dessus, et l'interface proposera de créer la page.

Pour que la page soit visible, ajoutez-lui ensuite des catégories, et ajoutez des liens vers cette page là où vous le jugez pertinent. C'est à cette étape qu'il devient nécessaire de s'organiser, et de dire « où (dans quelle(s) catégorie(s) ranger la page », mais l'intérêt du système de catégorie est qu'on peut facilement changer tout cela après coup.

Si l'article est destiné à être régulièrement utilisé par les étudiants, on peut ajouter un lien quelque part dans la sidebar : MediaWiki:Sidebar. Pensez à faire vivre le cadre « actualité », il n'y a pas besoin de droits particuliers pour le faire !

Suppression d'une page

Tous les utilisateurs sont autorisés à supprimer et restaurer des pages supprimées. En cas de doute, plutôt que de supprimer une page, on peut éditer la page ajouter [[Catégorie:À Supprimer]] pour que la page soit listée sur la page Catégorie:À Supprimer. Quelqu'un d'autre passera plus tard pour faire la suppression.


Pages particulières

QCM en libre service pour les étudiants

EnsiWiki permet de mettre assez simplement à disposition des étudiants des QCM avec corrigés (via l'extension Quiz de MediaWiki). Les réponses des étudiants ne sont pas enregistrées : c'est simplement un outil d'auto-évaluation pour les étudiants.

Voici un exemple (code source de ce QCM):

1. Un exemple de question

Une réponse fausse (avec un petit - dans le code source)
Une autre réponse fausse
la réponse juste (avec le petit + dans le code source)

2. Autre exemple

Réponse juste
Petite explication sur la réponse, qui n'apparait qu'après avoir rempli le questionnaire.
Autre réponse juste
... et encore une explication (toujours précédée par || dans le code source)
Ne pas cliquer ici
Non, on vous avait dit de ne pas cliquer
Et vous l'avez fait quand même.

Votre pointage est 0 / 0


Pour une documentation complète, voir le manuel de l'extension Quiz.

D'autres exemples réels sont disponibles par exemples dans Catégorie:Logiciel de Base Apprentissage ou encore sur la page QCM Démarrage Ada.

Boîtes déroulantes pour exos avec correction "cachée"

Un peu dans le même esprit que les QCM, on peut utiliser les boîtes déroulantes: ça permet de poser des questions pour lesquelles la réponse n'est pas simple (par exemple, c'est une démonstration mathématique). Voir l'exemple ci-dessous.

Question: Quelle est la réponse à cette question ?

Pour plus d'info, allez voir la doc des boîtes déroulantes
Il y a aussi de vrais exemples sur Algorithmique 2: exo d'introduction au coût en moyenne.

Inclusion de pages web distantes, interface avec Git

Il est possible d'inclure des pages web externes au wiki, en utilisant les fonctionnalités de l'extension Include de MediaWiki. Pour limiter les risques en matière de sécurité, la liste des sites est pour l'instant limitée, mais n'hésitez pas à demander (à Matthieu Moy ou Patrick Kocelniack) si besoin d'en ajouter.

En particulier, il est possible d'inclure des pages depuis Github, Gitorious, ou repo.or.cz, ce qui permet de gérer une partie du contenu du wiki via Git. Des modèles sont disponibles pour inclure du code joliment (avec coloration syntaxique) avec une syntaxe légère : Modèle:Github (et une utilisation de ce modèle avec Modèle:Github ldba), Modèle:Gitorious. Un exemple d'utilisation est disponible ici : LdB Modes d'adressages.

Attention, le cache de MediaWiki est agressif, il faut rafraîchir le cache (un bouton est disponible si on utilise les modèles ci-dessus) quand on modifie les fichiers avec Git.

Utilisation d'Ensiwiki pour des rendus de projets étudiants

Il est possible d'utiliser Ensiwiki pour des rendus de documentation suite à un projet (comme par exemple en IRL). Gardez bien entendu en tête que le wiki est public, bien sûr.

Pour structurer les pages, merci d'utiliser (ou de faire utiliser aux étudiants, si vous êtes enseignant) le modèle Modèle:Projet_Étudiant (suivez le lien pour avoir la doc).

Généralités sur l'édition d'articles

  • Quand vous faites une modification non triviale (et par triviale, il faut entendre orthographe, grammaire, wikification du texte, ajouts de liens internes évidents, etc.), laissez un commentaire dans le champ résumé en bas de la page d'édition, histoire que l'on sache ce que vous avez trafiqué sans devoir lire le diff.
  • En général, préférez les liens internes, aux liens externes, à pas de liens du tout (dans cet ordre). Il est très important que les pages soient facilement accessibles.

Généralités sur les commentaires

  • Quand vous postez un commentaire, signez avec --~~~~ histoire que l'on sache qui a écrit quoi, et cela sert aussi de séparateur entre les différents intervenants d'un fil de discussion. N'oubliez pas si vous postez à deux endroits de signer aux deux endroits.
  • Lorsque vous postez un commentaire à la suite d'une discussion, utilisez une liste, mais vous pouvez en général vous contenter du niveau 1 (*) pour un nouveau topic, et du niveau 2 (**) pour poster à la suite ; les niveaux supplémentaires peuvent être difficiles à lire.

Sur le fond

  • Rester accessibles aux débutants, tout en attirant la curiosité des autres.
  • Se concentrer sur ce qui est spécifique Ensimag. Les articles plus généraux auront plus de visibilité sur des sites indépendants de l'école comme lea-linux, le site du zéro, ...
  • Identifier comme tel ce qui est spécifique à l'école, ce qui est facile et ce qui est dur, ... (cf. Modèle:Ensimag, Modèle:Avancé, Modèle:Attention ...). Découper les articles longs en plusieurs niveaux (débutants, intermédiaire, avancé).

Techniquement

  • Pour un cadre actualité sur une page en particulier, utiliser le modèle Modèle:Actualité.