Create ebook from docs
This is asked by a customer, but it would be a good addition overall. We'd like to have a pdf version of docs, ideally epub and mobi files.
Proposal
Use GitBook's ability to convert to ebooks https://toolchain.gitbook.com/ebook.html.
- We need a
SUMMARY.md
file in the root dir of our docs which relatively links to all documents. Since we pull from different projects we need this file inside each project (CE, EE, Omnibus, Runner). - We also need a
book.json
file that will hold the book info, like title, description, etc. - We should remove all documents that direct to new locations with sth like:
grep -R "^This document was moved" . | cut -d':' -f1 | xargs rm
- Relates to https://gitlab.com/gitlab-com/gitlab-docs/issues/48 since it involves creating correct index files. Once we have them we could hack our way to automatically create
SUMMARY.md
from those index files.