Cette section de la documentation traite de la question de la publication des articles sur le site.

Ces informations sont amenées à changer en fonction des développements de TowSty.

Une bonne pratique

Comme nous l'avons évoqué au cours des développements précédents, une bonne pratique peut être de travailler au sein d'un espace de travail spécifique qui ne soit pas directement celui d'ecrisoi-site-web, mais qui peut-être un espace de travail personnel ou partagé avec d'autres rédacteurs ou éditeurs à la seule fins de produire, de corriger et d'évaluer un article avant sa publication.

Cette façon de procéder vous assure qu'au moment de la mise à jour du site, seuls les articles qui ont été spécifiquement choisis pour être publiés le soient. En effet, si un article a été rattaché à l'espace de travail ecrisoi-site-webet à un de ces corpus, il sera automatiquement publié quel que soit son degré de révision lorsque la mise à jour sera effectuée.

Nous déconseillons donc de créer un article et de le rattacher tout de suite à son futur espace de travail.

Comment publier sur EcriSoi

Comme le site s'appuie profondément sur Stylo, la publication d'un article revient donc simplement à le rattacher à l'espace de travail ecrisoi-site-web et au corpus auquel celui-ci doit appartenir. Nous renvoyons à la documentation générale sur cette question, mais aussi à la documentation de chacun des corpus.

De la même manière, si vous souhaitez retirer un article, parce que son traitement n'est pas le bon ou que le site vous précise qu'il y a une erreur, vous pouvez décocher les cases du rattachement à l'espace de travail ecrisoi-site-web de manière à pouvoir corriger sereinement le problème.

Pour l'instant, la mécanique de mise à jour du site n'est pas encore publique. Veuillez nous contacter lorsque vous souhaitez mettre des articles en ligne. Il est d'ailleurs sans doute préférable de se coordonner pour effectuer une telle opération.

Les problèmes

Les problèmes arrivent. La syntaxe du YAML, par exemple, est précise. Notre ingénieur a travaillé très dur afin que, même en cas de problème, le site fonctionne malgré tout. Si votre article n'apparaît pas après une mise à jour, alors que pourtant vous l'avez bien rattaché, c'est alors sans doute qu'il contient une erreur.

Que faire ? Vérifiez bien la syntaxe des métadonnées, reprenez le modèle qui doit être celui du corpus auquel vous souhaitez rattacher votre article. Vérifiez la syntaxe, c'est-à-dire la présence des deux-points, des guillemets, des espaces, des retours à la ligne, des éventuels tirets ou crochets lorsqu'ils sont nécessaires. En cas de doute, référez-vous aux différents guides présents dans cette documentation.