La syntaxe wiki de GeneWeb

From GeneWeb
Jump to: navigation, search
150px-Geographylogo svg.png Language: English • français

Geneweb utilise une syntaxe identique à la syntaxe wiki (wikitext/wikicode) pour mettre en forme de façon simplifiée notes et pages de la chronique.


Une barre d’outils encadrant les zones de texte permet de faciliter la saisie de la syntaxe wiki :

Barre wiki.png

Titre de page

Pour donner un titre à votre page, insérez TITLE= avant le texte.

TITLE=…

Le premier saut de ligne marque la fin du titre.

Table des matières

Les titres et sous-titres permettent d’organiser l’article. La syntaxe pour les différents niveaux de titres est :

= Titre niveau 1 =
== Titre niveau 2 ==
=== Titre niveau 3 ===
==== Titre niveau 4 ====

Une table des matières est ajoutée automatiquement à l’article dès que celui-ci a plus de quatre titres. Plusieurs options sont disponibles :

  • pour supprimer le sommaire (Table Of Content TOC) :
__NOTOC__
  • pour placer la table des matières à un endroit particulier :
__TOC__
  • pour afficher une table des matières plus courte :
__SHORT_TOC__

Lorsque l'édition du contenu d'une note est possible, GeneWeb ouvre la fenêtre d'édition section par section, et fournit, en haut et à gauche, trois flèches (gauche, haut, droite) permettant la navigation entre sections.

Mise en forme

Pour mettre en forme du texte, utilisez les apostrophes droites :

 ''italique''
 '''graisse'''
 '''''italique et graisse'''''

Pour le style surligné de GeneWeb, vert gras par défaut, utilisez les accolades : {texte}

Pour indenter un texte, utilisez les deux-points en début de ligne, autant de fois que nécessaire :

:Première indentation
::Seconde indentation

Pour forcer un retour à la ligne, laissez une ligne vide ou utilisez la balise HTML <br />.

Les lignes commençant par un espace sont affichées tel-quel, pourvu que :

  • il y ait au moins deux lignes
  • il y ait une ligne vide avant le groupe de lignes.

Listes

Créez une liste en insérant un astérisque en début de ligne, indentez avec plusieurs astérisques :

* puce de niveau 1
** puce de niveau 2
*** puce de niveau 3
  • puce de niveau 1
    • puce de niveau 2
      • puce de niveau 3

On peut mélanger liste et indentation :

* puce niveau 1
** puce niveau 2
:: second paragraphe niveau 2
:* seconde puce niveau 2
  • puce niveau 1
    • puce niveau 2
second paragraphe niveau 2
  • seconde puce niveau 2

Les listes peuvent être numérotées :

# puce de niveau 1
## puce de niveau 2
### puce de niveau 3
# puce de niveau 1
  1. puce de niveau 1
    1. puce de niveau 2
      1. puce de niveau 3
  2. puce de niveau 1

Liens internes

Vous pouvez créer un lien vers une page (document texte+HTML+WikiText) en la mettant entre trois crochets :

[[[page_cible]]]

Pour changer le texte du lien, ajoutez une barre oblique suivi du texte voulu :

[[[page_cible/texte du lien]]]

Si la page n’existe pas, le lien apparaît en couleur rouge. En cliquant sur le lien, vous arriverez sur une page vide que vous pourrez alors remplir.

On peut organiser les pages en dossiers en préfixant le nom de la page par un nom de dossier :

[[[Dossier:page_cible/texte du lien]]]

On peut créer un lien vers une page magicien avec la syntaxe :

[[w:Magicien]] ou [[w:Magicien/Nom complet du magicien]]

Pour créer un lien vers un individu, utilisez la syntaxe :

[[prénom/nom/numéro/texte du lien]]

Par exemple : [[Estienne/Galichon/0/Fiche Estienne Galichon]]

GeneWeb maintient à jour la liste des pages ou notes où un individu apparait. Cette information est accessible sur la page de chaque individu sous le lien (pages liées) ((m=LINKED;p=prénom;n=nom) (voir l'exemple Bernard test ci-dessous). L’outil update_nldb permet de recalculer cet index croisé.

Renvoi vers une page

Quand une page contient des liens vers des individus, GeneWeb peut rajouter un lien vers cette page à un certain nombre d'endroits dans les fiches de ces individus :

  • HEAD= : en-dessous du nom ;
  • OCCU= : à la fin de la partie état-civil ;
  • DEATH= : à la fin de la ligne décès, entre parenthèses ;
  • BIBLIO= : en pied de page comme bibliographie, après les sources ;
  • BNOTE= : au début des notes.
  • NOTE= : à la fin des notes.

Le lien vers la page apparait sous le texte_du_lien compris entre ; et ]] dans le lien vers l'individu, ou sous la seule partie entre accolades {texte_du_lien} si elle est présente. Si le caractère * est présent, il est remplacé par le contenu du tag (Attention, les espaces avant et après le * sont pris en compte).

S'il n'y a pas de texte_du_lien (; seul), le lien vers la page n'apparaît pas dans la fiche de l'individu. (Cela sert, entre autres, pour le lien vers le magicien responsable de la note).

Le contenu de la page elle-même suit les conventions du wikitext. La page doit impérativement comporter un titre pour fonctionner et le ou les tags doivent apparaitre immédiatement après le titre.

Voici quelques exemples typique de l'usage de ce genre de pages :

TITLE=Liste des anciens élèves de l'ECP
NOTE=<li>ECP

[[Henri/Duchmoll;]] Responsable de cette page<br>
[[Bernard/Test/Test, Bernard;* 1967]] directeur chez Citroën, 1967<br>
[[Boris/Vian;* 1942a]], ingénieur, écrivain, musicien, 1942A<br>

La mention "ECP année de promo" apparaîtra en fin de notes sur les fiches des personnes listées (sauf la première) marqué par un boulet de liste (présence du <li> dans le tag NOTE).

TITLE=Liste des Morts Pour La France
DEATH=MPLF

[[Henri/Duchmoll;]] Responsable de cette liste<br>
[[Jean/Test/Test, Jean;*]] fusillé au Mont Valérien en 1943.<br>
[[Jacques/Dupont;*]], Lieutenant, tombé à la bataille de la Somme en 1915<br>

Pour cette liste, la mention (MPLF) apparaîtra après les indications de décès des fiches individuelles des personnes listées. Les mentions "fusillés au Mont Valérien en 1943" et "Lieutenant, ..." ne sont là que pour rendre la liste elle-même visualisable de façon autonome.

Dans le cas où un individu est présent sur plusieurs pages liées, les informations correspondantes apparaissent aux endroits prévus séparées par des virgules (,), sauf bien sur si des tags HTML, comme des <li> ou des <br> ont été insérés dans les zones de texte appropriées comme cela est montré dans le cas de la liste des élèves ECP.

D'autres exemples de listes gérées avec ce mécanisme sont disponibles sur le site Roglo.

 TITLE=Test2
 HEAD=baron d'Empire
 OCCU=maire de Thionville
 DEATH=raison inconnue
 BIBLIO=documentation personnelle
 BNOTE=remarque de début de note
 NOTE=remarque de fin de note

[[Henri/Gouraud;]] Responsable de cette page<br>
[[Bernard/Test/Test, Bernard;* texte_du_lien]] texte 2<br>
[[Charlotte/Test/Test, Charlotte;voir  en complément une {page} d'explications]] texte 3<br>

L'exemple ci-dessus donnera le résultat suivant sur la fiche d'un Bernard Test :

Bernard-Test.png

Caractères spéciaux

Tous les caractères utilisés par la syntaxe peuvent être écrit dans les notes ou sur le forum précédé d’un % :

  • %' donne ' ;
  • %} et %{ donnent } et { ;
  • %] et %[ donnent ] et [ ;
  • %% donne %.

Manuel GeneWeb

Rembrandt Old Man Reading a Book.jpg

Utiliser et gérer une base généalogique

Annexe technique