disic / frago

Génération de rapports de synthèse pour le suivi et l’amélioration de l’accessibilité (audits et recommandations)

Ce projet n'est plus maintenu par la DINUM.

Il continue d'être développé sur github.com/lowdit/frago.

Génération de rapports de synthèse pour le suivi et l’amélioration de l’accessibilité web.

---

FRAGO : French Reports for Accessibility compliance with goHugo

Documentation

Consultez la documentation pour découvrir l’outil : https://disic.github.io/frago/docs/

Licence

Le code source de ce dépôt est publié sous licence MIT.

La marque d’État est à usage exclusif des acteurs de la sphère étatique. En particulier, la typographie Marianne© est protégée par le droit d’auteur.
Lire les explications sur le site de la marque d’État.

Le thème Frago utilise cette liste de bibliothèques :

1. Frappe Charts (MIT) : https://github.com/frappe/charts - https://github.com/frappe/charts
2. Mermaid (MIT) : https://github.com/mermaid-js/mermaid
3. Highlight.js (MIT) : https://github.com/highlightjs/highlight.js
4. simplelightbox (MIT) : https://github.com/andreknieriem/simplelightbox
5. Van11y accessible tabs panel system (MIT) : https://github.com/nico3333fr/van11y-accessible-tab-panel-aria
6. Checka11y.css (MIT) : https://github.com/jackdomleo7/Checka11y.css

Auteur

2019-2020, Direction interministérielle du numérique. 2020-2022, Ministère de l’économie, des Finances et de la Relance.

frago's Issues

Erreur dans le calcul du nombre de critères pour un audit CSV rempli avec tests

D'abord merci @bertrandkeller pour ce magnifique thème fort utile et pertinent !

Étapes pour reproduire le bug

• Créer un site Hugo
• Utiliser Frago comme thème
• Ajouter un projet avec l'audit d'accessibilité 2022-01-13.csv

Quel le comportement observé du bug ?

Le nombre de critères calculé par Frago est :

Résultat	Critères
C	5
NC	4
NA	36

Quel est le comportement correct attendu ?

Le nombre de critères réel (re-calculé par un humain) est :

Résultat	Critères
C	3 ⚠️
NC	4
NA	21 ⚠️

Frago donne donc :

• 2 conformes en trop
• 15 NA en trop

Copies d'écrans et fichiers journaux pertinents

Copie d'écran résultats Frago

Détails de l'audit CSV

Résultat	Critères	Tests	Liste des critères	Liste des tests
C	3	7	8.3, 8.4, 8.5	8.1.1, 8.1.2, 8.3.1, 8.4.1, 8.5.1, 10.1.1, 10.1.2
NC	4	5	3.2, 8.9, 9.1, 9.2	3.2.1, 3.2.2, 8.9.1, 9.1.1, 9.2.1
NA	21	79	2.1, 2.2, 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, 4.8, 4.9, 4.11, 4.12, 4.13, 5.1, 5.3, 8.8, 12.1, 12.2, 12.4, 12.5	(trop fastideux, pas fait 😉 )
NT	78	166	(trop fastideux, pas fait 😉 )	(trop fastideux, pas fait 😉 )
Total	106	257

Pistes de solution

Le calcul des NA semble ne pas prendre en compte les NT.

Vu qu'il y a deux critères conformes de différence, on peut imaginer qu'il s'agissent des 8.1 et 10.1.

Si on reprend les 3 tests du 8.1, on a :

8,1,1,c
8,1,2,c
8,1,3,nt

...ce qui donne un résultat NT pour le 8.1.

De même, si on reprend les 3 tests du 10.1, on a :

10,1,1,c
10,1,2,c
10,1,3,nt

... ce qui donne un résultat NT pour le 10.1

Mauvais affichage du score

Mauvais affichage du badge "X% de conformité"

Ex. https://design.numerique.gouv.fr/audits/drhmae

Tableaux du rapport "quality"

J'essaie de comprendre comment fonctionnent les tableaux.

• A quoi correspond réellement la colonne 'Type' ? et comment on définit le "titre" de la ligne ?
• Est-ce que ça correspond à un élément précis de la page ou bien autre chose ?
• Comment est-ce que tu définis les "lots" ?

Merci :)

Les liens vers le RGAA 4.1 sont cassés

Par exemple ici :
https://design.numerique.gouv.fr/audits/cnamts/audits/3000/accessibility/
Chercher "Changement de contexte". Le lien renvoit vers une page 404

Attendu : https://design.numerique.gouv.fr/audits/cnamts/rgaa/4.1/glossaire/#changement-de-contexte
Actuellement : https://design.numerique.gouv.fr/audits/cnamts/audits/3000/accessibility/rgaa4.1/glossaire/#changement-de-contexte

On note :

• une URL qui semble relative au répertoire accessibility au lieu de la racine du projet
• un / manquant entre /rgaa et 4.1/

(régression) La section "anomalies présentes sur toutes les pages" est vide

... même s'il existe effectivement des anomalies présentes sur toutes les pages.

Audit "Qualité" à convertir en "recommandations"

Est-ce qu'il y aurait moyen de changer le terme de "qualité" quand on utilise cette partie pour faire remonter les différentes erreurs d'accessibilité par type de lot ? (L'utilisateur final ne connait pas forcément la qualité ou inversement et ça peut être déroutant aussi ... )

Ajout d'un article sur la déclaration

Il faudrait pouvoir ajouter un article de type "Le / La" avant l'intitulé de l'établissement qui apparait sur la déclaration de conformité.

Erreurs en local

J'ai cette erreur en local, comment je peux faire pour ne plus l'avoir. c'est perturbant...

Langue principale de la documentation en au lieu de fr (documentation)

L'ndication de langue est actuellement "en" au lieu de "fr" sur la balise html de la documentation.

Execute of template failed: template: partials/render/accessibility.html:254:105

hugo version: v0.92.0-B3549403
frago version: v1.6.11

When starting a project,
hugo serve fails if:

• csv file is not empty
• and csv file does not contain at least 1 na 1 nc and 1 c

For example, when:

- 1.1 : c  c  c  c  c
- 1.2 : nc nc nc nc nc

(no na)

Error:

Execute of template failed: template: partials/render/accessibility.html:254:105: executing "partials/render/accessibility.html" at <len ($data.Get (printf "%s%s" $scorekey "critNA"))>: error calling len: reflect: call of reflect.Value.Type on zero Value

Export PDF des rapports

Besoin

Pouvoir réaliser un export PDF des rapports

Complexité

Hugo ne permet pas de générer directement des PDF. Il faut ajouter une bibliothèque qui va se lancer après le build.

Ressources

1. https://github.com/humanwhocodes/print-ready
2. https://weasyprint.org/
3. https://www.princexml.com/
4. https://pdfkit.org/

Scratch "criterenonconforme"?

frago/layouts/partials/render/accessibility.html

Line 85 in b008812

{{- if ($.context.Scratch.Get "criterenonconforme") -}}{{ $.context.Scratch.Set (printf "%s%s" $scorekey "compliance") ((div (mul (($.context.Scratch.Get (printf "%s%s" $scorekey "critereconformecounter"))) 100) (len ($.context.Scratch.Get (printf "%s%s" $scorekey "rendercriterenonconforme"))))) -}}{{- end -}}

@bertrandkeller Le scratch "criterenonconforme" ne semble pas être utilisé

Lien en double : "Accéder au rapport"

Bug reproduit ici :

• https://design.numerique.gouv.fr/audits/dila/audits/1879/
• https://github.com/DISIC/dsn-audits-dila

Modifier la phrase "pour atteindre 75%"

Il faut enlever cette phrase qui n'est pas exacte en "objectif à atteindre", le RGAA demande à ce que ce soit totalement conforme. Soit on met 100% soit on met rien du tout … mais pas 75% ;-)

La vue "Conformité détaillée" ne tient pas compte des critères non applicables (na)

Un exemple de declaration dans exampleSite ?

Suppression du Build Github Pages

Bonjour,

Est-ce possible de supprimer la branche gh-pages et le build Github Pages ?
Le lien website sur la page d'accueil ?

Des personnes tombent sur ce dépôt alors qu'il n'est plus maintenu.

Merci à vous.

Erreur lors de la création de go.sum

Bonjour et bravo pour ce projet !

Quand j'essaie de créer le fichier go.sum avec cette instruction hugo mod get github.com/disic/frago, j'obtiens cette erreur

go: github.com/disic/frago upgrade => v1.6.12
Error: add site dependencies: load resources: loading templates: "/tmp/hugo_cache/modules/filecache/modules/pkg/mod/github.com/disic/[email protected]/layouts/_default/single.json:1:1": parse failed: template: _default/single.json:1: unclosed action

Suis-je le seul à avoir ce problème ? cc @bertrandkeller

Ajouter le taux moyen de conformité

Cf. Taux de conformité à la norme

Ce taux peut indiquer le pourcentage de critères respectés ou le niveau de conformité moyen du service en ligne.