From 79180abdbfaf40a7b32b1fac72209525e286e9db Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 20:19:56 +0100 Subject: [PATCH 1/7] switch MEO and Control display from safeHTML to Markdownify to facilitate wirting process --- layouts/rules/single.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/layouts/rules/single.html b/layouts/rules/single.html index 9ae9010..1ae60f9 100644 --- a/layouts/rules/single.html +++ b/layouts/rules/single.html @@ -51,11 +51,11 @@

{{ i18n "meo" }}

{{ i18n "control" }}

@@ -64,7 +64,7 @@

{{ i18n "control" }}

{{ range $i,$p:= $controle }}
  • - {{ . | safeHTML }} + {{ . | markdownify }}
    • {{ end }} From eed19acec7e4b9ca15ce82c0e6f374f30e06aa55 Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 20:20:56 +0100 Subject: [PATCH 2/7] rule 36 with numerous complexities in MEO (HTML code and lists) --- content/french/rules/036.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/content/french/rules/036.md b/content/french/rules/036.md index 3cd3a2e..064728b 100644 --- a/content/french/rules/036.md +++ b/content/french/rules/036.md @@ -1,9 +1,9 @@ --- N: '125' Rubrique: Internationalisation -title: Le code source de chaque Document de Contenu (Content Document) indique la langue principale du contenu. -detail: Le code source de chaque page indique la langue principale du contenu. -abstract: +title: Le code source de chaque Document de Contenu (Content Document) indique la langue principale du contenu. +detail: +abstract: Le Document de Contenu (Content Document) lu par les outils de synthèse vocale ne s'adapte pas automatiquement à la langue de ces documents, non-identifiable par ces outils qui analysent les pages. Cette information doit donc être fournie dans le code source du Document de Contenu en question. categories: [" Internationalisation"] agrege: O4125-E036 opquast: '4 125' @@ -14,10 +14,19 @@ weight: "036" after: "037" actif: '1' layout: rules -date: 2023-09-28 -tags: ["", ""] -objectif: ["", ""] -Meo: [""] +date: 2024-12-03 +tags: ["Langue", "Accessibilité"] +objectif: ["Permettre une lecture correcte du contenu par un outil de synthèse vocale.", " +Faciliter la traduction automatique.", " +Favoriser l'indexation des contenus selon leur langue."] +Meo: + ["L'attribut lang doit être ajouté à l'élément racine html du Document de Contenu pour indiquer la langue principale du texte. Le code de langue doit être conforme au registre des sous-tags de langue géré par l'Internet Assigned Numbers Authority (IANA). En pratique, pour le français, cela donne : html lang="fr" (en HTML) et html lang="fr" xml:lang="fr" (en XHTML). + + + Si la langue varie à l'intérieur d'un livre (par exemple, un texte en anglais dans un chapitre rédigé en français), vous pouvez également utiliser l'attribut lang (et xml:lang pour XHTML) sur des éléments spécifiques du document pour indiquer un changement de langue au sein d'une section. Cela peut être fait sur des balises comme p, div, ou même span, pour signaler un passage en une langue différente : + <p lang="en"> This text is in English. + <p lang="fr">Ce texte est en français. + Si la langue principale du document change dans différentes parties du contenu, vous pouvez définir l'attribut lang (ou xml:lang pour XHTML) au niveau de plusieurs éléments parentaux, comme head, body, title, etc., pour indiquer la langue dominante dans les sections en question."] Controle: ["" ] epubcheck: From d8397e9b76a6332238da45f717ca8f2664eeb993 Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 21:04:32 +0100 Subject: [PATCH 3/7] Update 036.md --- content/french/rules/036.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/content/french/rules/036.md b/content/french/rules/036.md index 064728b..bd3ce12 100644 --- a/content/french/rules/036.md +++ b/content/french/rules/036.md @@ -23,14 +23,23 @@ Meo: ["L'attribut lang doit être ajouté à l'élément racine html du Document de Contenu pour indiquer la langue principale du texte. Le code de langue doit être conforme au registre des sous-tags de langue géré par l'Internet Assigned Numbers Authority (IANA). En pratique, pour le français, cela donne : html lang="fr" (en HTML) et html lang="fr" xml:lang="fr" (en XHTML). - Si la langue varie à l'intérieur d'un livre (par exemple, un texte en anglais dans un chapitre rédigé en français), vous pouvez également utiliser l'attribut lang (et xml:lang pour XHTML) sur des éléments spécifiques du document pour indiquer un changement de langue au sein d'une section. Cela peut être fait sur des balises comme p, div, ou même span, pour signaler un passage en une langue différente : - <p lang="en"> This text is in English. - <p lang="fr">Ce texte est en français. + Si la langue varie à l'intérieur d'un livre (par exemple, un texte en anglais dans un chapitre rédigé en français), vous pouvez également utiliser l'attribut lang (et xml:lang pour XHTML) sur des éléments spécifiques du document pour indiquer un changement de langue au sein d'une section. Cela peut être fait sur des balises comme p, div, ou même span, pour signaler un passage en une langue différente : + <p lang="en">This text is in English.</p> + <p lang="fr">Ce texte est en français.</p> Si la langue principale du document change dans différentes parties du contenu, vous pouvez définir l'attribut lang (ou xml:lang pour XHTML) au niveau de plusieurs éléments parentaux, comme head, body, title, etc., pour indiquer la langue dominante dans les sections en question."] -Controle: ["" -] -epubcheck: -ace: +Controle: [" + +* Vérifier que l'élément racine html du Document de Contenu porte l'attribut lang, par exemple html lang="fr" (en HTML) et html lang="fr" xml:lang="fr" (en XHTML), pour indiquer la langue principale du document. + +* Vérifier que l'attribut xml:lang est également présent dans les documents XHTML afin de garantir la compatibilité avec les systèmes plus anciens et les outils nécessitant cette spécification supplémentaire. + +* Vérifier que tout contenu multilingue utilise l'attribut lang sur les éléments pertinents, tels que `p`, `div`, ou `span`, pour indiquer les changements de langue à l'intérieur du document. + +* Vérifier que les langues des métadonnées et du contenu dans les sections comme `head`, `title`, et `body` sont bien spécifiées avec l'attribut lang pour garantir une cohérence de l'information linguistique. + +* Vérifier que le code de langue utilisé dans l'attribut lang respecte les normes établies par le registre IANA des sous-tags de langue, et correspond à la langue du contenu. Il est à noter que les codes mul pour « langues multiples » et und pour « langue indéterminée » ne doivent pas être utilisés. Enfin, l'attribut xml:lang peut être également renseigné en complément de l'attribut lang, mais il n'est pas suffisant pour rendre conforme cette bonne pratique."] +epubcheck: false +ace: false humancheck: true Source: ["Opquast"] Referentiel: [""] From b9811cd1dc5117ef1fff48546ac6140357a1f658 Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 21:04:37 +0100 Subject: [PATCH 4/7] Update 034.md --- content/english/rules/034.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/content/english/rules/034.md b/content/english/rules/034.md index 745308f..c1dd038 100644 --- a/content/english/rules/034.md +++ b/content/english/rules/034.md @@ -3,7 +3,7 @@ N: '123' Rubrique: Internationalisation title: The international dialing code is available for all telephone numbers detail: The international dialing code is available for all telephone numbers -abstract: The digital book, whatever its language of writing, is an object that can be consulted, downloaded and shared from any point on the globe. It therefore goes without saying that all telephone numbers mentioned there must bear their international codes, so that contact is established without fail (particularly in the case of travel guides, directories, international manuals, professional books , or more generally contact information included in the body of the digital book). +abstract: "The digital book, whatever its language of writing, is an object that can be consulted, downloaded and shared from any point on the globe. It therefore goes without saying that all telephone numbers mentioned there must bear their international codes, so that contact is established without fail (particularly in the case of travel guides, directories, international manuals, professional books , or more generally contact information included in the body of the digital book)." categories: ["Internationalisation"] agrege: O4123-E034 opquast: '4 123' @@ -17,13 +17,8 @@ layout: rules date: 2024-12-03 tags: ["Contact"] objectif: ["Allow immediate use of telephone contact regardless of user context"] -Meo: ["Start each phone number with the two-digit country code preceded by a plus symbol, for example '+33' for France. Replace the zero, which may appear as the first digit, with the country code. -Present the telephone number as a series of pairs of numbers separated by a non-breaking space, where the first pair, corresponding to the country code, begins with a plus symbol, and the second pair contains only a figure, to harmonize the rest. For example, '+33 1 00 00 00 00'. -"] -Controle: ["For each phone number: -
    • Check that the two-digit country code appears first, preceded by a plus symbol, for example '+33' for France.
      • -
    • Check that the zero, which may appear as the first digit, is replaced by the country code.
      • -
    • Check that in its overall form it is a sequence of pairs of numbers separated by a non-breaking space, where the first pair, corresponding to the country code, begins with a plus symbol, and the second pair contains only one digit. For example, '+33 1 00 00 00 00'
    ."] +Meo: ["Start each phone number with the two-digit country code preceded by a plus symbol, for example "+33" for France. Replace the zero, which may appear as the first digit, with the country code. Present the telephone number as a series of pairs of numbers separated by a non-breaking space, where the first pair, corresponding to the country code, begins with a plus symbol, and the second pair contains only a figure, to harmonize the rest. For example, "+33 1 00 00 00 00"."] +Controle: ["For each phone number:
    • Check that the two-digit country code appears first, preceded by a plus symbol, for example "+33" for France.
    • Check that the zero, which may appear as the first digit, is replaced by the country code.
    • Check that in its overall form it is a sequence of pairs of numbers separated by a non-breaking space, where the first pair, corresponding to the country code, begins with a plus symbol, and the second pair contains only one digit. For example, "+33 1 00 00 00 00"
    ."] epubcheck: false ace: false humancheck: true From 466b71f3d9128bafbea6721b9f9c1ad924bb9fd3 Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 21:07:01 +0100 Subject: [PATCH 5/7] 036 EN --- content/english/rules/036.md | 37 +++++++++++++++++++++++++----------- 1 file changed, 26 insertions(+), 11 deletions(-) diff --git a/content/english/rules/036.md b/content/english/rules/036.md index 54be262..edee223 100644 --- a/content/english/rules/036.md +++ b/content/english/rules/036.md @@ -1,26 +1,41 @@ --- N: '125' Rubrique: Internationalisation -title: The source code of each Content Document indicates the primary language of the content. -abstract: +title: The source code of each Content Document indicates the primary language of the content. +detail: +abstract: The Content Document read by speech synthesis tools does not automatically adapt to the language of these documents, which cannot be identified by these tools which analyze the pages. This information must therefore be provided in the source code of the Content Document in question. categories: [" Internationalisation"] agrege: O4125-E036 opquast: '4 125' indiceebook: '36' -description: "Rule n° 036" +description: "Règle n° 036" before: "035" weight: "036" after: "037" actif: '1' layout: rules -date: 2024-09-18 -tags: ["", ""] -objectif: ["", ""] -Meo: [""] -Controle: ["" -] -epubcheck: -ace: +date: 2024-12-03 +tags: ["Langue", "Accessibilité"] +objectif: ["Allow correct reading of the content by a speech synthesis tool.", " +Facilitate automatic translation.", " +Promote the indexing of content according to their language."] +Meo: + [" +The lang attribute must be added to the root     html     element of the Content Document to indicate the primary language of the text. The language code must conform to the language subtag registry maintained by the Internet Assigned Numbers Authority (IANA< /a>). In practice, for French, this gives: html lang="fr" (in HTML) and html lang="fr" xml:lang="fr" (in XHTML). +If the language varies within a book (for example, English text in a French chapter), you can also use the lang attribute (and xml: lang for XHTML) on specific elements of the document to indicate a language change within a section. This can be done on tags like p, div, or even span, to indicate a passage in a different language: +

    This text is in English.

     +

    This text is in French.

     + If the primary language of the document changes in different parts of the content, you can set the lang attribute (or xml:lang for XHTML) at multiple parent elements, like head, body< /code>, title, etc., to indicate the dominant language in the sections in question."] +Controle: [" +* Check that the root element html of the Content Document has the lang attribute, for example html lang="fr" (in HTML) and html lang ="fr" xml:lang="fr" (in XHTML), to indicate the main language of the document. + +* Verify that the xml:lang attribute is also present in XHTML documents to ensure compatibility with older systems and tools requiring this additional specification. +* Verify that all multilingual content uses the lang attribute on relevant elements, such as `p`, `div`, or `span`, to indicate language changes within the document. + +* Check that the languages ​​of metadata and content in sections like `head`, `title`, and `body` are specified with the lang attribute to ensure consistency of linguistic information. +* Verify that the language code used in the lang attribute meets the standards established by the IANA registry of language subtags, and matches the language of the content. Please note that the codes mul for “multiple languages” and und for “undetermined language” should not be used. Finally, the xml:lang attribute can also be entered in addition to the lang attribute, but it is not sufficient to comply with this good practice."] +epubcheck: false +ace: false humancheck: true Source: ["Opquast"] Referentiel: [""] From 308d4d39743ffeb642bb98687e35b281bafb7210 Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 21:11:50 +0100 Subject: [PATCH 6/7] rule 37 The main language of the target page of a link is identifiable when it differs from that of the original page. --- content/english/rules/037.md | 28 ++++++++++++++++++---------- content/french/rules/037.md | 28 +++++++++++++++++----------- 2 files changed, 35 insertions(+), 21 deletions(-) diff --git a/content/english/rules/037.md b/content/english/rules/037.md index bb3e4ba..3cec74e 100644 --- a/content/english/rules/037.md +++ b/content/english/rules/037.md @@ -1,26 +1,34 @@ --- N: '126' Rubrique: Internationalisation -title: The primary language of the target content of a link is identifiable when it differs from that of the original content. -abstract: +title: The main language of the target page of a link is identifiable when it differs from that of the original page. +detail: The main language of the target page of a link is identifiable when it differs from that of the original page. +abstract: Arriving by surprise on a section in the dialect of the Ñoldor Elves when you don't speak their language is never very pleasant. In an e-book, it is important to provide clear information so the reader knows what to expect when they click on a link, whether internal or external. Identifying the language of the target section or content in advance helps avoid surprises and improves the reading experience. Specifying the language of the sections in the links helps to limit unnecessary or frustrating clicks for readers. categories: [" Internationalisation"] agrege: O4126-E037 opquast: '4 126' indiceebook: '37' -description: "Rule n° 037" +description: "Règle n° 037" before: "036" weight: "037" after: "038" actif: '1' layout: rules -date: 2024-09-18 -tags: ["", ""] -objectif: ["", ""] -Meo: [""] -Controle: ["" +date: 2024-12-03 +tags: ["Langue", "Accessibility"] +objectif: ["Allow readers and reading tools, particularly text-to-speech tools, to anticipate a language change when navigating a digital book.", " +Prevent readers from accessing a section or content whose language they do not understand, by clearly indicating the target language in advance."] +Meo: ["The target language of a link can be indicated in several ways: + +*Via the wording of the link, written in the target language, which allows the reader to anticipate the language change +*Optionally using an appropriate icon, such as a symbol or visual indicator (such as a flag), although the use of icons is less common in digital books and may depend on the context of publication page. +*Possibly explicitly in the wording of the link or in its immediate context, by clearly mentioning the target language directly in the text or information around the link."] +Controle: [" +*Manually identify links whose target section or document content is not written in the same language as the current section. +*Check, for each of these links, that the reader is immediately informed of the language of the target content, either through the wording of the link (written in the target language), or by an appropriate visual indicator, or by an explicit indication in the context of the link." ] -epubcheck: -ace: +epubcheck: false +ace: false humancheck: true Source: ["Opquast"] Referentiel: [""] diff --git a/content/french/rules/037.md b/content/french/rules/037.md index 48bdfac..1dfb9f8 100644 --- a/content/french/rules/037.md +++ b/content/french/rules/037.md @@ -1,10 +1,9 @@ --- N: '126' Rubrique: Internationalisation -title: La langue principale de la page cible d'un lien est identifiable lorsqu'elle - diffère de celle de la page d'origine. -detail: La langue principale du contenu cible d'un lien est identifiable lorsqu'elle diffère de celle du contenu d'origine. -abstract: +title: La langue principale de la page cible d'un lien est identifiable lorsqu'elle diffère de celle de la page d'origine. +detail: La langue principale de la page cible d'un lien est identifiable lorsqu'elle diffère de celle de la page d'origine. +abstract: Arriver par surprise sur une section en dialecte des Elfes Ñoldor lorsqu’on ne parle pas leur langue n’est jamais très agréable. Dans un livre numérique, il est important de fournir des informations claires pour que le lecteur sache à quoi s'attendre lorsqu'il clique sur un lien, qu'il soit interne ou externe. Identifier à l'avance la langue de la section ou du contenu cible permet d'éviter des surprises et d'améliorer l'expérience de lecture. Préciser la langue des sections dans les liens aide ainsi à limiter les clics inutiles ou frustrants pour les lecteurs. categories: [" Internationalisation"] agrege: O4126-E037 opquast: '4 126' @@ -15,14 +14,21 @@ weight: "037" after: "038" actif: '1' layout: rules -date: 2023-09-28 -tags: ["", ""] -objectif: ["", ""] -Meo: [""] -Controle: ["" +date: 2024-12-03 +tags: ["Langue", "Accessibilité"] +objectif: ["Permettre aux lecteurs et aux outils de lecture, notamment les outils de synthèse vocale, d'anticiper un changement de langue lors de la navigation dans un livre numérique.", " +Éviter que les lecteurs accèdent à une section ou un contenu dont ils ne comprennent pas la langue, en indiquant clairement la langue cible à l'avance."] +Meo: ["La langue cible d'un lien peut être indiquée de plusieurs manières : + +* Via le libellé du lien, rédigé dans la langue cible, ce qui permet au lecteur d'anticiper le changement de langue +* Éventuellement à l'aide d'une icône appropriée, telle qu'un symbole ou un indicateur visuel (comme un drapeau), bien que l'usage d'icônes soit moins courant dans les livres numériques et puisse dépendre du contexte de mise en page. +* Éventuellement de manière explicite dans le libellé du lien ou dans son contexte immédiat, en mentionnant clairement la langue cible directement dans le texte ou les informations autour du lien."] +Controle: [" +* Identifier manuellement les liens dont le contenu de la section ou du document cible n'est pas rédigé dans la même langue que celle de la section actuelle. + * Vérifier, pour chacun de ces liens, que le lecteur est immédiatement informé de la langue du contenu cible, soit à travers le libellé du lien (rédigé dans la langue cible), soit par un indicateur visuel approprié, soit par une indication explicite dans le contexte du lien." ] -epubcheck: -ace: +epubcheck: false +ace: false humancheck: true Source: ["Opquast"] Referentiel: [""] From f91bde5ffaa447f50425d54cd115cadeb6fce7da Mon Sep 17 00:00:00 2001 From: gautierchomel Date: Tue, 3 Dec 2024 21:13:09 +0100 Subject: [PATCH 7/7] 036 is checked bty epubcheck --- content/english/rules/036.md | 2 +- content/french/rules/036.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/english/rules/036.md b/content/english/rules/036.md index edee223..69f07ee 100644 --- a/content/english/rules/036.md +++ b/content/english/rules/036.md @@ -34,7 +34,7 @@ Controle: [" * Check that the languages ​​of metadata and content in sections like `head`, `title`, and `body` are specified with the lang attribute to ensure consistency of linguistic information. * Verify that the language code used in the lang attribute meets the standards established by the IANA registry of language subtags, and matches the language of the content. Please note that the codes mul for “multiple languages” and und for “undetermined language” should not be used. Finally, the xml:lang attribute can also be entered in addition to the lang attribute, but it is not sufficient to comply with this good practice."] -epubcheck: false +epubcheck: true ace: false humancheck: true Source: ["Opquast"] diff --git a/content/french/rules/036.md b/content/french/rules/036.md index bd3ce12..8d44853 100644 --- a/content/french/rules/036.md +++ b/content/french/rules/036.md @@ -38,7 +38,7 @@ Controle: [" * Vérifier que les langues des métadonnées et du contenu dans les sections comme `head`, `title`, et `body` sont bien spécifiées avec l'attribut lang pour garantir une cohérence de l'information linguistique. * Vérifier que le code de langue utilisé dans l'attribut lang respecte les normes établies par le registre IANA des sous-tags de langue, et correspond à la langue du contenu. Il est à noter que les codes mul pour « langues multiples » et und pour « langue indéterminée » ne doivent pas être utilisés. Enfin, l'attribut xml:lang peut être également renseigné en complément de l'attribut lang, mais il n'est pas suffisant pour rendre conforme cette bonne pratique."] -epubcheck: false +epubcheck: true ace: false humancheck: true Source: ["Opquast"]