Différences entre versions de « Aide MHK »
Ligne 1 : | Ligne 1 : | ||
+ | Cette page résume les fonctions d'édition principales. Pour toute information complémentaire, consulter l'aide officielle qui est complète : [https://www.mediawiki.org/wiki/Help:Contents/fr Lien vers l'aide à l'édition d'un Mediawiki] | ||
+ | |||
==Création d'une page : Projet, Tutoriel ou support pédagogique == | ==Création d'une page : Projet, Tutoriel ou support pédagogique == | ||
Version du 9 novembre 2022 à 11:28
Cette page résume les fonctions d'édition principales. Pour toute information complémentaire, consulter l'aide officielle qui est complète : Lien vers l'aide à l'édition d'un Mediawiki
Création d'une page : Projet, Tutoriel ou support pédagogique
https://wikilab.myhumankit.org/index.php?title=Contribuer_%C3%A0_la_documentation
Informations à remplir dans le formulaire
Le formulaire contient toutes les informations qui résument le projet et qui apparaîtront dans l'infobox, l'encart en haut à droite de la page .
Pour les champs suivants: Porteur de projet, Contributeur, Fabmanager, Animateur, utiliser le nom d'utilisateur de la personne sur le wiki (pour celles qui ont un compte)
Une fois les informations remplies, cliquer sur enregistrer en bas du formulaire
Aide à l'édition :modifier, enregistrer
Pour éditer la page, soit cliquer sur le bouton modifier en haut à droite de la page pour éditer toute la page soit cliquer sur le bouton Modifier visible à côté de chaque chapitre pour éditer uniquement cette section.
Pour sauver les modifications cliquer sur le bouton "Enregistrer les modifications" tout en bas de la page
Documentation type d'un projet
Le modèle de documentation d'une page Projet est automatiquement généré à la création de la page. Celui-ci contient toutes les sections que doit contenir la documentation. A vous de les remplir au fur et à mesure de l'évolution du projet.
Il existe deux onglets pour une page Projet :
- Onglet "Projets" :c'est celui où vous êtes par défaut
- Onglet "Journal de bord" : au départ le lien est rouge car la page n'est pas créée. C'est à vous de le faire en cliquant simplement dessus en cas de besoin.
L'onglet Projets contient la documentation finale du projet nécessaire à sa réplication. Au début du projet on remplit les sections suivantes:
- Description
- Cahier des charges (sous forme de liste pour plus de clarté)
- Analyse de l'existant
Les autres sections sont remplies une fois que le prototype est finalisé.
L'onglet Journal de bord, nous sert de cahier de suivi du projet. On va y mettre nos notes, premiers développements, les raisons pour lesquelles on abandonne une piste et pas l'autre selon les retours de l'utilisateur que l'on note également au fur et à mesure des échanges.
C'est l'endroit aussi où on met les premières photos ainsi que les fichiers sources (modélisations 3D, code, fichiers 2D etc, schéma électroniques ..) au fur et à mesure des évolutions. On y note également les références des consommables utilisés.
Onglet Projets
- Description du projet (de quoi s'agit-il?, quel est l'objectif du projet, à quel(s) besoin(s) il répond)
- Cahier des charges prenant en compte la faisabilité / les contraintes
- Analyse de l'existant (liens vers des systèmes existants et dire en quoi l'existant ne répond pas au besoin : trop cher, pas adapté sur tel et tel aspect etc ...)
- Durée totale de la fabrication du prototype (pour le répliquer uniquement, on ne compte pas le temps passé pour le développer)
- Équipe (Ajouter le porteur de projet et les contributeurs)
- Matériel nécessaire
- Outils nécessaires
- Coût avec le plus de détails possible élément par élément (et sourcer les fournisseurs de préférence)
- Fichiers sources
- Etapes de fabrication pas à pas. Documenter tout le processus de création étape par étape, en mettant en lien les fichiers sources quand nécessaires
Sur cette page il existe un deuxième onglet intitulé Journal de bord
Onglet Journal de bord
- Journal de bord : le journal de bord permet de suivre les avancées du projet, à chaque nouveau rendez-vous on écrit un petit compte-rendu, et on ajoute les fichiers source (dessins 2D, 3D, code etc ..)
Formatage du texte
Pour formater le texte (en gras, italique, faire des titres, des listes, tableaux etc ..), deux solutions, soit écrire directement en wikicode grâce à l'aide de l'éditeur de texte, soit aller dans le menu avancé de l'éditeur de texte pour sélectionner le formatage voulu une fois le texte sélectionné.
Option 1: Écrire en wikicode avec l'aide de l'éditeur
Option 2: Utiliser l'onglet avancé de l'éditeur
Importer une ou des image(s)
IMPORTANT: redimensionner les images avant de les importer. Les images peuvent être redimensionnées à 700px de large, et ne doivent pas dépasser 200ko. L'extension de l'image doit être de type "jpg" ou "png".
- Ouvrir votre dossier d'images dans l'explorateur de fichiers de l'ordinateur et sélectionner les images à importer (pour en sélectionner plusieurs , appuyer sur la touche Control)
- Faire glisser la sélection dans l'éditeur là où est indiqué "Glisser ici les fichiers"
- Cliquer sur Téléverser tous les fichiers
- Positionner le curseur de la souris à l'endroit où vous voulez que votre image apparaisse puis cliquer sur Insérer en tant qu'image
- Vérifier que l'image a bien été ajoutée à l'emplacement du curseur, avec un texte de ce type : [[File:Inserer_en_tant_image.png]]
Configuration de l'intégration de l'image
Accessibilité : Il est préférable d'éviter l'usage de galeries sans légende ou avec image défilante car elles sont inacessibles pour les malvoyants. Il faut privilégier des images avec des légendes décrivant l'image.
Le format de vignette est donc idéal car il permet d'ajouter une légende sous l'image
Pour ajouter un paramètre on ajoute un pipe (trait vertical) pour chaque nouveau paramètre après le nom de l'image. L'ordre n'a pas d'importance à part le nom de l'image qui doit rester en première position
Exemple :
[[File:Televerser_fichiers.png|700px|vignette|gauche|Bouton téléverser tous les fichiers]]
Explications du wikicode entre les double crochets pour intégrer l'image.
- File:Televerser_fichiers.png => Nom de l'image
- 700px => largeur de l'image, qui change proportionnellement la hauteur. Pour choisir la bonne taille il faut se dire que l'image doit être "lisible" sans avoir à cliquer dessus pour l'agrandir.
- vignette => Format encadré de l'image permettant d'ajouter une légende
- gauche =>alignement de l'image (options possible: gauche, centre, droite)
- Bouton téléverser tous les fichiers =>Légende (décrire précisément ce qu'on voit dans l'image, penser qu'un malvoyant s'en sert pour visualiser l'image)
Intégrer une galerie avec légendes sous les images
Exemple de code pour intégrer une galerie avec légende
<gallery widths="200px" heights="400px"> File:application_cecible_interfaceV2.jpg|Interface v1.22 de l'écran principal correspondant au code source sur ESP32 File:appinventor_cecible_esp32_ecran2.jpg|Interface v1.22 de l'écran de paramétrage correspondant au code source sur ESP32 File:appinventor_cecible_esp32_ecran_infos.jpg|Interface v1.22 de l'écran d'information de l'application correspondant au code source sur ESP32 </gallery>