Syntaxe d'édition de base

authors (basic)

Les pages de ce site sont des pages WikiWikiWeb, ce qui signifie que ces pages peuvent être créées et éditées par plusieurs auteurs. Pour éditer une page, cliquez simplement sur le lien Éditer qui existe quelque part dans la page, habituellement dans l'en-tête ou le pied de page. Quelques pages peuvent être protégées par mot de passe, en fonction de la politique de sécurité, mais beaucoup de sites permettent la libre édition de pages.

PmWiki n'est pas WYSIWYG. Lorsque vous éditez une page, vous voyez les balises qui décrivent le contenu de la page. Les règles de base pour le balisage de la page sont très simples :

  1. Mettez une ligne vide entre chaque paragraphe.
  2. Pour faire une liste, commencez chaque ligne avec # pour une liste numérotée ou * pour une liste avec des puces.
  3. Pour faire des titres de sections, commencez une ligne par deux ou plusieurs points d'exclamation; !! est un titre de section, et !!! est un sous-titre.
  4. Pour mettre en valeur du texte, entourez le de 2 ou 3 apostrophes; ''texte'' pour la mise en italique ou '''texte''' pour la mise en gras.
  5. Pour créer un lien vers une autre page, entourez son nom par des crochets doubles; par exemple [[basic editing]] crée un lien vers cette page. Un lien vers une page inexistante est affiché de façon différente, pour inviter d'autres à créer la page.
  6. Pour faire un lien vers un autre site, tapez son adresse, comme http://www.exemple.com/. Les liens de messagerie doivent commencer par "mailto:" comme mailto:xyz@example.com

Si vous voulez expérimenter avec l'édition de page, essayez sur Bac à sable. Vous pouvez éditer le bac à sable sans affecter des choses importantes sur ce site. Dans les pages de discussion, il est poli de signer sa contribution grâce à la balise ~~~ qui signe effectivement la page avec le nom fourni dans le champ Auteur du formulaire d'édition.

Exemples de balisage courant

Les tableaux ci-dessous font la démonstration des balises les plus communément utilisées pour la mise en page. La colonne de gauche indique ce qu'il faut écrire pour parvenir à un effet, celle de droite montre le résultat obtenu. Plus de détails sont disponibles sur la page des règles de formatage et les autres pages de la documentation. Une liste exhaustive des balises par défaut est disponible sur l'index des balises.

Paragraphes et sauts de ligne

Ce qu'il faut saisir

Comment cela apparaît

Les lignes consécutives
seront fusionnées
pour former le même paragraphe.

Une ou plusieurs lignes vides commencent un nouveau paragraphe.

Les lignes consécutives seront fusionnées pour former le même paragraphe.

Une ou plusieurs lignes vides commencent un nouveau paragraphe.

Deux barres obliques en fin de ligne\\
forcent un saut de ligne.

La balise [[<<]] force également un saut de ligne.

Deux barres obliques en fin de ligne
forcent un saut de ligne.

La balise
force également un saut de ligne.

Plus d'information :

  • Règles de mise en forme pour plus d'information sur les sauts de ligne et les paragraphes.
  • WikiStyles pour des paragraphes centrés ou justifiés à droite, pour du texte (blocs) flottant, pour des bordures et plus.

Listes

Commencez chaque ligne avec # pour listes numérotées ou avec * pour listes à puces :

Ce qu'il faut saisir

Comment cela apparaît

* Liste à puces
* Autre élément
** Plus d'astérisques pour des listes imbriquées
** etc.
  • Liste à puces
  • Autre élément
    • Plus d'astérisques pour des listes imbriquées
    • etc.
# Liste numérotée
# Autre élément
## Plus de dièses pour des listes imbriquées
  1. Liste numérotée
  2. Autre élément
    1. Plus de dièses pour des listes imbriquées
# Des listes différentes
# peuvent être imbriquées
** liste numérotée avec liste à puce imbriquée
  1. Des listes différentes
  2. peuvent être imbriquées
    • liste numérotée avec liste à puce imbriquée

Pour plus d'information, listes, (y compris listes de définition) et ListStyles.

Titres de section

Les titres permettent de créer des pages bien structurées. Ils ne servent pas à créer des textes plus grands.

Ce qu'il faut saisir

Comment cela apparaît

!! Titre majeur
!!! Sous-titre
!!!! Et d'autres
!!!!! Sous-titres

Titre majeur

Sous-titre

Et d'autres

Sous-titres

À partir de PmWiki 2.5.5, vous pouvez définir les identifiants des titres :

!!#usage Usage
!!#changelog Journal des modifications

Usage

Journal des modifications

(No space between "!" and "#".) These identifiers can be used like anchors to link to a specific heading like [[Page#usage]], and from the table of contents. (Pas d'espace entre "!" et "#".) Ces identifiants peuvent être utilisés comme des ancres pour créer un lien vers un titre spécifique comme [[Page#usage]], et à partir de la Table des matières.

Texte mis en valeur

Pour mettre le texte en valeur, entourez-le d'apostrophes (et non de guillemets doubles).

Ce qu'il faut saisir

Comment cela apparaît

''En valeur'' (italique),
'''fortement''' (en gras), 
'''''très fortement''''' (italique en gras).

En valeur (italique), fortement (en gras), très fortement (italique en gras).

Liens

Pour créer un lien vers une autre page, entourez le nom de la page en crochets doubles.

Ce qu'il faut saisir

Comment cela apparaît

Expérimentez dans le [[wiki sandbox]].

Expérimentez dans le wiki sandbox.

Notez que la première lettre de chaque mot sera mise en majuscule pour le nom de page. Le lien [[wiki sandbox]] mènera vers la page WikiSandbox..

On peut spécifier un texte du lien après une barre verticale (|) :

Expérimentez dans [[WikiSandbox | l'aire de jeux ]].

Expérimentez dans l'aire de jeux.

Les terminaisons font partie du texte du lien, les parenthèses masquent des parties du nom du lien :

[[wiki sandbox]]es.

[[(wiki) sandbox]].

wiki sandboxes.

sandbox.

Pour un lien vers une page d'un WikiGroupe différent, un séparateur, point ou barre oblique, est placé entre le groupe et la page:

[[PmWikiFr.WikiSandbox]] montre le groupe et le nom de la page.

[[PmWikiFr/WikiSandbox]] ne montre que le nom.

PmWikiFr.WikiSandbox montre le groupe et le nom de la page.

WikiSandbox ne montre que le nom.

Liens vers des sites externes :

adresse seule :  http://www.pmwiki.org

avec un texte : [[http://www.pmwiki.org | PmWiki ]]

adresse seule : http://www.pmwiki.org

avec un texte : PmWiki

Liens sous forme de références numérotées automatiquement

[[https://www.pmwiki.org|#]], [[Main.HomePage|#]]

[1], [2]

Pour ajouter un titre d'infobulle à un lien, placez-le entre guillemets après le nom de la page ou l'URL :

Passez votre curseur sur les liens pour afficher l'infobulle.
* [[Documentation Index"Retournez à notre centre d'aide"]]
* [[https://www.pmwiki.org"Système de gestion de contenu collaboratif basé sur un wiki" | PmWiki]]

Passez votre curseur sur les liens pour afficher l'infobulle.

Les deux-points permettent de créer des liens InterMap (également appelé InterWiki) vers d'autres wikis :

Qu'est-ce qu'un [[Wikipedia:aardvark]], au juste ? Liens Wiki vers d'autres wikis :

Qu'est-ce qu'un Wikipedia:aardvark, au juste ? Liens Wiki vers d'autres wikis :

Liens vers des pages inexistantes s'affichent de façon différente pour inviter d'autres éditeurs à les créer.

PmWiki permet d'autres types de liens et d'affichages, voyez Liens pour plus d'information.

Séquence d'échappement

Si vous ne souhaitez pas que le balisage Wiki soit traité, mais que les lignes soient reformatées, utilisez [= =]. Peut également être utilisé directement dans le texte.

[=
le balisage n'est ''pas'' traité
mais les lignes sont reformatées.
=]

le balisage n'est ''pas'' traité mais les lignes sont reformatées.

Texte préformaté

Le texte préformaté est affiché avec une police à chasse fixe et ne génère pas de sauts de ligne sauf là où cela est explicitement indiqué dans le balisage.

Notez que les lignes de texte préformatées très longues peuvent rendre la page entière large.

Pour un texte préformaté avec des balises de mise en forme (par exemple en gras), commencez chaque ligne par un espace :

 Un espace en début de ligne affichera
 les lignes   comme elles sont saisies
   dans une '''police à chasse fixe'''.
 Un espace en début de ligne affichera
 les lignes   comme elles sont saisies
   dans une police à chasse fixe.

Si vous ne souhaitez pas que le balisage Wiki soit traité, utilisez [@ @]. Peut également être utilisé directement dans le code.

[@
Le texte échappé de cette manière a
le style ''code'' HTML
@]
Le texte échappé de cette manière a
le style ''code'' HTML

Vous pouvez également utiliser la séquence d'échappement escape précédée d'un espace sur la première ligne.

 [=La '''séquence d'échappement''',
précédée d'un ou plusieurs espaces sur la première ligne,
est     affichée      préformatée.=]
 La '''séquence d'échappement''',
précédée d'un ou plusieurs espaces sur la première ligne,
est     affichée      préformatée.

Vous pouvez activer la mise en évidence du code code highlighting pour les blocs préformatés avec les versions récentes de PmWiki.

Ligne horizontale

Quatre tirets ou plus en 
début de ligne créent 
----
une "ligne horizontale"

Quatre tirets ou plus en début de ligne créent


une "ligne horizontale"

Tableaux

Les tableaux simples utilisent deux barres verticales pour séparer les cellules :

|| border=1
||! entête 1  ||! entête 2  ||! entête 3  ||
|| cellule 1  ||  cellule 2 ||  cellule 3 ||
entête 1entête 2entête 3
cellule 1cellule 2cellule 3

Voyez les tableaux simples et avancés pour plus d'information.

Images

Voyez Images pour plus d'information.

Mise en forme de caractères

Ce qu'il faut saisir

Comment cela apparaît

* @@Texte à chasse fixe@@
* Texte avec '^exposant^'
* Texte avec '_indice_' : H'^+^''_2_'O'^2+^'
* Texte effacé {-barré-}
* Texte inséré {+souligné+}
* Texte [+grand+], [++plus grand++]
* Texte [-petit-], [--plus petit--]
  • Texte à chasse fixe
  • Texte avec exposant
  • Texte avec indice : H+2O2+
  • Texte effacé barré
  • Texte inséré souligné
  • Texte grand, plus grand
  • Texte petit, plus petit

Utilisez les Styles Wiki pour changer la couleur du texte .

Titres des pages

La directive (:title:) définit le titre de la page sur une valeur différente de son nom.

(:title Règles de base d'édition de PmWiki:)
Le nom de cette page est "{$Name}" et son titre est "{$Title}".

Le nom de cette page est "BasicEditing" et son titre est "Syntaxe d'édition de base".

Description des pages

  • La directive (:Description Description de la page:) définit la description de la page. Cette description est utilisée par les moteurs de recherche et peut être affichée dans les résultats de recherche et dans les page lists.
(:Description Règles de base d'édition de PmWiki:)
Le résumé de cette page est : "{$Description}".

Le résumé de cette page est : "Règles de base d'édition de PmWiki".

Résumé de la page

(:Summary : Syntaxe d'édition de base:)
Le résumé de cette page est ''{$:Summary}''.

Le résumé de cette page est Syntaxe d'édition de base.

FAQ

Je suis novice sur PmWiki, où puis-je trouver de l'aide de base pour débuter ?

La page Basic Editing est un bon point de départ. À partir de là, vous pouvez simplement suivre les liens de navigation en haut ou en bas de la page (appelés Wiki Trails) pour accéder aux pages suivantes, ou à la page Documentation Index, qui propose un index structuré des pages de documentation essentielles, classées du niveau débutant au niveau avancé.

Comment insérer des caractères spéciaux comme Copyright (©) et Marque déposée (® ou ™) sur mes pages wiki ?

Consultez la section special characters pour savoir comment insérer des caractères spéciaux qui ne figurent pas sur votre clavier.

Comment conserver les sauts de ligne du texte source ?

PmWiki considère généralement les lignes de texte consécutives comme un paragraphe et les fusionne et les ajuste à la ligne lors de l'affichage. Ce comportement est conforme à celui de la plupart des autres packages wiki. Un auteur peut utiliser la directive `(:linebreaks:)` pour que les lignes de texte balisées suivantes soient conservées comme des lignes distinctes dans le rendu. Un administrateur wiki peut également définir dans le fichier config.php la ligne `$EnablePreserveLineBreaks = 1;` pour activer les sauts de ligne par défaut.

Puis-je saisir directement du code HTML ?

Par défaut (et intentionnellement), PmWiki ne prend pas en charge l’utilisation d’éléments HTML dans le balisage modifiable des pages wiki. Plusieurs raisons expliquent ce choix, décrites dans la section PmWiki Philosophy et Audiences. Activer le balisage HTML dans les pages wiki au sein d’un environnement collaboratif peut empêcher certains auteurs potentiels de modifier les pages et poser des problèmes d’affichage et de sécurité. Toutefois, un administrateur du site peut utiliser la recette Cookbook:Enable HTML pour activer l’utilisation du balisage HTML directement dans les pages.

Comment masquer la barre latérale pendant l’édition ?

Modifiez Site.EditForm et ajoutez la directive (:noleft:), voir page directives. Certains thèmes peuvent utiliser une directive différente (:noright:) ou une page de formulaire d’édition différente ; consultez leur documentation.

Où puis-je trouver plus de documentation ?

Consultez les pages Index de la documentation et markup master index.



Traduction de PmWiki.BasicEditing Page originale sur PmWikiFr.BasicEditing - Référencé par
Dernières modifications:
PmWikiFr.BasicEditing: 22 mai 2026 à 14h57
PmWiki.BasicEditing: 01 février 2026 à 09h59