Wiki Libertaire des Montagnes

Outils pour utilisateurs

Outils du site

aide:syntaxe:introduction_a_la_syntaxe

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
aide:syntaxe:introduction_a_la_syntaxe [31.01.2023 @ 23:41] – [Exemple de traitement des liens externes] Chewbaccaaide:syntaxe:introduction_a_la_syntaxe [22.04.2023 @ 20:24] (Version actuelle) – [Exemple de traitement des sauts de ligne simple] Chewbacca
Ligne 2: Ligne 2:
 ====== Aide:Syntaxe:Introduction à la syntaxe ====== ====== Aide:Syntaxe:Introduction à la syntaxe ======
  
-{{howhard>2}} En informatique, la syntaxe dicte la grammaire formelle d'un langage, c'est-à-dire des règles d'agencement. Cela permet à un programme d'analyser le texte source et d'y appliquer les volontés de celui qui l'a rédigé.+{{howhard>2}} En informatique, la syntaxe dicte la grammaire formelle d'un langage, c'est-à-dire des règles d'agencement. Cela permet à un programme d'analyser le texte source et d'y appliquer les volontés du rédacteur (tes volontés).
  
-Si tu es novice, tu ne devrais pas avoir de difficultés car ces syntaxes s'appliquent en surplus de ton texte et tu n'es pas obligé de l'utiliser, ni de l'apprendre !+Si tu es novice, tu ne devrais pas avoir de difficultés car ces syntaxes s'appliquent en surplus de ton texte et tu n'es pas obligé de les utiliser, ni de les apprendre !
  
 Pour les exemples ci-après, on utilisera ce petit texte : Pour les exemples ci-après, on utilisera ce petit texte :
Ligne 80: Ligne 80:
 ===== Autres mises en forme sans syntaxe ===== ===== Autres mises en forme sans syntaxe =====
  
-<wrap info>Article détaillé : [[Conversions textuelles]].</wrap>+<wrap center info> Article détaillé : [[Conversions textuelles]]. </wrap> 
  
 D'autres éléments dans ton texte "normal" peuvent être reconnus et directement mis en forme. D'autres éléments dans ton texte "normal" peuvent être reconnus et directement mis en forme.
Ligne 102: Ligne 103:
 ===== Exemple avec une syntaxe simple ===== ===== Exemple avec une syntaxe simple =====
  
-<wrap info>Article détaillé : [[Mise en forme de texte basique]].</wrap>+<wrap center info>Article détaillé : [[Mise en forme de texte basique]].</wrap>
  
 Nous avons donc un petit texte, mais voilà, on se dit que finalement, on pourrait alléger ce texte en mettant certains passages en italique au lieu d'utiliser des guillemets. Nous avons donc un petit texte, mais voilà, on se dit que finalement, on pourrait alléger ce texte en mettant certains passages en italique au lieu d'utiliser des guillemets.
Ligne 169: Ligne 170:
 ===== Autres mises en forme avec une syntaxe simple ===== ===== Autres mises en forme avec une syntaxe simple =====
  
-<wrap info>Article détaillé : [[Mise en forme de texte basique]].</wrap>+<wrap center info>Article détaillé : [[Mise en forme de texte basique]].</wrap>
  
 Tu procéderas de la même manière pour les autres mises en forme basique. Surligne le texte désiré avec la souris puis clique sur le bouton de la barre d'outils. Tu procéderas de la même manière pour les autres mises en forme basique. Surligne le texte désiré avec la souris puis clique sur le bouton de la barre d'outils.
Ligne 240: Ligne 241:
 ===== Exemple de traitement des sauts de ligne simple ===== ===== Exemple de traitement des sauts de ligne simple =====
  
-<wrap info>Article détaillé : [[Mise en forme de texte basique]].</wrap>+<wrap center info>Article détaillé : [[Mise en forme de texte basique]].</wrap>
  
 Jusque là, nous avons vu des syntaxes constituées de symboles ou de balises qui encadrent du texte avec une ouverture et une fermeture. Ce que nous allons voir ici est un peu différent. Jusque là, nous avons vu des syntaxes constituées de symboles ou de balises qui encadrent du texte avec une ouverture et une fermeture. Ce que nous allons voir ici est un peu différent.
Ligne 293: Ligne 294:
  
  
-<wrap tip>Il faut que je pense à ajouter un bouton "forcer un saut de ligne" dans la barre d'outils afin de t'aider.</wrap>+<wrap center tip>Il faut que je pense à ajouter un bouton "forcer un saut de ligne" dans la barre d'outils afin de t'aider.</wrap>
  
  
 ===== Exemple de traitement des citations ===== ===== Exemple de traitement des citations =====
  
-<wrap info>Article détaillé : [[Les citations]].</wrap>+<wrap center info>Article détaillé : [[Les citations]].</wrap>
  
 Notre texte prend gentiment forme. Cependant, je ne suis pas du tout satisfait de la mise en forme de la citation. Puisqu'elle est constituée en un paragraphe, il faudrait la détacher du reste, la mettre en exergue. Il existe justement une syntaxe pour le faire. En fait, une citation de ce genre pourrait aussi se mettre dans une boîte. Mais là on va en rester avec la syntaxe de base de DokuWiki. Là encore, il n'y a pas de bouton dans la barre d'outils. On cherche un peu et on trouve rapidement la page : [[Les citations]]. Là on nous montre que pour une citation, il faut simplement mettre un chevron (''%%>%%'') au début de la ligne. La citation prend fin à la fin de la ligne. Notre texte prend gentiment forme. Cependant, je ne suis pas du tout satisfait de la mise en forme de la citation. Puisqu'elle est constituée en un paragraphe, il faudrait la détacher du reste, la mettre en exergue. Il existe justement une syntaxe pour le faire. En fait, une citation de ce genre pourrait aussi se mettre dans une boîte. Mais là on va en rester avec la syntaxe de base de DokuWiki. Là encore, il n'y a pas de bouton dans la barre d'outils. On cherche un peu et on trouve rapidement la page : [[Les citations]]. Là on nous montre que pour une citation, il faut simplement mettre un chevron (''%%>%%'') au début de la ligne. La citation prend fin à la fin de la ligne.
Ligne 346: Ligne 347:
 ===== Exemple de traitement des liens externes ===== ===== Exemple de traitement des liens externes =====
  
-<wrap info>Article détaillé : [[Les liens]].</wrap>+<wrap center info>Article détaillé : [[Les liens]].</wrap>
  
 Un élément important que nous n'avons pas encore abordé est la mise en forme des liens. On a vu que les liens sont déjà reconnus sans l'utilisation de syntaxe. faisons quelques essais : Un élément important que nous n'avons pas encore abordé est la mise en forme des liens. On a vu que les liens sont déjà reconnus sans l'utilisation de syntaxe. faisons quelques essais :
Ligne 372: Ligne 373:
 Test 6 : https://fr.wikipedia.org/wiki/L'Incroyable_Hulk Test 6 : https://fr.wikipedia.org/wiki/L'Incroyable_Hulk
  
-On constate qu'ils ne sont pas tous reconnus ou pas toujours correctement. Pour être reconnu, le lien doit commencer par ''%%http://%%'', ''%%https://%%'' ou  ''%%www%%''. D'autre part, le test 5 est bon, mais l'apostrophe est remplacé par un ''%27'' qui n'est pas très esthétique. Pour le test 6, l'apostrophe "esthétique" à coupé le lien. Celui-ci renvoie alors à la page de la lettre **L** (12<sup>ème</sup> lettre et la 9<sup>ème</sup> consonne de l'alphabet latin) sur Wikipédia alors que l'on voulait initialement aller sur la page de "L'Incroyable Hulk".+On constate qu'ils ne sont pas tous reconnus ou pas toujours correctement. Pour être reconnu, le lien doit commencer par ''%%http://%%'', ''%%https://%%'' ou  ''%%www%%''. D'autre part, le test 5 est bon, mais l'apostrophe est remplacé par un ''%27'' qui n'est pas très esthétique. Pour le test 6, l'apostrophe "esthétique" a coupé le lien. Celui-ci renvoie alors à la page de la lettre **L** (12<sup>ème</sup> lettre et la 9<sup>ème</sup> consonne de l'alphabet latin) sur Wikipédia alors que l'on voulait initialement aller sur la page de "L'Incroyable Hulk".
  
 Du coup, je te recommande vivement d'utiliser la syntaxe des liens pour tous les liens. Elle est simple et elle permet d'éviter des erreurs. La syntaxe de lien est composé de doubles crochets comme ceci : ''%%[[%%''ADRESSE_DU_LIEN''%%]]%%''. Cette syntaxe permet aussi de mettre un texte de substitution. L'adresse du lien est alors séparée par une barre verticale (''%%|%%'') comme ceci : ''%%[[%%''ADRESSE_DU_LIEN''%%|%%''TEXTE DE SUBSTITUTION''%%]]%%''. Du coup, je te recommande vivement d'utiliser la syntaxe des liens pour tous les liens. Elle est simple et elle permet d'éviter des erreurs. La syntaxe de lien est composé de doubles crochets comme ceci : ''%%[[%%''ADRESSE_DU_LIEN''%%]]%%''. Cette syntaxe permet aussi de mettre un texte de substitution. L'adresse du lien est alors séparée par une barre verticale (''%%|%%'') comme ceci : ''%%[[%%''ADRESSE_DU_LIEN''%%|%%''TEXTE DE SUBSTITUTION''%%]]%%''.
Ligne 427: Ligne 428:
 ===== Exemple de traitement des références ===== ===== Exemple de traitement des références =====
  
-<wrap info>Article détaillé : [[Notes de pied de page]].</wrap>+<wrap center info>Article détaillé : [[Notes de pied de page]].</wrap>
  
 Nous arrivons au terme de cette page d'introduction à la syntaxe. J'espère qu'elle t'aura permis de comprendre un peu ces notions de base. Mais avant de se quitter, nous allons terminer la mise en forme de notre petit texte d'exemple, en mettant en forme les références. Nous arrivons au terme de cette page d'introduction à la syntaxe. J'espère qu'elle t'aura permis de comprendre un peu ces notions de base. Mais avant de se quitter, nous allons terminer la mise en forme de notre petit texte d'exemple, en mettant en forme les références.
aide/syntaxe/introduction_a_la_syntaxe.1675204875.txt.gz · Dernière modification : 31.01.2023 @ 23:41 de Chewbacca