Citing and References
obstschale opened this issue · comments
Do you have any intention how to cite in this book. I think a bibliography with a Harvard Style is not needed but it would be good to give some links and sources which are used for a chapter. So the reader can get more information if needed.
Two simple possibilities are in my mind:
- Just use one markdown file at the end of the book an list all references ordered by chapter
- add a section to the end of each chapter for Further Reading
I personally like the second one, because if I read a chapter and have some questions I have all links at my fingertips and don't have to check the references page.
Further reading sections sounds like a good idea, though I'm generally linking out on the references with inline hyperlinks
Sure, if I mention something in the text, like I did with VagrantPress, I just link it. But for example I know a great article about Debugging. It would not mention that article directly rather set a link in the Further Reading section.
Mozilla does this nicely , for example https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript you can see linked "read more sections" , it's actually not a blockquote but just a div called "note" with specific styling.
You can use HTML in markdown but I don't think that is a good idea to introduce custom stylings. We should stick to the simple Markdown.
Although it looks nice ;)