Proposer un article#

La rédaction d'articles est ouverte à toute personne souhaitant partager une expérience, l'histoire de la conception d'une carte, une méthodologie, un outil, un tutoriel, un billet d'humeur ou autre tant qu'il ne s'agit pas d'une publicité ou d'un communiqué ou contenu assimilable.

Gardez en tête que le travail de l'équipe est bénévole. A ce titre, plus votre contenu est conforme à nos prérequis et aux guides de contribution, moins il ne demande de travail de notre part. Ce que vous ne faites pas, nous devrons le faire.

Bref, appliquons le principe du fair-use au bénévolat !

Rédiger#

Allez, cette fois, c'est parti ! L'angoisse de la feuille blanche n'a qu'à bien se tenir, vous êtes prêt/e à coucher votre prose !

Comme indiqué dans les prérequis, qu'importe le flacon, tant qu'on a l'ivresse de la rédaction en Markdown : du simple éditeur de texte (oui, même le bloc-notes de Windows !) à l'éditeur lourd (à ce propos voir le dossier de Next INpact), faites votre choix !
Mais sachez que nous mettons un éditeur collaboratif (Hedgedoc) à disposition des contributeur/ices sur simple demande.

Sinon, cela tient en quelques étapes :

1. Créer un fichier Markdown (extension .md ou markdown)
2. Copier/coller le modèle d'article dans votre fichier depuis Github
3. Remplir les parties !
4. Faire relire

Lire et s'appuyer sur les guides de rédaction :

• bases du Markdown et spécificités de l'implémentation utilisée sur le site
• insérer des medias :
  • images
  • des vidéos
  • des émojis
  • des diagrammes (schémas)
  • des tweets
• gérer les métadonnées
• signer son article
• choisir une licence

Problème ? Souci ? Angoisse ? Simple question ?

Contacter l'équipe pour échanger

Soumettre#

Une fois le contenu prêt, il ne reste plus qu'à pousser le contenu sur le dépôt GitHub. La procédure est différente selon si vous des droits en écriture ou non sur le dépôt GitHub. Ces droits sont généralement réservés aux contributeur/ices régulier/ères et aux membres de l'équipe.

Je n'ai pas accès en écriture#

Si vous n'avez pas l'habitude des plateformes basées sur Git, sachez qu'il va vous falloir :

1. Créer un dépôt dérivé (fork) sur votre compte GitHub à partir du dépôt GitHub original de Geotribu :

   Forker le dépôt GitHub

   

   Déjà forké auparavant ?

   A noter que si vous aviez déjà forké notre dépôt auparavant, il vous suffit de mettre à jour le dépôt dérivé sur votre compte via le bouton Fetch Upstream :
   

2. Ajouter votre article dans votre dépôt dérivé :

   • soit via Git (ou un outil l'utilisant) si vous ça vous parle,
   • soit directement depuis l'interface web de GitHub en cliquant sur Add file :

   

3. Nommer le fichier selon la convention de nommage content/articles/YYYY/YYYY-MM-DD_XXXXXX où :

   • YYYY est l'année de publication
   • MM le mois de publication prévisionelle
   • DD le jour de publication prévisionnelle
   • XXXXXX le nom de l'article sans les caractères spéciaux ou les mots superflus (prépositions...)

   Tip

   Penser à s'inspirer des articles déjà publiés !
   La date de publication pourra être amenée à changer selon les autres contenus planifiés.

4. S'il n'existe pas encore, créer un fichier avec une brève description de l'auteur/rice dans content/team/prenom-nom.md, puis intégrer ce bloc en suivant le guide adéquat

5. Créer la Pull Request¹ directement depuis votre dépôt dérivé via le bouton Contribute :

   

6. Adapter la description de la Pull Request en indiquant rapidement le sujet et la motivation de l'article :

   

J'ai accès en écriture#

1. Créer une branche en respectant la convention de nommage suivante article/XXXXXX où XXXXXX est nom de l'article en minuscules et sans caractère spécial

   

2. Créer un fichier selon la convention de nommage content/articles/YYYY/YYYY-MM-DD_XXXXXX où :

   • YYYY est l'année de publication
   • MM le mois de publication prévisionelle
   • DD le jour de publication prévisionnelle
   • XXXXXX le nom de l'article sans les caractères spéciaux ou les mots superflus (prépositions...)

   Tip

   Penser à s'inspirer des articles déjà publiés !
   La date de publication pourra être amenée à changer selon les autres contenus planifiés.

   

3. S'il n'existe pas encore, créer un fichier avec une brève description de l'auteur/rice dans content/team/prenom-nom.md, puis intégrer ce bloc en suivant le guide adéquat

4. Créer la Pull Request¹ en choisissant la branche de l'article comme source (head) et la branche principale (master ou main) comme destination (ref).

5. Adapter la description de la Pull Request en indiquant rapidement le sujet et la motivation de l'article

   

6. Demander la relecture sur Slack, dans le canal Articles

Publication et diffusion#

Voir la page dédiée.

Commentaires