Skip to content
Extraits de code Groupes Projets

Réécriture de l’aide (fr)

Fusionnées marcimat requested to merge gh-2d545905/4627/unknown/refs/pull/4627/head into master

Réécriture des fichiers .spip

  • en enlevant les ig-br
  • en simplifiant certains textes
  • en évitant des écritures masculines
  • en utilisant pour montrer le code une balise (interne) <aide:code> le code </aide:code> qui affiche le code SPIP (typo) et son résultat

Amélioration (j’espère) du CSS des blocs de code qui s’intègrent mieux avec ou sans Coloration Code.

Concernant <aide:code>, à voir si on ajoute un label (visuel et/ou caché) qui indiquerait «le code» et «le résultat» (enfin qqc comme ça) en titre pour les blocs générés, et éventuellement revoir le CSS du bloc de texte généré…


Sans Coloration Code Sans coloration code

Avec Coloration Code Avec coloration code

Rapports de requête de fusion

L'approbation est facultative

Fusionnée par avatar (févr. 13, 2025 10:40pm UTC)

Activité

Filtrer l'activité
  • Approbations
  • Assignés et relecteurs
  • Commentaires (des bots)
  • Commentaires (des utilisateurs)
  • Branches et validations
  • Modifications
  • Labels
  • État de verrouillage
  • Mentions
  • État de la demande de fusion
  • Suivi
  • @marcimat a ajouté 19 révisions : 23d7bda6 109932d3 ec90acb2 4dc4b780 83098ad7 68d86c8f918593873601e39b044a42ac3ac7f7e5 d989edc7446c60e2603f88fa843ae3318424529b a88150c887bed974d4efb44051834fd6cd1c7d8e 5bc2bf394e34b2049707d1e4bff9728cd5acd554 323ea02dd0341a13c53199f95cec95ecd7046527 3f238f5d79895e68e35f981e809c942d2aae3455 eab6cb3a1bc356f45ad2478dc216aeaede046151 c26b14d651a4e85820fd86618494c0bdfd19835e 2ec471e22b9416e803544d8cd11c2518916d927b 30a5d3d1897fdc64bd73595a8dd8ba07fb19e383 b84faa0e38d958f3e78c36590de449b53b9c6996 79aa1cb437ff44bf4633f9be0d6fd7b137ea4af6 2125720a287670bc66e7011bcfe47bfb5033900e 686c24d5b066ce7fd98230446cfdc313156fac59

  • Auteur Maintainer

    Notons qu’il faut avoir Textwheel à jour pour que les blocs de code fonctionnent !

  • @marcimat a force-pushed 2 révisions : 686c24d5b066ce7fd98230446cfdc313156fac59 83c17ebd7a36d8f7c0c474713ac4d7c1b3ea43e2

  • @maieul a évalué le commit 3f238f5d79895e68e35f981e809c942d2aae3455 :

    diff --git a/aide/fr/raccourcis/citation.spip b/aide/fr/raccourcis/citation.spip
    --- a/aide/fr/raccourcis/citation.spip
    +++ b/aide/fr/raccourcis/citation.spip
    @@ -17,3 +1,1 @@
    -<quote><quote>C'est drôlement bien, SPIP.</quote>
    -
    -Kikou, je suis bien d'accord :-)</quote>
    +Il est souvent pratique, dans un forum de discussion, de citer un extrait du message auquel on est en train de répondre. Pour homogénéiser la présentation de telles citations, SPIP propose le raccourci `<quote>...</quote>`

    je suis étonné par le fait qu'on imagine uniquement les forums de discussions comme cas d'usage.

  • @maieul a approuvé cette PR (83c17ebd7a36d8f7c0c474713ac4d7c1b3ea43e2)

    Merci pour ce travail. J'ai pas tout compris aux enjeux techniques. J'ai juste profiter pour lire un peu les diffs sur le texte lui-même, avec certaines remarques/suggestion.

  • @maieul a évalué le commit eab6cb3a1bc356f45ad2478dc216aeaede046151 :

    diff --git a/aide/fr/raccourcis/code.spip b/aide/fr/raccourcis/code.spip
    --- a/aide/fr/raccourcis/code.spip
    +++ b/aide/fr/raccourcis/code.spip
    @@ -43,3 +1,1 @@
    -fonctions;
    -}
    -</cadre>
    +Certains utilisateurs de SPIP veulent parfois afficher du code informatique dans leurs pages.

    Un masculin qui traine. "Certaines personnes" plutot

  • @maieul a évalué le commit eab6cb3a1bc356f45ad2478dc216aeaede046151 :

    diff --git a/aide/fr/raccourcis/code.spip b/aide/fr/raccourcis/code.spip
    --- a/aide/fr/raccourcis/code.spip
    +++ b/aide/fr/raccourcis/code.spip
    @@ -46,0 +7,4 @@
    +
    +----
    +
    +En alternative, il existe le raccourci `<code>...</code>` également.

    supprimer le "également", l'alternative suffit

  • @maieul a évalué le commit eab6cb3a1bc356f45ad2478dc216aeaede046151 :

    diff --git a/aide/fr/raccourcis/code.spip b/aide/fr/raccourcis/code.spip
    --- a/aide/fr/raccourcis/code.spip
    +++ b/aide/fr/raccourcis/code.spip
    @@ -63,3 +45,1 @@
    -</quote>
    -(ici, notez l'absence d'espaces avant le point-virgule et le point 
    -d'exclamation).
    +Dans certains cas, il peut être utile d’indiquer à SPIP que certaines parties d’un document ne doivent pas être «traitées» par le filtre des raccourcis typographiques: lorsque vous ne voulez pas corriger la typographie par exemple. Vous pouvez encadrer le contenu de la balise `<HTML>...</HTML>`.

    question bete, les guillemets français sont-ils automatquement précédés/suivis d'espace fin insécable?

  • @maieul a évalué le commit d0ab53582ab6fad5e40debe9ddee3a74556b7343 :

    diff --git a/aide/fr/raccourcis/lien.spip b/aide/fr/raccourcis/lien.spip
    --- a/aide/fr/raccourcis/lien.spip
    +++ b/aide/fr/raccourcis/lien.spip
    @@ -24,0 +16,4 @@
    +
    +Notez que, dans le cas des URL très longues, l’affichage est tronqué (pour éviter de dégrader votre interface graphique), mais le lien hypertexte pointe vers la bonne adresse.
    +
    +Enfin, une URL écrite directement se transforme également en lien hypertexte automatiquement (celui ci n’est alors pas tronqué s’il est long)

    manque un point final.

  • @maieul a évalué le commit d0ab53582ab6fad5e40debe9ddee3a74556b7343 :

    diff --git a/aide/fr/raccourcis/lien.spip b/aide/fr/raccourcis/lien.spip
    --- a/aide/fr/raccourcis/lien.spip
    +++ b/aide/fr/raccourcis/lien.spip
    @@ -53,3 +47,1 @@
    -article, une brève ou une rubrique, la colonne de gauche
    -contient un pavé indiquant, en gros caractères, ce
    -numéro.
    +Lorsque vous «visitez», dans l’espace privé, un article par exemple, la colonne de gauche contient un pavé indiquant, en gros caractères, ce numéro.

    Lorsquer, par exemple, vous visitez un article dans l'espace privé..."

  • @maieul a évalué le commit 7fe39071b3cd7f687d6e1c96daa9adffa72182b1 :

    diff --git a/aide/fr/raccourcis/liste.spip b/aide/fr/raccourcis/liste.spip
    --- a/aide/fr/raccourcis/liste.spip
    +++ b/aide/fr/raccourcis/liste.spip
    @@ -2,3 +2,2 @@
     
    -- Un simple retour à la ligne s'obtient en tapant <tt>_</tt> (le trait
    -de soulignement ou {underscore}) au début de la ligne, suivi d'une espace.
    +{N.B.} En typographie classique, le simple retour à la ligne est très rare (limité essentiellement à la poésie). Ne l’utilisez donc pas pour former un paragraphe. Un paragraphe se forme en insérant une ligne vide.

    Contenu plus valable depuis au moins spip 3, qu insère désormais automatiquement des retours lignes (à tord à mon gout, mais c'est comme cela) lorsqu'il y a un retour chariot dans le texte (sauf paramètrage contraire)

  • @maieul a évalué le commit 449b58a376cbf3bca36fdf6cd468b9ffc1877029 :

    diff --git a/aide/fr/raccourcis/simple.spip b/aide/fr/raccourcis/simple.spip
    --- a/aide/fr/raccourcis/simple.spip
    +++ b/aide/fr/raccourcis/simple.spip
    @@ -26,3 +18,1 @@
    -(retour-chariot) sans séparer les deux paragraphes par une
    -ligne vide ne suffit pas pour provoquer un changement de paragraphe
    -(cela ne provoque même pas un retour à la ligne).
    +Le fait de simplement «revenir à la ligne» (retour-chariot) sans séparer les deux paragraphes par une ligne vide ne suffit pas pour provoquer un changement de paragraphe.

    mais provoque un simple retour ligne, par exemple pour indiquer une adresse postale.

  • @maieul a évalué le commit 449b58a376cbf3bca36fdf6cd468b9ffc1877029 :

    diff --git a/aide/fr/raccourcis/simple.spip b/aide/fr/raccourcis/simple.spip
    --- a/aide/fr/raccourcis/simple.spip
    +++ b/aide/fr/raccourcis/simple.spip
    @@ -79,2 +50,2 @@
    -partie}}}</tt></html>» affichera le texte en gras et centré:
    -<quote>{{{Un titre de partie}}}</quote>
    +Les intertitres sont des titres à l’intérieur d’un texte permettant d’en indiquer la structure.
    +Dans SPIP, on les indique en les plaçant entre des accolades triples.

    Je me demande si on ne devrait pas préciser qu'il n'y a qu'un niveau par défaut, mais que des plugins permettent d'en mettre plus (voir même d'intégrer ces plugins dans le core, mais c'est une autre histoire)

  • @maieul a évalué le commit cbd04c062ccff1cff3875f9f55949323c16b4332 :

    diff --git a/aide/fr/raccourcis/tableau.spip b/aide/fr/raccourcis/tableau.spip
    --- a/aide/fr/raccourcis/tableau.spip
    +++ b/aide/fr/raccourcis/tableau.spip
    @@ -34,3 +15,1 @@
    -On peut aussi ajouter une légende et un résumé à la table. Ces deux informations sont optionnelles mais sont très importantes pour rendre la table accessible aux mal-voyants, le résumé donnant une meilleure idée du contenu de la table.
    -_ Ces informations sont spécifiées entre double trait vertical avant la table comme ceci:
    -<cadre>
    +On peut aussi ajouter une légende et un résumé à la table. Ces deux informations sont optionnelles mais sont très importantes pour rendre la table accessible aux mal-voyants, le résumé donnant une meilleure idée du contenu de la table. Ces informations sont spécifiées entre double trait vertical `||` avant la table.

    mal voyant·es ? personnes mal-voyantes ?

    (note : je crois qu'il y a eu des modifs il y a pas longtemps sur cette question de summary, non ?)

  • @marcimat a évalué le commit 7fe39071b3cd7f687d6e1c96daa9adffa72182b1 :

    diff --git a/aide/fr/raccourcis/liste.spip b/aide/fr/raccourcis/liste.spip
    --- a/aide/fr/raccourcis/liste.spip
    +++ b/aide/fr/raccourcis/liste.spip
    @@ -2,3 +2,2 @@
     
    -- Un simple retour à la ligne s'obtient en tapant <tt>_</tt> (le trait
    -de soulignement ou {underscore}) au début de la ligne, suivi d'une espace.
    +{N.B.} En typographie classique, le simple retour à la ligne est très rare (limité essentiellement à la poésie). Ne l’utilisez donc pas pour former un paragraphe. Un paragraphe se forme en insérant une ligne vide.

    Ah oui, c’est juste… le raccourci continue de fonctionner cela dit !

  • @marcimat a évalué le commit eab6cb3a1bc356f45ad2478dc216aeaede046151 :

    diff --git a/aide/fr/raccourcis/code.spip b/aide/fr/raccourcis/code.spip
    --- a/aide/fr/raccourcis/code.spip
    +++ b/aide/fr/raccourcis/code.spip
    @@ -43,3 +1,1 @@
    -fonctions;
    -}
    -</cadre>
    +Certains utilisateurs de SPIP veulent parfois afficher du code informatique dans leurs pages.

    Arf, il a échappé à ma vigilance celui là!

  • @marcimat a force-pushed 2 révisions : 83c17ebd7a36d8f7c0c474713ac4d7c1b3ea43e2 2f3e1bef0accd27cdd094fdaa65f2a04ea94f29d

  • @marcimat a ajouté 1 révision : 530e52b8753a91f9558428db3bedb69b3bfd8681

  • @marcimat a évalué le commit 3f238f5d79895e68e35f981e809c942d2aae3455 :

    diff --git a/aide/fr/raccourcis/citation.spip b/aide/fr/raccourcis/citation.spip
    --- a/aide/fr/raccourcis/citation.spip
    +++ b/aide/fr/raccourcis/citation.spip
    @@ -17,3 +1,1 @@
    -<quote><quote>C'est drôlement bien, SPIP.</quote>
    -
    -Kikou, je suis bien d'accord :-)</quote>
    +Il est souvent pratique, dans un forum de discussion, de citer un extrait du message auquel on est en train de répondre. Pour homogénéiser la présentation de telles citations, SPIP propose le raccourci `<quote>...</quote>`

    J’ai amendé un peu, tu me diras

  • @marcimat a évalué le commit eab6cb3a1bc356f45ad2478dc216aeaede046151 :

    diff --git a/aide/fr/raccourcis/code.spip b/aide/fr/raccourcis/code.spip
    --- a/aide/fr/raccourcis/code.spip
    +++ b/aide/fr/raccourcis/code.spip
    @@ -63,3 +45,1 @@
    -</quote>
    -(ici, notez l'absence d'espaces avant le point-virgule et le point 
    -d'exclamation).
    +Dans certains cas, il peut être utile d’indiquer à SPIP que certaines parties d’un document ne doivent pas être «traitées» par le filtre des raccourcis typographiques: lorsque vous ne voulez pas corriger la typographie par exemple. Vous pouvez encadrer le contenu de la balise `<HTML>...</HTML>`.

    Je ne sais plus quel type d’espace exactement est utilisé. Il faudrait regarder. Il y a de toutes façons parfois quelques soucis de ce point de vue (j’avais vu cela en écrivant des insécables dans les chaines de langue, et salvatore transforme abusivement le contenu ; mais je sais plus où j’ai noté cela)

  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
  • Loading
Veuillez vous inscrire ou vous connecter pour répondre
Chargement en cours