Closed MattBlissett closed 5 years ago
With a basic service like Gitbooks
With a service like Electric Book Works:
Self-hosted:
Thanks, Matt—it was great to have you available to weigh and test all this in real-time.
Note that neither Gitbooks nor Electric Books Works use Asciidoc: the former was an initial experiment of mine, and the well-documented workflow attracted my attention to the latter.
We need to investigate other Asciidoc service providers to have viable, non-self-hosted options—like OpenDevise. They maintain Asciidoc and also produce Antora, which looks very much like the kind of tool we might want.
Closing in favour of open issue #13 on the last unresolved item here: 'how much to integrate with the portal'.
Current thought is that this will be done through card-based 'features' on a planned landing page template for the site's documents. Curated access to individual docs (and even potentially sets of docs).
The Asciidoc experiment is a two-line Jenkins build, so there's probably not much overhead for Informatics. This helps us compare other free/commercial services. I had thought they were offering a lot more, but there are probably still some features that wouldn't be worth our time to implement, like print colour profiles.
Decisions:
I suggest: