Différences entre versions de « Aide MHK backup »

Version du 2 octobre 2018 à 09:24

Création de votre page Projet

Assurez-vous d'abord d'avoir un compte créé sur ce wiki :) et d'avoir demandé les droits d'écriture à un responsable du Humanlab.

Pour créer votre page, trouver un nom au projet que vous portez et aller dans la barre d'adresse pour taper l'url de votre page en recopiant le modèle ci-dessous et en changeant juste "Nom_de_votre_projet" avec le vôtre (Attention le nom ne doit pas contenir d'espace, il faut les remplacer par des underscores aussi appelés tirets du bas (_).

http://wikilab.myhumankit.org/index.php?title=Projets:Nom_de_votre_projet

Valider ce nouvel url en appuyant sur entrée dans la barre d'adresse de votre navigateur (Firefox ou autre) et appuyer ensuite sur le bouton "Créer la page" en haut à droite.

Afin d'avoir une trame de documentation insérer ce modèle en ajoutant simplement cette ligne en bas de page

{{subst:Projet}}

Aller ensuite en bas de la page pour appuyer sur le bouton "enregistrer".

Votre page est maintenant créé avec les principaux titres de paragrapĥes. Vous pouvez ajouter du contenu en appuyant sur le bouton "modifier" pour chacun d'eux.

Documentation type d'un projet

Voici les éléments principaux requis pour la documentation de projets une fois votre page créée. En plaçant le modèle {{Template:Projet}} en bas de votre page tout ces paragraphes seront créés automatiquement avec un sommaire associé.

Attention pour que votre page apparaisse dans le menu "Tous les projets", assurez-vous

Description du projet (Y a-t-il eu des : Réplications, Modifications, Hacks, Détournements)
Cahier des charges prenant en compte la faisabilité / les contraintes
Système similaire existant (open source ?)
Durée totale réelle de la fabrication du prototype
Équipe (Ajouter le nom du référent initiateur du projet)
Matériel nécessaire
Outils nécessaires
Compétences/techniques nécessaires
Documenter tout le processus de création étape par étape, en uploadant les fichiers sources
Coût avec le plus de détails possible élément par élément (et sourcer les fournisseurs de préférence)
Intégrer la ou les catégories auxquels le projet appartient. Tous les projets appartiennent à la catégorie Projets. Pour l'affilier il suffit d'intégrer en bas de page cette ligne.

[[Category:Projets]]

Spécifier l'état d'avancement du projet (Concept,En cours, Réalisé): Ajouter la catégorie correspondante en fin de page. ne pas oublier de modifier cette catégorie quand l'état d'avancement du projet change.

[[Category:En cours]]

Modèle de page :

Pour créer une page basée sur le modèle type de documentation de projet, insérer en haut de la page

{{subst:Projet}}

Pour insérer un modèle non modifiable (à éviter, préférer la méthode précédente)

{{Template:Projet}}

Débuter sur mediawiki :ressources externes

A lire !

https://fr.wikibooks.org/wiki/MediaWiki_pour_d%C3%A9butants/Premi%C3%A8re_utilisation_de_votre_wiki

Autres ressources

Formater le texte et placer les images

https://www.mediawiki.org/wiki/Help:Formatting/fr

https://fr.wikipedia.org/wiki/Aide:Syntaxe_(wikicode)

https://fr.wikipedia.org/wiki/Aide:Ins%C3%A9rer_une_image_(wikicode,_avanc%C3%A9)

Article, sommaire

https://fr.wikipedia.org/wiki/Mod%C3%A8le:Article_d%C3%A9taill%C3%A9

https://fr.wikipedia.org/wiki/Aide:Sommaire

Introduction pour comprendre cette documentation

Cette page permet de visualiser les bases de la syntaxe pour intégrer du texte, des médias (images et autres types de fichiers comme des pdf, zip etc) et liens dans une page. Elle est structurée de la façon suivante:le rendu et en dessous le code utilisé que l'on voit dans un encart.

Dans cet exemple on utilise le symbole "===" au début et à la fin du texte que l'on souhaite afficher comme un titre.

Rendu du wikicode appliqué au texte ou à l'image

=== Rendu du wikicode appliqué au texte ou à l'image ===

Création d'un nouveau projet

Création de la page du projet

Pour créer une page, il suffit de copier l'URL (dans la barrre d'adresse du navigateur) d'une page de projet existant et de remplacer le nom du projet par le nom du nouveau projet. Par exemple :

http://wikilab.myhumankit.org/index.php?title=Projets:Nom_du_projet

Appuyer sur la touche Entrée et cliquer sur Créer (en haut à droite de la page).

Création des chapitres de la page à partir d'un modèle

Une fois la page créée, cliquer sur éditer puis Copier/Coller le code suivant :

{{subst:Projet}}

Enregistrer les modifications en bas à gauche et vous verrez apparaître le sommaire d'une page projet.

Création d'un encart souvent utilisé pour documenter du code

La création des encarts se fait simplement en laissant un espace en début de ligne.

Ici ma phrase commence par un espace en début de ligne pour que mon texte  apparaisse dans un encart

Titre de chapitre : Niveau 2

Il y a 6 niveaux de titre. Le niveau 1 n'est pas listé car il correspond au titre de la page. Donc, ne pas utiliser un seul signe "=" pour un titre.

==Titre de chapitre : Niveau 2==

Sous-titre : Niveau 3

===Sous-titre : Niveau 3===

Sous sous-titre : Niveau 4

 ====Sous sous-titre : Niveau 4====

Sous sous sous-titre : Niveau 5

=====Sous sous sous-titre : Niveau 5=====

Sous sous sous sous-titre: Niveau 6

======Sous sous sous sous-titre: Niveau 6======

Faire des listes

Liste à puces

Une liste à puce se fait en ajoutant un astérisque devant le mot.

Plus vous mettez d'astérisques, plus il y a de sous niveaux

Item principal

*Item principal

- Sous item

 **Sous item

- - Sous sous item

***Sous sous item

Plus vous mettez d'astérisques, plus il y a de sous niveaux

Liste numérotées

pomme
poire
cerise

#pomme
#poire
#cerise

Formatage texte

texte en italique

''texte en italique''

texte en gras

'''texte en gras'''

texte en gras et italique

'''''texte en gras et italique'''''

Revenir à la ligne

Pour revenir à la ligne, il faut sauter une ligne.

Liens

Documentation complète sur les [liens]

Insérer un lien interne

Lien interne avec nom de la page comme nom de lien

Main Page

[[Main Page]]

Lien interne avec nom autre que celui de la page

Lien vers la page principale

[[Main Page|Lien vers la page principale]]

Insérer un lien vers un média

[[Media:nom_du_media.extension|Nom_du_lien]]

Télécharger

[[Media:Calculs-Francis.pdf|'''Télécharger''']]

Lien vers titre de section

Un lien vers une section précise d’un article sera rédigé ainsi :

[[article#section de l'article|lien à afficher]]

Exemple:

Retour vers le début du chapitre Liens

[[Exemple:Exemple-de-page#Liens|Retour vers le début du chapitre Liens]]

Insérer un lien externe

Toutes les infos sur les liens externes ici

Exemple de redirection vers une URL avec visibilité de l'adresse URL:

Article sur http://myhumankit.org/

Exemple de redirection vers une URL cachée derrière un nom de lien :

Myhumankit

[url nom_du_lien]

Intégrer des images

L'intégration d'une image dans une page se passe en trois temps :

Redimensionner la ou les image(s)
Importer l'image sur le serveur du wiki
Intégrer l'image dans la page

Redimensionner une image

Ligne de commande pour redimensionner sous Linux avec Imagemagick : méthode rapide et efficace

Installer Imagemagick si ce n'est pas déjà fait en tapant la ligne de commande suivante dans le terminal

   sudo apt-get install imagemagick

Copier ensuite le dossier des images que vous souhaitez redimensionner

   sudo cp /chemin/vers/le/dossier/mesimages chemin/vers/le/nouveau/dossier/mesimagesOK

Aller dans le dossier mes images OK

   cd /chemin/vers/le/nouveau/dossier/mesimagesOK

Redimensionner la largeur en respectant la proportion en hauteur. ici, 512 px = la largeur

   mogrify -resize 512x *.jpg

Si le redimensionnement ne suffit pas voici la commande pour baisser la qualité

   mogrify -quality 80 *.jpg

Si cela ne fonctionne pas, vérifiez que vous êtes bien dans le dossier de vos images à traiter et vérifier l'extension, parfois l'extension est en majuscule (.JPG)

Quelques liens utiles d'autres fonctionalités de traitement d'image avec Imagemagick:

https://www.howtogeek.com/109369/how-to-quickly-resize-convert-modify-images-from-the-linux-terminal/

https://www.imagemagick.org/script/mogrify.php

Redimensionner une image avec le programme Gimp (équivalent libre de Photoshop) : méthode visuelle pour les frileux de la ligne de commande

Télécharger et installer Gimp pour votre OS (Windows, MAc, ou Linux)

https://www.gimp.org/downloads/

Ouvrir votre image avec Gimp, puis ajuster la taille de l'image dans l'onglet :

Image > Echelle et taille de l'image

Choisir 800 px de large et appuyer sur entrée pour que la hauteur soit changée propotionnellement automatiquement. (Appuyer sur le cadenas pour verrouiller la hauteur et largeur afin de garder les proportions si ce n'est pas déjà le cas)

Si l'image est trop lourde baisser la résolution dans ce même onglet à 72px

Importer des images

Les images doivent être redimensionnées avec une largeur max recommandée de 800 px et un poids max de 100 ko. Sinon les images vont rapidement saturer le wiki :)

Pour insérer une image, il faut d'abord la téléverser sur le serveur du wikilab.

Aller dans le menu à gauche Outils>Importer un fichier>Parcourir (en anglais: Tools>Upload file, et descendre en bas de la page pour valider, cliquer sur "Importer (ou upload en anglais)

En haut de la page apparait le nom de fichier sous le format suivant

File:NomImage.JPG

Copier ce nom pour l'intégrer ensuite dans la page avec le code qui vous convient (voir chapitres suivants)

Retrouver les images importées

Pour retrouver les images que vous venez d'importer sur le wiki, il vous suffit de cliquer sur le lien suivant :

http://wikilab.myhumankit.org/index.php?title=Special:ListFiles

Intégrer une image dans une page

Documentation complète [ici]

Légende

 [[File:Ampoule-e27.jpeg|thumb|left|Légende]]

[[File:Ampoule-e27.jpeg|200px]]

Alignement image

Alignement à gauche

[[File:Ampoule-e27.jpeg|left|100px]]

Alignement au centre

[[File:Ampoule-e27.jpeg|center|100px]]

Alignement à droite

[[File:Ampoule-e27.jpeg|right|100px]]

Insérer une galerie d'images

Toutes les infos sur les galeries ici