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:24] – [Autres mises en forme avec une syntaxe simple] 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.
  
-Nous allons maintenant mettre les références sur une nouvelle ligne en dessous du texte. Pour cela nous devons forcer à faire un saut de ligne. Dans la foulée, on va rassembler la citation en forçant, là aussi, un saut de ligne. Précédemment, une note nous indiquait que si on laisse une ligne vide, le texte est séparé en 2 paragraphes, mais que si l'on fait qu'un seul saut de ligne dans le code source, le texte se poursuit à la suite, sur la même ligne dans le rendu. Donc une syntaxe s'impose pour faire cela. C'est à ce moment-là que nous constatons qu'il n'y a pas de bouton dans la barre d'outils pour le faire ! Il faudra donc le faire manuellement. En cherchant un peu, on trouve les explications de cette fonction pour "forcer un saut de ligne" sur la page : [[Mise en forme de texte basique]]. Là, on nous dit : "tu peux utiliser deux contre-obliques suivies par un espace ou une fin de ligne". Ajoutons donc ces deux contre-obliques là (''%%\\%%'') ou nous voulons forcer les saut de ligne.+Nous allons maintenant mettre les références sur une nouvelle ligne en dessous du texte. Pour cela nous devons forcer à faire un saut de ligne. Dans la foulée, on va rassembler la citation en forçant, là aussi, un saut de ligne. Précédemment, une note nous indiquait que si on laisse une ligne vide, le texte est séparé en 2 paragraphes, mais que si l'on fait qu'un seul saut de ligne dans le code source, le texte se poursuit à la suite, sur la même ligne dans le rendu. Donc une syntaxe s'impose pour faire cela. C'est à ce moment-là que nous constatons qu'il n'y a pas de bouton dans la barre d'outils pour le faire ! Il faudra donc le faire manuellement. En cherchant un peu, on trouve les explications de cette fonction pour "forcer un saut de ligne" sur la page : [[Mise en forme de texte basique]]. Là, on nous dit : "tu peux utiliser deux contre-obliques suivies par un espace ou une fin de ligne". Ajoutons donc ces deux contre-obliques (''%%\\%%'') aux endroits où nous voulons forcer les sauts de ligne.
  
 On va le faire pour la première référence comme ceci : On va le faire pour la première référence comme ceci :
Ligne 293: Ligne 294:
  
  
-<wrap tip>Il faut que je pense à ajouter un bouton "forcer un saut de ligne" dans la barre d'outil 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 première ligne du paragraphe. 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.
  
 Du même coup, on va aussi retirer les guillemets de cette citation et la mettre en italique en l'encadrant par des doubles barres obliques. Du même coup, on va aussi retirer les guillemets de cette citation et la mettre en italique en l'encadrant par des doubles barres obliques.
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 :
  
-__Voici un code source de teste :__+__Voici un code source de test :__
  
 <code> <code>
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.1675203855.txt.gz · Dernière modification : 31.01.2023 @ 23:24 de Chewbacca