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] Build avec CircleCI #18

Open marc-bouvier opened 8 months ago

marc-bouvier commented 8 months ago

Nous somme en train de mettre en place Frago pour publier nos audits du site https://iroco.co

Comme nous utilisons la plateforme d'intégration continue CircleCI (comparable aux Github Actions). Voici un exemple de construction d'un site Frago sur cette plateforme.

Nous la compléterons avec un déploiement via Ansible (avec pour objectif de créer un rôle Ansible réutilisable par la communauté).

https://github.com/iroco-co/audits-frago/blob/main/.circleci/config.yml

Voici notre script de CI à l'heure actuelle :

.circleci/config.yml

version: 2.1

orbs:
  hugo: circleci/hugo@1.3.0

workflows:
  generate-audits:
    jobs:
      - hugo/build:
          version: 0.120.3
          hugo-extra-flags: --config hugo.toml
          html-proofer: false
          pre-steps:
            - checkout
            - run: git submodule sync
            - run: git submodule update --init
          post-steps:
            - store_artifacts:
                path: public
                destination: audits
bertrandkeller commented 8 months ago

Cool.

Est-ce besoin d'avoir des submodules ? Vous pouvez passer par les modules go. Mais c'est sûrement un choix.

Votre fichier d'audit RGAA contient les Tests, C'est plus facile de le faire sans les tests juste avec les critères. Faut supprimer une colonne.

marc-bouvier commented 7 months ago

Est-ce besoin d'avoir des submodules ? Vous pouvez passer par les modules go. Mais c'est sûrement un choix

Je suppose qu'en utilisant les submodules on peut être sur la dernière version. Avec l'inconvénient par contre de manquer de stabilité. A moins que les modules go le permettent aussi?

Dans notre cas je suppose que ça nous évite de rajouter la connaissance de go et de récupérer le thème sans s'en préoccuper.

Je ne sais pas si l'orb (extension CircleCi) supporterait les modules Go. Ca vaudrait le coup d'essayer.

marc-bouvier commented 7 months ago

Votre fichier d'audit RGAA contient les Tests, C'est plus facile de le faire sans les tests juste avec les critères.

Quand on a déroulé l'audit 25 critères avec @bamthomas, avoir le détail des tests nous a permis de documenter plus finement notre audit. Peut-être que quand nous serons plus aguerris avec la pratique on simplifiera.

bertrandkeller commented 7 months ago

Les go Modules, c'est les submodules sans les emmerdes des submodules.

Tu peux télécharger la version que tu veux, la version que tu veux… c'est pour ça que ça existe.

marc-bouvier commented 7 months ago

On va regarder ça de plus près du coup