wordings.md

Wordings

Wordings globaux (templates, vues...)

La gestion des wordings des templates et layouts se fait à travers les fichiers i18n, présent dans config/locales/.

Pour certaines pages, c'est directement codé dans le HTML. C'est le cas des pages suivantes:

• /mentions
• /cgu

L'architecture des clés au sein du YAML suit l'architecture des fichiers au sein du dossier app/views. Par exemple, pour la vue app/views/endpoints/show.html.erb, le YAML sera architecturé comme suit:

---
fr:
  endpoints:
    show:
      title: "Titre"

Et au sein de la vue, pour retrouver le title ci-dessus:

<h1><%= t('.title') %></h1>

Page/wordings FAQ

Les wordings de la FAQ globale se trouvent dans le fichier config/locales/faq_entries.fr.yml

Pour chaque entrée, la clé answer est traduite du markdown au HTML (le markdown supporté est le Github Flavored Markdown)

Par défaut la page affiche directement les résultats de Algolia, si vous voulez, en développement, afficher directement le texte que vous modifiez, ajouter à l'url ?disable_search.

Niveau éléments graphiques DSFR, une cheatsheet (des exemples sont aussi disponibles dans le fichier de locale):

Les tableaux

{:.fr-table}
| Header 1 | Header 2 |
| -------- | -------- |
| Value 11 | Value 12 |
| Value 21 | Value 22 |

Les mise en exergues

{:.fr-highlight}

> Texte

{:.fr-highlight.fr-highlight--caution}

> Texte qui exige de l'attention

{:.fr-highlight.fr-highlight--example}

> Texte de type exemple

Les boutons

Bouton primaire bleu du DSFR :

[Texte du Bouton](https://www.google.fr}{:target="_blank"}){:.fr-btn}

Bouton secondaire blanc contour bleu du DSFR :

[Texte du Bouton](https://www.google.fr}{:target="_blank"}){:.fr-btn fr-btn--secondary}

Les liens externes (qui ajoute le picto externe)

[Lien externe](https://www.google.fr}{:target="_blank"})

De plus, il est possible d'utiliser les helpers de routes et d'images avec de l'interpolation ERB.

Les routes:

Le lien du profile: [Profile](<%= user_profile_path %>)

La liste des urls sont disponibles en tapant la commande rails routes ou depuis ce fichier : https://gist.github.com/skelz0r/48f3f6f4be8356f37e79368cfaa6e4f6

Route vers les fiches métiers :

Exemple de la fiche métier de l'endpoint unités légales de l'insee :

Le lien du profile: [Fiche métier "Données de référence d'une unité légale diffusible"](<%= endpoint_path(uid: 'insee/unites_legales_diffusibles') %>)

Route une question précise de la FAQ :

[Exemple de lien vers une ancre de la FAQ](<%= faq_index_path(anchor: 'quelles-sont-les-conditions-d-eligibilite') %>)

Les images:

![Description image](<%= image_path('loading.gif') %>)

Le 'loading.gif' doit être le chemin vers une image valide (ie dans app/assets/images)

Utilisation Ruby

A noter qu'il est aussi possible d'utiliser du ruby dans la vue (même si ce n'est pas du tout recommandé):

Il y a en ce moment <%= User.count %> d'inscrits