Comment écrire sur le wiki ?
Cette page explique comment vous inscrire et écrire sur ce Wiki pour contribuer a cette base de connaissance, à travers le partage de vos projets et de vos recherches et savoir faire.
En cas de soucis, envoyez-nous un mail.
S'inscrire sur le Wiki
Vous pouvez créer un compte sur le wiki.
Notez bien votre mot de passe !
Créer une page "projet" sur le Wiki
- Connectez-vous sur le Wiki
- Remplir le formulaire de création de page ou editer une page projet existante dans Projets
Edition d'une page existante
- Connectez-vous sur le Wiki
- Aller sur la page a éditer
- Appuyer sur le bouton modifier (a droite de la page un icone de crayon qui permet d'editer chaque section de page) ou cliquer sur la Clef a molette en haut de page et ensuite Modifier cette page
- L’éditeur de page s'ouvrira (avec les boutons pour mettre en gras, italique, titre, lien etc..)
Syntaxe
Pour écrire vos pages et les rendres plus lisibles, vous pouvez utiliser différents styles ou options.
Voir la page syntaxe et ce pdf dokuwiki_cheatsheet.pdf qui synthétise tout en une seule page.
Liens internes et dossiers
On peut utiliser le bouton pour creer un lien interne vers une page existante.
Exemple de code pour créer un lien qui va aller ouvrir la page distante de deux dossiers depuis la racine du site :
[[dossier:sousdossier:nomdelapage|texte du lien]]
On pourra créer un lien sur une page comme cela a l'endroit souhaité.
Puis cliquer sur ce lien pour accéder a cette futur page
et ensuite créer la page en l'éditant !
Conseils d’écriture et de lisibilité
Pour rendre vos pages attractives et lisible voici quelques conseils :
- Eviter les pages trop longues, préférez faire des sous-pages quand c'est necessaire
- Eviter les liste trop longue aussi…(vous pouvez utiliser l'option de contenu “dépliable”…)
- Vous pouvez nommez les liens afin soit lisible plutot qu'un lien http://charabiaxxxdededededede.com
- Quelques images et vidéos permettent d’aérer visuellement la page et d'être plus explicite..
Médias
Préparez vos images
Utilisez des images libre de droits !
Pour éviter de ralentir le serveur :
- Redimensionnez vos images 2000 pixels de largeur maximum
- Format jpg ou png conseillé, avec un poids inférieur a 400ko.
Créer une galerie photo
- Préparez vos photos,
- D'abord créer un dossier (souspage) en tapant dans l'url https://www.wikibam.com/doku.php/projets/nomduprojet/nomdelagalerie/
- Insérer les images dedans via le Gestionnaire de médias
- Insérer le code suivant dans la page parente pour afficher la galerie
{{gallery>nomdelagalerie }}
On peut aussi utiliser un chemin complet de namespace : exemple :
{{gallery>:bases:fabnum:workshop:pendule_generatif:photo }}
(notez l'espace a la fin du code pour aligner a gauche !)
Vidéo
- Uploadez votre video sur Youtube
Créer une partie dépliable
Pratique pour caché des choses pas essentielles à première vue et alléger l'aspect d'une page…
<accordion> <panel title="cliquer pour déplier"> Le contenu </panel> </accordion>
cliquer pour déplier
Le contenu
Créer une partie CODE
Pratique pour mettre un bout de code. avec de la coloration syntaxique…
<code c+> votre code ici ! </code>
Créer une page (autre que Projet)
Il ya deux méthodes pour creer une page :
Depuis la barre d'adresse :
- Entrer l'adresse dans le site ou vous souhaiter créer votre page.
- Puis appuyer sur entrée…
- Si la page n'existe pas vous allez pouvoir la créer.
En créant un lien :
- exemple pour une sous pages dans une base technique :
[[bases:nomdebase:sousdossier:start]]
- Une fois le lien crée, vous pourrez créer cette page en l'éditant…
Créer un formulaire
- Voir l'exemple ici et copier/coller le code ! modeleinscriptions
- Penser aux arguments si plusieurs formulaire dans la meme page add_salex