Pipeline alternative

[wiztigers]

Salut,

En parcourant github pour voir si, par hasard, il n'y avait pas des projets similaires au mien, je suis tombé sur le votre. Bon, moi je fais du Savage Worlds + Earthdawn, donc je n'ai pas vraiment de suggestions concernant le contenu proprement dit de ce Savage Worlds + Star Wars.

Cependant, mon point de vue est que quelqu'un de motivé à contribuer n'est probablement pas un dev, et ne sait probablement pas compiler un document. Étant donné qu'on va pas se mettre à commiter du binaire à la main, j'ai mis en place une pipeline qui se sert d'asciidoctor pour me produire à partir du même source d'origine human-readable plusieurs documents de sortie en différents formats (.html, mais possiblement aussi .pdf, .tex, .epub ou autre), et de travis-ci pour commiter le tout sur github pages. Résultat, je peux à tout moment avoir les dernières versions de mon document en ligne en restant maître de leur style, pour que la barrière d'accès à ce que je fais soit nulle, et que les gens puissent les consulter avant de, peut être, contribuer -au lieu de devoir cloner puis compiler avant de pouvoir ne serait-ce que lire.

Juste histoire de comparer avec ce que vous faites :

• le dépôt : https://github.com/wiztigers/SavageOfLegend
• le site web : https://wiztigers.github.io/SavageOfLegend

'Hésitez pas à me contacter si ça vous intéresse mais qu'il y a un truc pas clair dans le process.

ps. C'est toujours cool de rencontrer d'autres rôlistes ! ｡◕‿◕｡

[Marthym]

Bonjour,

Ouais j’avoue c’est sympa de croiser d’autre rôliste et des gens qui sont dans la même trip.

Au début quand je suis parti sur cette idée, je me suis posé la question du support, Markdown, Asciidoc, latex … Mais je voulais un PDF qui est un peu de gueule et aussi pouvoir diviser en plusieurs chapitres et à part LaTeX, ya pas grand-chose qui est un rendu vraiment sympa. Mais c’est vrai que du coup ça complique la contribution. Après c’est pas latex puisque pas mal de gens connaissance et s’en servent pour des rapports, thèse et autre, c’est plus le principe de git/github. Mais le principal c’est pas que les gens sachent faire, c’est qu’ils sachent que c’est possible. Après le comment c’est moins un souci, il suffit d’un message ici ou sur un forum et c’est moi qui fais la modif, ça s’est déjà fait plusieurs fois.

Après j’aurais bien aimé à partir des mêmes source générer un Markdown ou un Asciidoc pour avoir une version HTML du document, mais j’ai pas trouvé grand-chose pour faire ça, tu as peut-être quelque chose ?

J’ai été voir ton repo, ça rend bien, le site et le repo ! Et le style est sympa.

Enfin voilà, merci de l’intérêt

[wiztigers]

Re!
Désolé du délai de réponse, mais je voulais tester quelques trucs avant de répondre (et aussi ENFIN finir ces équivalences de sorts):

• Concernant le PDF qui a un peu de gueule, j'en ai généré quelques uns pour voir.
  Je n'aimais pas bien la tête du pdf que me générait asciidoctor-pdf (assez moche, et il lui faut une feuille de style spécifique pour le rendre beau, ce que je ne voulais pas faire). Alors j'ai utilisé wkhtmltopdf pour générer le pdf à partir du html au lieu d'à partir ma source, et après quelques ajustements (dont notamment changer de police pour les titres car l'originale est proprio et sans accents ni ponctuation) je suis franchement content du résultat, puisque j'utilise exactement la même CSS : une seule CSS pour dans les ténèbres les styler :)
  Prochaine étape : rajouter des règles spécifique à l'impression dans la CSS (cf. https://alistapart.com/article/boom pour une intro), pour pouvoir gérer au niveau CSS tout ce qui est header/footer/numéros de pages droite+gauche/sauts de page/etc
• Concernant la division en plusieurs chapitres, c'est tout à fait possible. Pour un exemple, tu peux regarder vers la fin de cet autre bouquin en cours d'écriture : tu as des lignes d'include de fichiers dans un sous-répertoire à coté. Je prévois d'utiliser cette fonctionnalité pour par exemple publier le bouquin, avec à coté le bouquin amputé des sections réservées au MJ, et à coté le bouquin incluant mes notes de conception pour les MJs que ça intéresse, etc ...
  De toutes façons, il semble que je devrai obligatoirement faire ce découpage en chapitres pour générer de l'EPUB ou du MOBI ...
• Je suis d'accord avec toi, je pense que même pour un néophyte, LaTeX est plus simple à éditer qu'asciidoctor, parce que tu as davantage de grands éditeurs WYSIWYG. Après, la dernière fois que j'ai cherché, c'était il y a assez longtemps quand même. 'Faudrait que je rejette un coup d'œil.
• Sinon, convertir de LaTeX vers asciidoctor, je n'ai jamais fait. Cependant, cela semble possible avec pandoc ... à tester !

Sinon, pour voir, j'ai cloné ton repo et j'ai essayé de générer le pdf correspondant des deux manières suivantes :

• essayé de générer avec Texmaker (j'ai juste utilisé LaTeX de base, rien genre XeLaTeX ou autre ...)
• reproduit ce que tu fais dans ton .travis.yml, avec latexmk

Les deux sans succès, il m'a dégueulé tout un tas d'erreurs que je ne comprends pas car je suis une loque en LaTeX.

Si tu t'en sens l'envie/le temps, je serais bien preneur d'une petite section dans ton README sur comment que toi tu génères le PDF ...
ps. je suis sous Debian 9.

[Marthym]

Bonjour, désolé aussi pour le délai, j'ai pas eu trop de temps cette semaine.

Ce qui m'intéressait surtout avec LaTeX c’est le rendu niquel, même si c’est clair que le fichier de formatage c’est fait dans la sueur et ls larmes. Mais iu fois fait le rendu est sympa et tout est automatique, césure des mots et des pages, chapitrage, couleur, liens externe.
J'ai regardé Pandoc mais j'ai pas eu le temps de creuser.

Pour la compil, je pense que c'est qu'il te manque des prérequis de module Latex. Après la chier d'erreur c'est normal ... mais c'est pas faut faudrait que je fasse un peu de doc.
Normalement il faut installer ça :

• gv
• texlive-base
• texlive-bibtex-extra
• texlive-extra-utils
• texlive-font-utils
• texlive-fonts-recommended
• texlive-lang-french
• texlive-latex-extra
• texlive-latex-recommended
• texlive-pictures
• texlive-xetex
• latexmk
• biber

Puis depuis le répertorie lancer latexmk -pvc -r swr-class/latexmkrc

Normalement ça génère bien le PDF