Skip to main content

Rédiger les textes Formations/Règlements

Nous rejoindre sur Discord : lien discord

Objet : CréerEcrire son formulairetexte deen candidaturemarkdown.

Nous allonsavons vousamélioré expliquerla commentrédaction personnaliserdes les questionsrèglements présentessents sur les candidatures.sites Pourprincipaux cela(/reglements) vouset devezla modifierrédaction des livrets de formation présents sur les intranets (/formation). La rédaction de ces textes devait se faire en html et dans le fichier suivantTwig surdirectement. chacunDans la version 2.2.0. la rédaction des sitestextes internetse fera à l'intérieur de fichiers Markdown.

Le Markdown est un langage de balisage léger créé en 2004 par John Gruber avec l'aide d'Aaron Swartz. Il a été créé dans le but d'offrir une syntaxe facile à lire et à écrire. (Wikipédia)

Voici un lien pour savoir comment écrire en markdown : https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

Voici les éléments pris en compte dans la rédaction des textes :

  • Titre 1 : site/content/candidature.json#Titre 1

    => Anciennement : (<h1>Titre 1</h1>)
  • Titre 2 : ##Titre 2 => Anciennement : (<h2>Titre 2</h2>)
  • Titre 3 : ###Titre 3 => Anciennement : (<h3>Titre 3</h3>)
  • Image : ![decription](img) => Anciennement : (<img src="url" alt="description"/>)
  • Lien : [text affiché](lien) => Anciennement : (<a href="lien">text affiché</a>)

FichierExplication JSONde Candidaturela structure des fichiers

DansChaque lesite va posséder un nouveau répertoire /content/,nommé crÃcontent dans ce réezpertoire, il y aura les fichiers markdown (*.md) contenant les textes. Chaque répertoire possèdera également un fichier candidature.index.json. Danspermettant cede fichier,gérer ajoutezles fichiers markdowns.

index.js pour les sites vitrines

Voici une exemple de fichier json pour les sites vitrines :

{
  "questions"navigation": [
    {
      "type"nom": "list"Introduction",
      "title"identifiant": "Question n°1",
      "ecole": "Question n°1",
      "responses": [
        "Proposition 1",
        "Proposition 2",
        "Proposition 3",
        "Proposition 4",
        "Proposition 5"
      ]introduction"
    },
    {
      "type"nom": "text"Equipement",
      "title"identifiant": "Questionequipement"
    n°2},
    	(texte)etc...
    {
      "nom": "Organisation",
      "ecole"identifiant": "Questionorganisation"
    n°2"}
  ],
  "contenu": [
    {
      "identifiant": "introduction",
      "fichier": "introduction.md"
    },
    {
      "type"identifiant": "text"equipement",
      "title"fichier": "Question n°3 (texte)",
      "ecole": "Question n°3"equipement.md"
    },
    	{
      "type": "text",
      "title": "Question n°4 (texte)",
      "ecole": "Question n°4"
    },etc...
    {
      "type"identifiant": "list"organisation",
      "title"fichier": "Question n°5",
      "ecole": "Question n°5",
      "responses": [
        "Proposition 1",
        "Proposition 2",
        "Proposition 3",
        "Proposition 4",
        "Proposition 5"
      ]organisation.md"
    }
  ]
}

Navigation

VoiciLe lechamp principe de fonctionnement de ce fichier : ilnavigation permet de mettre en forme l'onglet de navigation qui apparaît sur les sites dans la page des règlements. Ce champ se comporte comme un tableau, c'est à dire que le premier élément présent dans le tableau sera le premier élément présent dans le menu de navigation. Voici comment définir lesun questions qui seront présenteslien dans lesla canddiatures. Cela permet alorsbarre de mettre un nombre non défini de question contrairement à avant où il fallait repecter le type. Pour le moment deux format sont acceptésnavigation :

Vous devez ajouter la structure suivante dans la section navigation. Le champ nom représente le nom qui sera affiché dans la barre de navigation. La clé identifiant est un indicatif permettant de lier un titre à un texte. Il est très important que l'identifiant présent dans la partie navigation ait une correspondance dans la partie contenue (nous verrons ça plus tard).

À la fin de chaque Structure {}, il faut ajouter une , sauf pour Choixle multipledernier :élément de la liste

{
 "type": "list",
  "title"nom": "Nom dequi la questionapparait dans le formulaire de candidature"menu",
 "ecole"identifiant": "Nomidentifiant rattaché au fichier markdown"
}

Contenu

Le champ contenu regroupe tous les fichiers markdown qui seront utilisés pour la rédaction de la questionpage. Chaque fichier contient un chapitre ou partie de la page. Comme pour la navigation, le premier élément présent dans le tableau contenu sera le premier élement affiché dans la page. Voici comment créer un chapitre dans la page.

Tout d'abord, vous devez rédiger le chapitre dans un fichier au format markdown, exemple :

#Loi Miranda
*“Vous avez le droit de garder le silence, si vous renoncez à ce droit, tout ce que vous direz pourra et sera retenu contre vous. Vous avez le droit à un avocat. Toutes vos communications vous ont été coupées, vous avez également le droit à des soins, à boire et à manger.”*

*Avez-vous bien compris vos droits ?*

**Pour les règles logiques non évoquées veuillez faire preuve de bon sens.**

Une fois que vous avez rédigé le chapitre, il suffit de renseigner le nom du fichier ainsi que l'intranet"identifiant auquel il est attribué (défini dans la section navigation). Vous devez ajouter la structure suivante dans la section contenu. La clé identifiant est l'identifiant défini dans la partie navigation. La clé fichier définit le nom du fichier présent dans le répertoire content. La clé type permet d'appliquer une mise en page spécifique. Si vous utilisez la même rédaction de votre loi Miranda que la notre cela peut être utile, dans le cas contraire, garder le type en normal.

À la fin de chaque Structure {}, il faut ajouter une , sauf pour le dernier élément de la liste

{
  "identifiant": "miranda",
  "responses"fichier": "miranda.md",
  "type": "miranda" // Le format miranda est spécifique au miranda par défaut utilisé le type : normal
}

index.js pour les intranets

La structure et le fonctionnement du fichier index.json pour les intranets COP et SECOURS est identique à celui des sites vitrines. Cependant pour les intranets, il n'y a pas de champ type pour les structures de la section contenu.

{
  "navigation": [
    {
      "Choixnom": 1""Introduction",
      "Choixidentifiant": 2""introduction"
    },
    	etc...
    {
      "nom": "Négociation",
      "Choixidentifiant": 3""negociation"
    }
  ],
  "contenu": [
    {
      "identifiant": "introduction",
      "fichier": "introduction.md"
    },
    	etc...
    {
      "identifiant": "negociation",
      "fichier": "negociation.md"
    }
  ]
}

ChoixLa multiple :

{
  "type": "text",
  "title": "Nomrédaction de lacette question dans le formulairepage de candidature",présentation "ecole":n'est "Nompas determinée. la question dans l'intranet"
}

Le fichier fonctionne sous forme d'un tableau. Voux pouvez ajoutez autant de questions queSi vous lerencontrer souhaitezdes difficultés dans la catégorie questions. La génération du formulaire et la récupÃdaction n'hérationsitez pas à nous contacter afin que l'on puisse vous aider. Vous pouvez également vous inspirer des informationsdocuments seprésents feradans automatiquement.les fichiers de bases.

Back to top