Refonte de la documentation MDwiki about stylo

[ggrossetie]

Je viens de voir que c'est live! C'est beau 😍
Petit détail, je constate une double scrollbar sur Chrome/Windows :

[ggrossetie]

Si on peut avoir https://doc.stylo.huma-num.fr ça serait pas mal

[ggrossetie]

Je vote pour Eleventy qui est très flexible et configurable. Je l'ai utilisé pour créer https://asciidoc.org/ et c'était top 👍🏻

[antoinentl]

Liste de choses à faire (dans l'ordre) :

• mettre en place 11ty @loup-brun
• configurer des templates (menus/page d'accueil/pages de documentation/pages statiques) @loup-brun @giuliaferretti12
• configurer le multilinguisme @loup-brun
• créer un thème/graphisme (inspiration : https://spacebook.app/) @loup-brun
• création des contenus de la page d'accueil (voir pad en privé) @giuliaferretti12
• configurer markdown-it-biblatex (https://github.com/arothuis/markdown-it-biblatex/) pour les pages qui listent les publications autour de Stylo @loup-brun
• en option : créer un blog/journal (pour tester : créer des entrées pour les releases les plus récentes) @antoinentl @giuliaferretti12
• configurer l'hébergement et le déploiement
• demander un sous-domaine doc.stylo.huma-num.fr @antoinentl

Quelques détails :

• redirections : avec une page HTML et une balise meta qui renvoie depuis /fr_FR vers /fr par exemple
• hébergement : décider si on conserve GitHub Pages (autres options : serveur du labo, serveur d'Huma-Num)
• par la suite : prévoir une section sur certaines pages pour des usages plus avancées (édition du YAML, commandes LaTeX)

[thom4parisot]

@antoinentl y'a moyen de faire fonctionner stylo.huma-num.fr/docs sans que ça soit servi par l'application Stylo. Des fois que ça vous fasse moins de boulot.

[antoinentl]

Merci @thom4parisot pour la précision ! A priori on partait plutôt sur doc.stylo.huma-num.fr pour servir la documentation, notamment pour se laisser la souplesse d'héberger la documentation ailleurs.

[ggrossetie]

Cela pourrait être intéressant de (re)configurer Netlify afin d'avoir une prévisualisation des changements qui impactent la documentation: https://docs.netlify.com/configure-builds/monorepos/#build-multiple-sites-from-a-monorepo

[thom4parisot]

Merci @thom4parisot pour la précision ! A priori on partait plutôt sur doc.stylo.huma-num.fr pour servir la documentation, notamment pour se laisser la souplesse d'héberger la documentation ailleurs.

C'est aussi possible avec un répertoire, via un mécanisme de reverse proxy. C'est le mécanisme actuellement employé pour que stylo.huma-num.fr/api pointe vers un serveur Node.js local (127.0.0.1:3030). Et ça fonctionne avec une origine distante (par exemple, une adresse GitHub Pages).

stylo/infrastructure/files/stylo.huma-num.fr.conf

Line 65 in 0fa84e7

proxy_pass http://graphql_stylo;

[loup-brun]

Inspiration

Read The Docs (exemple)

---

Zotero web (avec les colonnes)

---

Docusaurus clair/sombre (exemple)

[loup-brun]

• Suite au merge #858, il reste à configurer le DNS stylo-doc.ecrituresnumeriques.ca pour pointer vers Netlify. @loup-brun
• Du côté de Netlify, il faudrait lier le domaine avec le projet (c'était déja fait pour les previews, comme on pouvait tester dans le fil de la PR #858). @ggrossetie

EDIT voir commentaire suivant ainsi que PR #926

[loup-brun]

Autre option : utiliser GH Pages pour construire le site 11ty. Ainsi, Netlify n'est utilisé qu'en preview et rien à modifier de la part de @ggrossetie, et pas besoin de changer les DNS non plus.

[loup-brun]

Je viens de voir que c'est live! C'est beau 😍 Petit détail, je constate une double scrollbar sur Chrome/Windows :

Hourra, les double scrollbars... la marque Stylo n'est pas belle non plus sur windows, avec le petit triangle presque détaché...

[ggrossetie]

Apparemment c'est spécifique à Chrome/Edge, sur Firefox ça s'affiche bien 😅

[loup-brun]

Je vais tester, on ouvre une issue pour ça?