La syntaxe wiki de GeneWeb
Error creating thumbnail: File missing 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 :
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
- puce de niveau 2
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
- puce de niveau 1
- puce de niveau 2
- puce de niveau 3
- puce de niveau 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 :
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
- Télécharger et installer GeneWeb sous GNU/Linux, Mac OS X, Microsoft Windows, FreeBSD ou en mode CGI derrière un serveur web.
- Comprendre le principe du serveur GeneWeb, les homonymes, la consanguinité.
Utiliser et gérer une base généalogique
- Importer un fichier Gedcom
.ged
ou GeneWeb.gw
avec gwsetup ou en lignes de commandes. - Mettre à jour les données (ajouter/modifier/supprimer personnes et familles), fusionner les doublons, saisir des dates.
- Utiliser la syntaxe wikitext, les macros, les raccourcis claviers.
- Nettoyer, restaurer, renommer, sauvegarder, archiver une base.
- Fusionner plusieurs bases et diviser une base.
Annexe technique
- Personnaliser avec CSS, entête et pieds de page, templates, lexique et déclinaisons.
- Fichier de configuration
.gwf
(pour templm), mots de passe pour amis et magiciens et restrictions d'accès à une base. - Ajouter une image dans les notes.
- Autres commentaires pour les experts.