As I was writing my own book using Asciidoctor, I kept running into others who had done the same when looking for solutions to problems I was having.
Many of the authors took time to document their experiences online, which was helpful for me to read through and try to pick up via osmosis.
So, I wanted to consolidate some of those links into a list.
If anyone has other examples, please, please send me links via @vilimpoc or via email. Thanks!
JHipster Mini Book
- http://www.jhipster-book.com/#!/news/entry/rough-draft-is-finished
- https://raibledesigns.com/rd/entry/re_customizing_an_asciidoctor_pdf
- https://www.infoq.com/minibooks/jhipster-mini-book-5/
Game Programming Patterns
This one is not strictly about Asciidoc, but good info on the overall layout process with physical and electronic books.
- http://journal.stuffwithstuff.com/2014/11/03/bringing-my-web-book-to-print-and-ebook/
- http://gameprogrammingpatterns.com/
The Starling Manual + Handbook
- http://discuss.asciidoctor.org/Post-Mortem-The-Starling-Handbook-td5633.html
- https://manual.starling-framework.org/en/
Awesome Asciidoctor Notebook
I’ve run into this website multiple times when searching for solutions to Asciidoc formatting problems.
There are a ton of entries covering many different aspects of writing with Asciidoc.
- https://leanpub.com/awesomeasciidoctornotebook
- https://mrhaki.blogspot.com/search/label/Awesome%3AAsciidoctor
- https://www.mrhaki.com/books.html
Codewriting: Collaborative Documentation Ops for the Agile Age
An Example Of What Not To Do
This one’s kind of an example of things not to do when designing book content, at least based on the screenshots.
Featured image: “Three women work at the card index files at the headquarters of the National Woman’s Party in Washington, D.C.”, 1920 (Source: Library of Congress)