search

lowdit / frago

Génération de rapports de synthèse pour le suivi et l’amélioration de l’accessibilité (audits et recommandations)
https://lowdit.github.io/frago/
MIT License
16 stars 4 forks source link

[Doc] Pré-filtrer les fichiers d'exemple à télécharger #21

Open marc-bouvier opened 7 months ago

marc-bouvier commented 7 months ago

Pour éviter une modification fastidieuse à chaque démarrage d'audit, proposer des fichiers d'exemple pour les audits 25, 50, 81 critères en plus des fichiers avec tous les critères.

Ceci peut être automatisé à l'aide d'un script shell comme le suivant :

rm -rf out
mkdir out

curl  https://raw.githubusercontent.com/lowdit/frago/master/exampleSite/exampleFiles/grille-criteres-rgaa-4.csv --output grille-criteres-rgaa-4.csv

curl https://raw.githubusercontent.com/lowdit/frago/master/exampleSite/exampleFiles/grille-tests-rgaa-4.0.csv --output grille-tests-rgaa-4.0.csv

curl  https://raw.githubusercontent.com/lowdit/frago/master/exampleSite/exampleFiles/grille-tests-rgaa-4.1.csv --output grille-tests-rgaa-4.1.csv

cat grille-criteres-rgaa-4.csv| grep -E '25|Thématique' > out/grille-criteres-rgaa-4_25.csv
cat grille-criteres-rgaa-4.csv| grep -E '25|50|Thématique' > out/grille-criteres-rgaa-4_50.csv
cat grille-criteres-rgaa-4.csv| grep -E '25|50|81|Thématique' > out/grille-criteres-rgaa-4_81.csv
cat grille-criteres-rgaa-4.csv > out/grille-tests-rgaa-4_all.csv

cat grille-tests-rgaa-4.0.csv | grep -E '25|Thématique' > out/grille-tests-rgaa-4.0_25.csv
cat grille-tests-rgaa-4.0.csv | grep -E '25|50|Thématique' > out/grille-tests-rgaa-4.0_50.csv
cat grille-tests-rgaa-4.0.csv | grep -E '25|50|81|Thématique' > out/grille-tests-rgaa-4.0_81.csv
cat grille-tests-rgaa-4.0.csv > out/grille-tests-rgaa-4.0_all.csv

cat grille-tests-rgaa-4.1.csv | grep -E '25|50|81|Thématique' > out/grille-tests-rgaa-4.1_81.csv
cat grille-tests-rgaa-4.1.csv | grep -E '25|50|Thématique' > out/grille-tests-rgaa-4.1_50.csv
cat grille-tests-rgaa-4.1.csv | grep -E '25|Thématique' > out/grille-tests-rgaa-4.1_25.csv
cat grille-tests-rgaa-4.1.csv > out/grille-tests-rgaa-4.1_all.csv

Ce script pourrait être exécuté dans la pipeline qui publie la doc.

https://github.com/lowdit/frago/blob/docs/.github/workflows/gh-pages.yml

marc-bouvier commented 7 months ago

Fait.

image
marc-bouvier commented 7 months ago

Finalement, je les ai présentées sur 1 seule ligne.

image
bertrandkeller commented 7 months ago

Si ça te botte, il existe une branche script : https://github.com/lowdit/frago/tree/scripts

On peut tout faire dedans. C'est le royaume du bash. On peut créer un bash avec des choix multiples. Je trouve ça vraiment classe avec des couleurs.

On peut créer des issues pour pas mal d'usages. Et ajouter une page dans la documentation.

marc-bouvier commented 7 months ago

Ah ouais! pour celleux qui veulent générer des trucs à l'aide de bash!

bertrandkeller commented 7 months ago

Gros enjeux qui peut permettre à des novices d'avoir accès à plein de trucs sympas. Normalement bash est dispo sur les machines Windows (?)

On peut imaginer appeler des API ou workers.

marc-bouvier commented 7 months ago

Sur Windows, on utiliserait plutôt Powershell (qui fonctionne maintenant sur linux/macos également) par contre pas forcément très utilisé.

Si on veut faire des CLI pour plusieurs OS faciles à installer, ces dernières années on voit apparaitre des choses en Go, Rust, et parfois javascript.

Une fois packagé, ca fait un binaire unique qu'on peut télécharger.

Ca serait assez sexy pour les populations de développeurs d'avoir une cli frago. Ca pourrait amener de nouveaux gens à adhérer au projet.

Outils pour développer des outils CLI : https://github.com/shadawck/awesome-cli-frameworks

Autre approche : outils de scaffolding basés sur des templates

bertrandkeller commented 7 months ago

Il faut garder une approche grand, grand débutant. C'est le public visé. Le reste c'est du plus.

Tu as un référent qui fait pas de ligne de commande, mais peut copier/coller une ligne. Et qui doit convaincre un "dev" (tu as tous les niveaux) qui doit installer ça sur une CI ou équivalent.

C'est le besoin.

bertrandkeller commented 7 months ago

Tu peux proposer des PR, je validerai.

marc-bouvier commented 7 months ago

l faut garder une approche grand, grand débutant. C'est le public visé.

C'est ce que j'avais compris effectivement. Merci de le confirmer à nouveau.

bertrandkeller commented 7 months ago

Faut faire une autre "issue" pour la CLI.

Y aurait peut-être des trucs très intéressants à faire. Notamment en lien avec l'observatoire. Un template Eleventy que j'ai codé pour aller appeler plusieurs Frago et aggréger de la donnée.

On pourrait lancer des tâches avant et après.

Avant pour convertir peut-être du YAML en JSON. Et voir si parser du JSON pour Hugo n'est pas plus rapide dans le cas ou il y aurait des centaines d'audits…

Après pour soumettre les données de l'API à l’observatoire…

Bref… faudrait faire un schéma de la données entre sa création et son exploitation dans un autre cadre (type observatoires).

marc-bouvier commented 7 months ago

@bertrandkeller peux tu donner un peu plus d'informations à propos de l'observatoire ? Je ne suis pas sur de savoir de quoi tu parles.

bertrandkeller commented 6 months ago

Ce que j'appelle observatoire ressemble à ça : https://metago.netlify.app/ (j'ai du reprendre tout le site car j'arrivais pas à gérer la mise à jour avec node…)

Ça appelle des api de différents Frago et ça génère un site qui affiche les résultats.