Outils pour utilisateurs

Outils du site


aide:syntaxe:introduction_a_la_syntaxe

Ceci est une ancienne révision du document !




Aide:Syntaxe:Introduction à la syntaxe

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é.

Si tu es novice, tu ne devrais pas avoir de difficultés car ces syntaxes s'applique en surplus de ton texte et tu n'es pas obliger de l'utiliser, ni de l'apprendre !

Pour les exemples ci-après, on utilisera ce petit texte :

“La grande question sur la vie, l'Univers et le reste” (en anglais : The Ultimate Question of Life, the Universe and Everything) est, dans l'œuvre de science-fiction de Douglas Adams “Le Guide du voyageur galactique”, la question ultime sur le sens de la vie. Une réponse est proposée : “42”, mais le problème est que personne ne sait précisément à quelle question précise elle répond. Dans l'histoire, la réponse est cherchée par le super-ordinateur “Pensées profondes” (“Deep Thought” en version originale et “Grand Compute” Un dans les anciennes éditions). Cependant, celui-ci n'était pas assez puissant pour fournir la question ultime après avoir calculé la réponse durant 7,5 millions d'années. La réponse de “Pensées profondes” embarque les protagonistes dans une quête pour découvrir la question qui y correspond. (Extrait légèrement modifié issue de Wikipédia : https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

“Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous montrer au bout de sept millions et demi d'années de boulot ?”

“— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est incontestablement la réponse exacte. Je crois que le problème, pour être tout à fait franc avec vous, est que vous n'avez jamais vraiment bien saisi la question.” (Douglas Adams, “Le Guide du voyageur galactique”, p. 232.)

Exemple sans syntaxe

Il est possible de publier ce texte tel quel. Celui-ci ne contient aucune syntaxe. C'est juste un texte. Cependant, tu peux constater que l'adresse web est automatiquement reconnu et qu'il s'affiche comme un lien. Tu peux également voir qu'en laissant une ligne vide entre 2 blocs de texte, ceux-ci se séparent naturellement en paragraphe. Donc en ayant rien fait de spéciale, il y a déjà une certaine mise en forme qui s'est faite.

:!: Note qu'un simple retour à la ligne (sans laisser une ligne vide) ne sera pas pris en compte. Le texte sera continu.

Voici le code source :

"La grande question sur la vie, l'Univers et le reste" (en anglais : The 
Ultimate Question of Life, the Universe and Everything) est, dans 
l'œuvre de science-fiction de Douglas Adams "Le Guide du voyageur 
galactique", la question ultime sur le sens de la vie. Une réponse est 
proposée : "42", mais le problème est que personne ne sait précisément 
à quelle question précise elle répond. Dans l'histoire, la réponse est 
cherchée par le super-ordinateur "Pensées profondes" ("Deep Thought" en 
version originale et "Grand Compute" Un dans les anciennes éditions). 
Cependant, celui-ci n'était pas assez puissant pour fournir la question 
ultime après avoir calculé la réponse durant 7,5 millions d'années. La 
réponse de "Pensées profondes" embarque les protagonistes dans une quête 
pour découvrir la question qui y correspond. (Extrait légèrement modifié 
issue de Wikipédia : 
https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

"Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous 
montrer au bout de sept millions et demi d'années de boulot ?"

"— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est 
incontestablement la réponse exacte. Je crois que le problème, pour être 
tout à fait franc avec vous, est que vous n'avez jamais vraiment bien 
saisi la question." 
(Douglas Adams, "Le Guide du voyageur galactique", p. 232.)

Voici le résultat :

“La grande question sur la vie, l'Univers et le reste” (en anglais : The Ultimate Question of Life, the Universe and Everything) est, dans l'œuvre de science-fiction de Douglas Adams “Le Guide du voyageur galactique”, la question ultime sur le sens de la vie. Une réponse est proposée : “42”, mais le problème est que personne ne sait précisément à quelle question précise elle répond. Dans l'histoire, la réponse est cherchée par le super-ordinateur “Pensées profondes” (“Deep Thought” en version originale et “Grand Compute” Un dans les anciennes éditions). Cependant, celui-ci n'était pas assez puissant pour fournir la question ultime après avoir calculé la réponse durant 7,5 millions d'années. La réponse de “Pensées profondes” embarque les protagonistes dans une quête pour découvrir la question qui y correspond. (Extrait légèrement modifié issue de Wikipédia : https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

“Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous montrer au bout de sept millions et demi d'années de boulot ?”

“— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est incontestablement la réponse exacte. Je crois que le problème, pour être tout à fait franc avec vous, est que vous n'avez jamais vraiment bien saisi la question.” (Douglas Adams, “Le Guide du voyageur galactique”, p. 232.)

Autres mises en forme sans syntaxe

Article détaillé : Conversions textuelles.

D'autres élément dans ton texte “normal peuvent être reconnus et directement mis en forme.

Ton texte Résultat
...
--
---
->
=>
(c) ©
:-) :-)
:-( :-(
=) =)

etc.

Ce sont quelques signes et symbole qui prennent forme directement. Tu ne devrais pas avoir de problème particulier avec ceci, ne te poser pas de question lors de la rédaction de ton texte. Rédige simplement ton texte normalement. Cependant, si tu as besoin de l'un de ces éléments, comme une flèche par exemple, la page conversions textuelles est à ta disposition.

Exemple avec une syntaxe simple

Article détaillé : Mise en forme de texte basique.

Nous avons donc un petit texte, mais voilà, on se dit que finalement, on pourrait alléger ce texte en mettant certain passage en italique au lieu d'utiliser des guillemets.

Tu as la possibilité de surligner la partie de ton texte que tu souhaite mettre en italique et de cliquer sur le bouton de la barre d'outils comme avec un logiciel de traitement de texte. Là, tu constateras que le texte ne s'est pas mis en italique dan l'éditeur ! En effet, au lieu de cela, tu as des choses qui sont apparues : //TON TEXTE//. Ceci est une syntaxe de WikiTexte (ou WikiCode).

Tu obtiendras le même résultat si tu mets les barres obliques manuellement. Pour le rendu de la page, l'analyseur saura qu'en rencontrant deux barres obliques qui se suivent directement (//), on demande à ce que le texte qui suit soit affiché en italique. L'analyseur saura également que lorsqu'il rencontrera une seconde fois deux barres obliques qui se suivent directement (//), on lui indique que c'est la fin du texte en italique.

Nous allons donc, dans notre texte mettre le nom du livre en italique au lui qu'il soit en entre guillemets.

Voici le code source :

"La grande question sur la vie, l'Univers et le reste" (en anglais : The 
Ultimate Question of Life, the Universe and Everything) est, dans 
l'œuvre de science-fiction de Douglas Adams //Le Guide du voyageur 
galactique//, la question ultime sur le sens de la vie. Une réponse est 
proposée : "42", mais le problème est que personne ne sait précisément 
à quelle question précise elle répond. Dans l'histoire, la réponse est 
cherchée par le super-ordinateur "Pensées profondes" ("Deep Thought" en 
version originale et "Grand Compute" Un dans les anciennes éditions). 
Cependant, celui-ci n'était pas assez puissant pour fournir la question 
ultime après avoir calculé la réponse durant 7,5 millions d'années. La 
réponse de "Pensées profondes" embarque les protagonistes dans une quête 
pour découvrir la question qui y correspond. (Extrait légèrement modifié 
issue de Wikipédia : 
https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

"Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous 
montrer au bout de sept millions et demi d'années de boulot ?"

"— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est 
incontestablement la réponse exacte. Je crois que le problème, pour être 
tout à fait franc avec vous, est que vous n'avez jamais vraiment bien 
saisi la question." 
(Douglas Adams, //Le Guide du voyageur galactique//, p. 232.)

Voici le résultat :

“La grande question sur la vie, l'Univers et le reste” (en anglais : The Ultimate Question of Life, the Universe and Everything) est, dans l'œuvre de science-fiction de Douglas Adams Le Guide du voyageur galactique, la question ultime sur le sens de la vie. Une réponse est proposée : “42”, mais le problème est que personne ne sait précisément à quelle question précise elle répond. Dans l'histoire, la réponse est cherchée par le super-ordinateur “Pensées profondes” (“Deep Thought” en version originale et “Grand Compute” Un dans les anciennes éditions). Cependant, celui-ci n'était pas assez puissant pour fournir la question ultime après avoir calculé la réponse durant 7,5 millions d'années. La réponse de “Pensées profondes” embarque les protagonistes dans une quête pour découvrir la question qui y correspond. (Extrait légèrement modifié issue de Wikipédia : https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

“Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous montrer au bout de sept millions et demi d'années de boulot ?”

“— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est incontestablement la réponse exacte. Je crois que le problème, pour être tout à fait franc avec vous, est que vous n'avez jamais vraiment bien saisi la question.” (Douglas Adams, Le Guide du voyageur galactique, p. 232.)

Autres mises en forme avec une syntaxe simple

Article détaillé : Mise en forme de texte basique.

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'outil.

Si tu veux mettre du texte en gras, utilise le bouton . Cela mettra ton texte entre deux paires d'étoile comme ceci : **TON TEXTE**. Le résultat donne : TON TEXTE.

Tu voudrais souligner du texte ? Pas de problème c'est toujours le même principe, mais cette fois-ci, le bouton est . le soulignement est représenté par deux paires de tiret bas : __TON TEXTE__. Le résultat donne : TON TEXTE.

Maintenant, essayons de barrer du texte. C'est encore et toujours le même principe. Cette fois c'est le bouton que tu utiliseras. Mais là, ce ne sont plus des symbole qui seront utilisé mais des balises comme ceci : <del>TON TEXTE</del>. Le résultat donne : TON TEXTE. Ces balises sont très ressemblantes à des balises du langage HTML. Ici, c'est une indication textuelle encadrée par des chevrons (< et >). Le ”del“ vient du terme anglais “delete” qui signifie “suppression”. Contrairement à ce que nous avons vu précédemment, la balise de début (<del>) est différente de la balise de fin (</del>). En effet, dans le langage HTML une balise de fin se distingue par une barre oblique qui indique la fermeture.

Les différents boutons de la barre d'outil t'aideront à la mise en forme de ton texte. Grâce à eux, tu n'as pas besoin d'apprendre ces syntaxes par cœur. Tu verras qu'en pratique, si tu fera des contributions régulièrement, tu cesseras rapidement d'utiliser les boutons de la barre d'outil pour les syntaxes simples parce qu'il est plus rapide d'appuyer 2x sur la touche “étoile” plutôt que de surligner le texte et de cliquer sur le bouton pour mettre du texte en gras. De plus, avec le temps, lorsque tu liras les codes sources des page, ton cerveau interprétera ceci : **TON TEXTE** comme étant en gras.

Reprenons notre texte qui nous sert d'exemple et mettons la phrase d'introduction et le chiffre “42” en gras en lieu et place des guillemets. Cela fera ressortir le sujet de ce texte (la question et sa réponse).

Voici le code source :

**La grande question sur la vie, l'Univers et le reste** (en anglais : The 
Ultimate Question of Life, the Universe and Everything) est, dans 
l'œuvre de science-fiction de Douglas Adams //Le Guide du voyageur 
galactique//, la question ultime sur le sens de la vie. Une réponse est 
proposée : **42**, mais le problème est que personne ne sait précisément 
à quelle question précise elle répond. Dans l'histoire, la réponse est 
cherchée par le super-ordinateur "Pensées profondes" ("Deep Thought" en 
version originale et "Grand Compute" Un dans les anciennes éditions). 
Cependant, celui-ci n'était pas assez puissant pour fournir la question 
ultime après avoir calculé la réponse durant 7,5 millions d'années. La 
réponse de "Pensées profondes" embarque les protagonistes dans une quête 
pour découvrir la question qui y correspond. (Extrait légèrement modifié 
issue de Wikipédia : 
https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

"Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous 
montrer au bout de sept millions et demi d'années de boulot ?"

"— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est 
incontestablement la réponse exacte. Je crois que le problème, pour être 
tout à fait franc avec vous, est que vous n'avez jamais vraiment bien 
saisi la question." 
(Douglas Adams, //Le Guide du voyageur galactique//, p. 232.)

Voici le résultat :

La grande question sur la vie, l'Univers et le reste (en anglais : The Ultimate Question of Life, the Universe and Everything) est, dans l'œuvre de science-fiction de Douglas Adams Le Guide du voyageur galactique, la question ultime sur le sens de la vie. Une réponse est proposée : 42, mais le problème est que personne ne sait précisément à quelle question précise elle répond. Dans l'histoire, la réponse est cherchée par le super-ordinateur “Pensées profondes” (“Deep Thought” en version originale et “Grand Compute” Un dans les anciennes éditions). Cependant, celui-ci n'était pas assez puissant pour fournir la question ultime après avoir calculé la réponse durant 7,5 millions d'années. La réponse de “Pensées profondes” embarque les protagonistes dans une quête pour découvrir la question qui y correspond. (Extrait légèrement modifié issue de Wikipédia : https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

“Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous montrer au bout de sept millions et demi d'années de boulot ?”

“— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est incontestablement la réponse exacte. Je crois que le problème, pour être tout à fait franc avec vous, est que vous n'avez jamais vraiment bien saisi la question.” (Douglas Adams, Le Guide du voyageur galactique, p. 232.)

Exemple de traitement des sauts de ligne simple

Article détaillé : Mise en forme de texte basique.

Jusque là, nous avons vu des syntaxes constituées de symboles ou de balises qui encadre 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 des textes. Pour ce faire nous devons forcer à faire un saut de ligne. Dans la foulée, on va rassemblé 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 poursuivait à 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'outil 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.

On va le faire pour la première référence comme ceci :

[...] La réponse de "Pensées profondes" embarque les protagonistes dans une quête 
pour découvrir la question qui y correspond.\\
(Extrait légèrement modifié issue de Wikipédia : 
https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

On va également le faire pour rassembler la citation puis, pour la seconde référence comme ceci :

"Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous 
montrer au bout de sept millions et demi d'années de boulot ?\\
— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est 
incontestablement la réponse exacte. Je crois que le problème, pour être 
tout à fait franc avec vous, est que vous n'avez jamais vraiment bien 
saisi la question."\\
(Douglas Adams, //Le Guide du voyageur galactique//, p. 232.)

Voici le résultat :

La grande question sur la vie, l'Univers et le reste (en anglais : The Ultimate Question of Life, the Universe and Everything) est, dans l'œuvre de science-fiction de Douglas Adams Le Guide du voyageur galactique, la question ultime sur le sens de la vie. Une réponse est proposée : 42, mais le problème est que personne ne sait précisément à quelle question précise elle répond. Dans l'histoire, la réponse est cherchée par le super-ordinateur “Pensées profondes” (“Deep Thought” en version originale et “Grand Compute” Un dans les anciennes éditions). Cependant, celui-ci n'était pas assez puissant pour fournir la question ultime après avoir calculé la réponse durant 7,5 millions d'années. La réponse de “Pensées profondes” embarque les protagonistes dans une quête pour découvrir la question qui y correspond.
(Extrait légèrement modifié issue de Wikipédia : https://fr.wikipedia.org/wiki/La_grande_question_sur_la_vie,_l%27Univers_et_le_reste).

“Quarante-deux ! cria Loonquawl. Et c'est tout ce que t'as à nous montrer au bout de sept millions et demi d'années de boulot ?
— J'ai vérifié très soigneusement, dit l'ordinateur, et c'est incontestablement la réponse exacte. Je crois que le problème, pour être tout à fait franc avec vous, est que vous n'avez jamais vraiment bien saisi la question.”
(Douglas Adams, Le Guide du voyageur galactique, p. 232.)

Il faut que je pense à ajouter un bouton “forcer un saut de ligne” dans la barre d'outil afin de t'aider.

Exemple de traitement des citations

Article détaillé : Les citations.

Notre texte prend gentiment forme. Cependant, je ne suis pas du tout satisfait de la mise en forme de la citation. En effet, celle-ci est constituée de 2 éléments qui devrait se suivre directement. Or, ils sont séparés en 2 paragraphes distincts.

FIXME Bientôt la suite…

aide/syntaxe/introduction_a_la_syntaxe.1675099572.txt.gz · Dernière modification : 30.01.2023 @ 18:26 de Chewbacca