I recently started to work on writing a book just for fun to publish it online and see if it works or not. Right now my toolchain consist of following tools:
I wrote sections using Markdown
I use Pandoc to convert it to latex for compiling it to pdf. It also gives me to ability to have a proper pdf with decent layout and style.
I use hugo as static site generator for online version of my book.
As far as I’ve played with hugo I’m not sure what is the best practice for publishing documentation and specially books. So please provide me with a guide line or something to help do this in a correct way
@michael_henderson thanks for you reply. and sorry for my late response.
I just want to make a pleasant read experience and I don’t need any buying or searching or anything dynamic.
TOC is good and I also need TOC to be available as a menu, just like Hugo’s documentation.
Page and Chapter forward and backward are good to have, but not necessary at start.
The book is mostly text and each chapter has two or more pictures.
So if Hugo support all these features I would wish for nothing more, and I must start diving deeper into Hugo to make myself fluent with all of these.
If the current Hugo documentation contains most or all the features you need for your on-line book, you may want to clone https://github.com/spf13/hugo and look inside docs/ and use that as a guide. @spf13 has done a great job getting the TOC and navigation work so nicely, and I am still learning wonderful tricks from it daily.
@anthonyfok@michael_henderson
Just to start I’ve copied entire documentation of Hugo and tried to do staff with it. But unfortunately all bodies are in the menu section and I don’t know what is wrong.
I’ve cloned git repository and my Hugo version is 0.12. Any ideas?
P.S. do Hugo have an IRC channel?
Update: I found the source of problem and it is rectified
