Publishing Chunked Book, Split by Chapter #34
Unanswered
tajmone
asked this question in
Dev Strategies
Replies: 1 comment 2 replies
-
Good idea. The multi-pages are better for the search engines and they will increase the loading speed. The disadvantage is that you have to switch pages afterwards, which could be annoying over time. On PC, fortunately, you can also use the keyboard keys ← and →, but on tablet, screen swipe to left or right doesn't work. Maybe the side menu is causing the problem. BTW: It would be good if it was possible to hide this side menu to have more space for the actual content of the page on small screens. Node.js is already required for SVGO, but yes, as you mentioned before, diagram creation is not part of the main build process. |
Beta Was this translation helpful? Give feedback.
2 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
@SicroAtGit, in the past week I've been experimenting with a new tool that allows chunking AsciiDoc generated HTML files into multi-parts. The results are good, so I was thinking that we could split the Git Book into chapters on the GHPages website, and maybe offer the single-file stand-alone version for download and offline reading.
What do you think?
If it's OK with you, I'll proceed to publish the book split by chapters, and also work out a way to include into the repository a single-file version (embedded images, to be portable) and add some conditional directives so that on the website version a direct download link is provided for those who wish to download the single HTML file for offline reading.
It might take some time, since I'll have to fiddle with Rake, do some tests, etc., but it's doable.
Unfortunately the chunker tool is a Node.js app, which means that we'll be adding Node.js to the project dependencies:
https://github.com/wshito/asciidoctor-chunker/
Beta Was this translation helpful? Give feedback.
All reactions