Re: GitHub (or similar) for asciidoc publishing
Posted by
mojavelinux on
Feb 09, 2021; 6:39pm
URL: https://discuss.asciidoctor.org/GitHub-or-similar-for-asciidoc-publishing-tp8483p8485.html
I second Abel's recommendation for GitLab. Not only does GitLab support AsciiDoc includes, diagrams, and more, it's also open source. On top of that, support for AsciiDoc on GitLab was contributed by the Asciidoctor community, mostly notably by Guillaume.
If you do need to stick with GitHub for some reason, then what you'll want to do is use GitHub Pages via GitHub Actions. While you won't see support for AsciiDoc includes and diagrams in the repository themselves, you will see them in the files published to GitHub Pages. And it can all stay "in house" so to speak.
But really where you want to be is GitLab.
Best Regards,
-Dan
On Tue, Feb 9, 2021 at 7:27 AM abelsromero [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
Third-patform support is not really on the Asciidoctor team hands. Collaboration is there, but at the end is up to each platform to decide what features to support.
Said that, GitLab has been more open and does support includes and some diagrams https://docs.gitlab.com/ee/user/asciidoc.html.
On GitHub you will need to resort to preprocessing files (embedding with scripts) and Kroki for diagrams https://kroki.io/.
--