« Aide » : différence entre les versions

De Wiki58
Aller à la navigationAller à la recherche
Ligne 20 : Ligne 20 :


===Et si je veux créer une table des matières===
===Et si je veux créer une table des matières===
Un article composé de 4 paragraphes ou plus crée automatiquement un sommaire.
Un article composé de 4 paragraphes ou plus crée automatiquement un sommaire (voir le sommaire de cette page)


Si l'article a moins de 4 paragraphes et que l'on souhaite afficher un sommaire il faut inclure au début de la page la commande <nowiki>__TOC__</nowiki> ( mot TOC précédé et suivi de 2 traits de soulignement)
Si l'article a moins de 4 paragraphes et que l'on souhaite afficher un sommaire il faut inclure au début de la page la commande <nowiki>__TOC__</nowiki> ( mot TOC précédé et suivi de 2 traits de soulignement)

Version du 24 février 2021 à 16:43

Avant-propos

Il devient rapidement simple de créer des articles, créer des pages. Retenez bien toutefois quelques principes et conseils à respecter:

  • l'affichage va pouvoir se faire sur un grand écran, sur une tablette, sur un smartphone. Aussi, il est important d'avoir ceci en tête et donc d'éviter les pages interminables, les tableaux pleins de photos, les images en grand format.
  • on choisira donc de scinder, en plusieurs sous pages, une page très dense.
  • l'esthétique du wiki repose également sur le choix des couleurs, tant pour le texte que pour les encadrements. Des paragraphes de cette aide reviennent sur la charte de couleurs
  • n'hésitez pas à regarder le code source des pages et des articles que vous voulez abonder afin de conserver les mêmes styles
  • et surtout (c'est répété partout), demandez conseil à aidewiki@gennievre.net

Comment modifier une page ?

Cliquer sur le lien modifier dans le menu en haut de page permet de faire une modification n'importe où dans la page.

Toutefois une page peut être composée de plusieurs sections. Dans ce cas, il est possible de modifier simplement une section en cliquant sur le lien modifier de la section.

Comment créer une nouvelle page ?

Tant que vous n'êtes pas familier de la création d'articles, de pages, de sous rubriques, contactez aidewiki@gennievre.net pour échanger sur l'endroit où positionner votre contribution.

  • rubrique et sous rubrique: c'est ce que l'on voit sur la page d'accueil. Par exemple, Religion est une rubrique, Cimetières est une sous rubrique de Religion
  • une page est un ensemble d'articles avec des chapitres, des sous chapitres, des paragraphes
  • un article ou une section est une partie de la page (qu'on peut modifier individuellement)

Et si je veux créer une table des matières

Un article composé de 4 paragraphes ou plus crée automatiquement un sommaire (voir le sommaire de cette page)

Si l'article a moins de 4 paragraphes et que l'on souhaite afficher un sommaire il faut inclure au début de la page la commande __TOC__ ( mot TOC précédé et suivi de 2 traits de soulignement)

Pour ne jamais avoir de sommaire il faut inclure au début de la page la commande __NOTOC__ ( mot NOTOC précédé et suivi de 2 traits de soulignement)

Bases de la syntaxe wiki

Voici maintenant une présentation élémentaire de la syntaxe wiki.
Parfois un espace peut être important, parfois il peut aussi ne pas être significatif. Soyez vigilant
A gauche, le résultat. En encadré sur fond jaune, la commande wiki à saisir

Chapitres et sous-chapitres

Les différents niveaux


==Titre de chapitre==

===Titre de sous-chapitre===
====Titre de sous-sous-chapitre====
=====Titre de sous-sous-sous chapitre=====


Retour à la ligne


Un simple saut à la ligne n'a aucun effet
Mais une ligne vide

permet de séparer les paragraphes.

La commande <br> permet de forcer le retour à la ligne

Un simple saut à la ligne

n'a aucun effet
Mais une ligne vide

permet de séparer les paragraphes
La commande <br> permet de forcer le retour à la ligne



Ligne de séparation

Ne pas en abuser  ;-)


Une ligne horizontale : au-dessus
et en-dessous s'obtient avec 4 tirets.


----

Une ligne horizontale : au-dessus
et en-dessous s'obtient avec 4 tirets.
----


Disposition du texte

Le texte peut être centré.
<div style="text-align: center;">Le texte peut être centré.</div>


C'est également possible avec une syntaxe allégée
<center>C'est également possible avec une syntaxe allégée</center>



Le texte peut être aligné à droite.
<div style="text-align: right">Le texte peut être aligné à droite.</div>



Le texte peut être aligné à gauche.
<div style="text-align: left">Le texte peut être aligné à gauche.</div>


Gras et italique

Faire ressortir un mot, un peu plus, encore plus.

''Faire ressortir un mot'', '''un peu plus''', '''''encore plus'''''.


  • Pour résumer: 2 quotes = italique - 3 quotes = gras - 2+3=5 quotes = gras italique

En couleur

Attention à ne pas en abuser. Il est recommandé de limiter le nombre de couleurs afin de ne pas égarer le lecteur avec des codes qu'il ne comprendrait pas.
C'est ainsi que le violet, le bleu et le rouge sont réservés aux liens.
Toutefois le rouge peut être utilisé pour attirer l'attention sur une phrase (voir page d'accueil)
Le reste du temps, une couleur alternative est possible avec le vert (foncé) qui fait partie de la charte graphique du logo GenNièvre

<span style="color:red"> Texte en rouge </span><br>

<span style="color:green"> Texte en vert </span>

Texte en rouge
Texte en vert

Une syntaxe simplifiée est possible avec les balises:

<font color="blue">J'écris en bleu</font>
<font color="blue">J'écris en bleu</font>

J'écris en bleu
J'écris en bleu

Puces, numérotation, tabulation

  • liste à puces (une étoile avant le texte)
    • liste à puces (deux étoiles)
      • liste à puces (trois étoiles)
        • liste à puces (quatre étoiles), etc


  1. numéro 1 avec un dièse pour commencer
  2. numéro 2 avec encore un dièse pour commencer
  3. numéro 3 avec encore un dièse pour commencer, etc
  1. j'ai sauté une ligne, j'ai remis un dièse et ça repart au n°1


Sans rien, je débute en bord de feuille

avec : avant mon texte, j'ai une tabulation
avec :: avant mon texte, la tabulation est double
avec ::: avant mon texte, la tabulation est triple, etc


Taille

Différentes tailles de police :
texte à 70%
texte à 100%
texte à 130%

<span style="font-size: 80%">texte à 80%</span><br>

<span style="font-size: 120%">texte à 120%</span>


Texte préformaté

Une manière simple de mettre en évidence une partie d'un texte consiste à utiliser cette astuce:

Je commence la ligne en bord de page

puis celle ci commence par un espace
et le texte devient préformaté

Avant de revenir normal si je repars du bord de page

Les références comme Wikipedia

Avoir de belles notes de fin de page, bien lisibles et numérotées automatiquement, c'est très facile grâce à la balise <ref>

Exemple:

J'ai envie de belles références <ref>Une référence, en wiki, est une note de fin de page</ref> comme on peut les voir dans Wikipedia <ref>Wikipedia est un wiki mondial construit avec le même outil que Wiki58</ref>

On vous fait une copie d'écran du rendu...


Des balises issues du langage HTML

Souligné s'obtient avec <u>Souligné</u>


Barré s'obtient avec <s>Barré</s>


Texte à largeur fixe s'obtient avec <code>Texte à largeur fixe</code>


Ceci est une citation. s'obtient avec <q>Ceci est une citation.</q>


<!-- Cette balise permet d'insérer du texte explicatif dans le code wiki --> Son contenu n'apparaît pas sur les pages


<pre> Cette balise permet d'envelopper un texte. </pre>

Cette balise permet d'envelopper un texte.


Tableaux

Réaliser un tableau dans un wiki n'est pas évident, on doit décomposer la procédure. Mais en étant méthodique, ça peut devenir relativement simple.

Voici donc les étapes

  • Un tableau débute par la commande {|
  • On peut (ou pas) mettre une légende en la déclarant avec |+
  • Ensuite chaque ligne de tableau commence par |-
  • On peut (ou pas) indiquer une entête de colonne avec un ! unique suivi du nom de la colonne. Mais des données consécutives d'entête de tableau peuvent être ajoutées sur la même ligne séparées par !!
  • Pour chaque ligne ensuite, on rentre chaque donnée précédée d'un | sur une ligne distincte. Les cellules consécutives d'une même ligne de tableau peuvent également être ajoutées à la suite les unes des autres séparées par ||
  • Et le tableau se termine avec une instruction de fin |}

Exemple 1

Fourniture Nombre Prix
Timbres 10 10.30
Cartes 10 6.00
Script pour construire le tableau ci dessus


Exemple 1 simplifié

Autre façon plus visuelle d'écrire le script


Exemple 2

Au tableau 1, on va ajouter un titre (une légende) et une ligne finale avec un total (pas calculé automatiquement). Ce qui va donner ceci:

Cartes de voeux 2021
Fourniture Nombre Prix
Timbres 10 10.30
Cartes 10 6.00
Total 16,30

Vous aurez remarqué que les libellés se mettent automatiquement en gras et centrés, la légende se centre aussi automatiquement.
Au script de départ on a donc ajouté une ligne après l'ouverture de tableau pour déclarer la légende:
|+Cartes de voeux 2021
Et avant de fermer le tableau, on a ajouté deux lignes:
|- pour déclarer une nouvelle ligne
!Total || || 16,30 pour déclarer un libellé en 1ère colonne, suivi d'une colonne vide et de la dernière colonne avec le total

Exemple 3

Bordures et couleur de fond vont nous permettre de finaliser un tableau et de le rendre parfaitement lisible.

Cartes de voeux 2021
Fourniture Nombre Prix
Timbres 10 10.30
Cartes 10 6.00
Total 16,30

Il aura simplement suffit d'ajouter la variable class="wikitable" à la première ligne après la déclaration de création du tableau {| pour que le tableau s'habille ainsi.

Pour tester vos écrits, utilisez le bac à sable

Le Bac à sable est une page spéciale pour s'exercer. On peut y écrire ce que l'on veut, effacer, recommencer.
On y accède dans la barre latérale à gauche, dans le menu Navigation.
Bons tests !

Signez vos articles

  • Vous pouvez utiliser l'affichage '''[[Utilisateur:praynal|Patrick Raynal]]''' pour ajouter une signature à un article, ce qui crée un lien vers votre fiche utilisateur

exemple: Patrick Raynal

  • Vous pouvez également insérer, à l'endroit où vous voulez signer,4 tildes ~~~~ et un horodatage se mettra en place automatiquement

exemple: Praynal (discussion) 8 avril 2020 à 21:05 (CEST)

Mettre votre article, votre image, dans une catégorie

Avant de créer une catégorie, vérifier qu'elle n'existe pas dans la liste des catégories déjà publiées, voir Spécial:Catégories. Il est recommandé, en cas d'hésitation, de solliciter une aide ou un avis auprès de aidewiki@gennievre.net

  • Pour mettre une page dans une ou plusieurs catégories, il suffit de l'ajouter en tout bas de page comme ci-dessous:
[[Catégorie: Premier nom de la catégorie]]
[[Catégorie: Deuxième nom de la catégorie]]
[[Catégorie: Troisième nom de la catégorie]]

Si vous regardez en bas de cette page, vous pouvez voir qu'elle est classée dans la catégorie Aide

Les fonctions avancées utiles

Les balises nowiki sont dans le code pour écrire en wiki mais sans l'exécuter. Ne les utilisez pas dans vos articles.

Sauts de lignes après une image

<br style="clear:both;"/>
Cette ligne force l'affichage du texte en dessous (après) une image

Insertion d'une image

Nous proposerons deux façons pour déposer une image sur une publication:

  1. la méthode conseillée pour débuter
  2. la méthode avancée (pas plus rapide)

Dans tous les cas, vous devez préparer à l'avance votre image:

  • si c'est une vignette décorative qui ne doit pas être agrandie, la taille est libre
  • si c'est un aperçu de petite taille que le visiteur pourra agrandir en cliquant dessus, votre photo doit faire entre 800px et 1600px en mode paysage et ne pas dépasser 800px en mode portrait
  • le format sera jpg ou jpeg pour une photo, vous pouvez utiliser le gif pour un symbole, un picto, une illustration sans dégradé de couleurs
  • compressez votre image pour être aux alentours de 200 kB, évitez de dépasser les 400 kB

Vous devez également nommer l'image d'une manière explicite mais pas trop complexe. Voir le paragraphe Nommer une page, nommer un fichier

la méthode conseillée pour débuter

  • Une fois l'image au bon format, de la bonne taille avec le bon nom (par exemple Brinay pont sncf.jpg), on va l'enregistrer dans Wiki58.
  • Dans le menu vertical à gauche de l'écran, vous allez dans Outils puis dans Importer un fichier.

Une nouvelle page s'affiche

  • Cliquez sur le bouton Parcourir pour aller chercher l'image
  • Dans le cadre Description du fichier, Wiki58 normalisera le nom si nécessaire (ne touchez à rien)
  • En revanche, remplissez le cadre Description avec des mots clés (par exemple travaux sur le pont sncf de la ligne à voie unique entre Clamecy et Cercy la Tour) , cela permettra aux moteurs de recherche de retrouver la photo à travers des mots clés.
  • Cocher Suivre ce fichier (facultatif) mais ne cochez pas la case Ignorer tous les avertissements (conseillé)
  • Ensuite, vous allez appeler votre image dans votre article en plaçant cette commande [[Image:Brinay pont sncf.jpg|thumb|left|150px|<center>Pont SNCF à Brinay</center>]]
    • thumb signifie qu'on veut l'image sous forme de vignette
    • left pour qu'elle soit à gauche de la page
    • 150px sera la largeur de la vignette
    • et enfin la commande pour centrer la légende de la vignette
  • Quand vous enregistrerez les modifications, la vignette se placera dans la page

la méthode avancée (pas plus rapide)

  • Une fois l'image au bon format, de la bonne taille avec le bon nom (par exemple Brinay pont sncf.jpg), on va directement dans le texte de l'article déposer la commande qui va bien:

[[Image:Brinay pont sncf.jpg|thumb|left|150px|<center>Pont SNCF à Brinay</center>]] C'est à dire qu'on ne télécharge pas l'image.


Bon à savoir

Si vous intégrez |thumb| dans votre syntaxe, la légende sera sous l'image. Si vous ne précisez pas |thumb|, la légende sera en infobulle visible lorsqu'on survole l'image

Galerie de photos

Exemple de galerie simple


Avec la balise gallery

<gallery widths=150px>
Image:poisson1.jpg|<center>{titre ou légende de l'image}</center>
Image:poisson2.jpg|<center>{titre ou légende de l'image}</center>
Image:poisson3.jpg|<center>{titre ou légende de l'image}</center>
etc
</gallery>

Les légendes et titres sont optionnels, et peuvent contenir des liens wiki ou un autre formatage.
widths= permet de régler la largeur en pixels des vignettes. Les images doivent avoir été téléchargées pour apparaître.

Avec un tableau

{| class="wikitable"
|[[Image:poisson1.jpg|thumb|150px|<center>{titre ou légende de l'image}</center>]]
|[[Image:poisson1.jpg|thumb|150px|<center>{titre ou légende de l'image}</center>]]
|[[Image:poisson1.jpg|thumb|150px|<center>{titre ou légende de l'image}</center>]]
etc<br> <nowiki>|}

Pour aller beaucoup plus loin

Si vous voulez maîtriser des mises en forme avancées, voici quelques pages d'aide complètes: