markdown

Opening Science - the Book

Martin Fenner
December 5, 2013 1 min read

Opening Science: The Evolving Guide on How the Internet is Changing Research, Collaboration and Scholarly Publishing (Opening Science – The Evolving Guide on How the Internet Is Changing Research, Collaboration and Scholarly Publishing Openingscience.org, n.d.) is a SpringerOpen book (using a Creative Commons Attribution-NonCommercial license (http://book.openingscience.org/cases_recipes_howtos/creative_commons_licences?)) that will be published in a few weeks. If you can’t wait for the book to be published and/or you want to make comments or suggestions, go to the dynamic book online version at http://book.openingscience.org (http://book.openingscience.org/?). I am an author or co-author of three chapters (Reference Management (http://book.openingscience.org/tools/reference_management?), Altmetrics and Other Novel Measures for Scientific Impact (http://book.openingscience.org/vision/altmetrics?), Unique Identifiers for Researchers (http://book.openingscience.org/cases_recipes_howtos/unique_identifiers_for_researchers?)) and have helped put the dynamic book together. The book is generated from markdown files hosted in a public Github repo (https://github.com/openingscience/book/?) using Jekyll (http://jekyllrb.com/?) and Pandoc (http://johnmacfarlane.net/pandoc/?), and we use Prose (http://prose.io/?) to enable online editing of the content.

Using markdown, github, jekyll and pandoc is nothing new for blogs, but this is probably one of the first scholarly books using this workflow. The dynamic book is therefore still very much work in progress and feedback is greatly appreciated.

Another great example using a very similar workflow is the upcoming book Advanced R Programming (http://adv-r.had.co.nz/?) by Hadley Wickham, but he is of course using R and knitr (http://yihui.name/knitr/?) to create most of the markdown. In contrast to Hadley we stored the individual chapters as Jekyll posts rather than pages, as this better integrates with other Jekyll functionality, e.g. tags.

Carmeliet, P. (2005). Angiogenesis in life, disease and medicine. Nature, 438(7070), 932–936. https://doi.org/10.1038/nature04478
Contopoulos-Ioannidis, D. G., Alexiou, G. A., Gouvias, T. C., & Ioannidis, J. P. A. (2008). Life Cycle of Translational Research for Medical Interventions. Science, 321(5894), 1298–1299. https://doi.org/10.1126/science.1160622
Opening Science – The Evolving Guide on How the Internet is Changing Research, Collaboration and Scholarly Publishing openingscience.org. (n.d.). Retrieved February 21, 2021, from http://www.openingscience.org/get-the-book/
The Nobel Prize in Physiology or Medicine 2005. (2015). In web.archive.org. https://web.archive.org/web/20150814032045/http://www.nobelprize.org/nobel_prizes/medicine/laureates/2005/index.html

Other Formats

ePub PDF JATS