=====Guide de rédaction d'un article sur le Wiki===== ====Organisation des pages==== Un article nommé « Madoc » a été créé à la racine du Wiki, accessible à l’adresse « [[:madoc|wiki.univ-nantes.fr/madoc]] ». Il fait office de portail et redirige vers les différents articles concernant Madoc. Un dossier Madoc a été créé à la racine du Wiki pour contenir tous les articles concernant Madoc. Chaque article est nommé suivant les titres indiqués dans le catalogue, précédé d’un nombre à incrémenter pour les nouveaux articles à venir. Exemple de nom d’article : 2-adapter_son_tableau_de_bord ====Création d’un nouvel article==== ===Vérifications préalables=== * Vérifier l’existence ou non de l’article sur le wiki pour éviter les doublons. * Vérifier si le sujet est traité dans la documentation officielle de Moodle : si oui, est-ce que l’ajout dans le Wiki apporte une plus-value ? (adaptation à un contexte spécifique, captures d'écran). ===Marche à suivre=== - Se connecter sur wiki.univ-nantes.fr - Saisir l’adresse souhaitée du nouvel article sur le modèle https://wiki.univ-nantes.fr/madoc:XX-NOM_ARTICLE \\ Le nom de l’article doit être précédé d’un numéro (incrémenté depuis l’index des articles madoc) + un tiret + le titre de l’article - Une fois l’article rédigé, mettre à jour son statut dans le catalogue ===Rédaction=== [[madoc:modele|Un modèle d’article]] est proposé pour être cohérent sur la forme. Vous pouvez en copier-coller le contenu dans le nouvel article puis le modifier, ou créer votre nouvel article en respectant rigoureusement la mise en forme du modèle. Voici quelques règles à respecter : * Structurer l'article avec les styles de titre : les titres de nivreau 5 et 4 apparaîtront dans la table des matières en haut à droite et permettront au lecteur de naviguer plus facilement dans l'article. Vérifier que les titres concernés sont pertinents au regard des besoins des utilisateurs. * Les articles devront être rédigés à l’infinitif (Exemple : cliquer sur le lien et pas cliquez sur le lien). D’autres modes de conjugaison peuvent être utilisés si nécessaire mais il faut éviter l’infinitif. * Utiliser des chevrons pour séparer les différentes étapes de navigation dans un menu (exemple : **Menu de gestion du cours** > **Utilisateurs** > **Méthodes d'inscription**). * Mettre l’intitulé des boutons/liens en gras (Exemple : bouton **Enregistrer**). ====Concernant les illustrations et documents utilisés dans les articles==== ===La création=== Logiciels conseillés : * Pour les capture d’écran : [[https://getgreenshot.org/|Greenshot]] (Windows). Choisir de préférence un outil qui permette d’ajouter un bord noir d’un pixel autour de l’image et des légendes dans l'image. * Pour les GIF animés : [[https://www.screentogif.com/|ScreenToGif]] * Pour les vidéos : l’outil de capture intégré dans Mediaserver, ou [[https://obsproject.com/fr|OBS]] (Cf. [[madoc:guide_obs|guide OBS]]). ===Le stockage=== Les captures d’écran et documents utilisés dans les articles devront être stockés au même emplacement que l’article concerné. Si vous copier-coller vos images directement dans un article, l'emplacement du stockage sera automatiquemen déterminé. Les contenus iconographiques pouvant être mutualisés entre plusieurs articles sont stockés dans différents dossiers du répertoire « madoc » du Gestionnaire Multimédia » : * Dossier « icones » : les icônes de Madoc pouvant être réutilisés dans un article (exemple : icône d’acton, icône d’activités, etc.). * Dossier « boutons » : les image de bouton Madoc pouvant être réutilisés dans un article (exemple : le bouton du mode édition). * Dossier « documents » : les documents texte (exemple : la charte informatique de l’université). * Dossier « numeros » : des numéros sous forme d’image pouvant être utilisés pour faire référence aux légendes d'une capture d’écran. * Dossier « icones-bloc » : les icônes à utiliser dans les blocs « Note, Astuce Attention et Important). Pour les vidéos, il est préférable de les stocker sur le Mediaserver. ===Le nommage=== Pour les fichiers spécifiques à un article, le nom de fichier devra comporter le numéro de l’article dans lequel il est utilisé (exemple : 5-menu_format_cours.png). ===L’insertion des vidéos=== Les vidéos : les intégrer à l’aide d’un iframe avec le code suivant : %%%% ===L’insertion des images=== Vous pouvez insérer des images par un simple copier-coller. Le formats compatibles : gif, jpg, png. Une fosi votre image insérée, le code doit ressembler à ça : %%{{:madoc:numeros:2.png?nolink&30|}}%% * La mention « nolink » indique que l’image n’est pas cliquable * Le nombre désigné la largeur de l’image en pixel ===Validation et diffusion d’un article=== A la fin de la rédaction/modification de l’article, faire relire l’article si besoin. Si l'article est validé, ajouté le code suivant en haut de page : %%Cet article a été validé le JJ/MM/AAAA%% ===Suppression d’un article=== ==Préalable== Vérifier si la page à supprimer est la cible d’autres pages du Wiki en ajoutant « ?do=backlink » à l’URL de la page à supprimer : * Si la page est orpheline la suppression ne posera pas de problème. * Si la page n’est pas orpheline, il faudra supprimer/modifier les liens contenus dans les autres pages qui dirigent vers la page à supprimer. ==Marche à suivre== - Se connecter sur wiki.univ-nantes.fr - Accéder à la page à supprimer - Cliquer sur le lien « Modifier cette page » situé dans le menu de gauche - Effacer tout le contenu - Cliquer sur le bouton « Enregistrer »