Investigate build and possible migration to something else

ncredinburgh / JavaForSmallTeams

Guidance on writing "good" server side java

https://www.gitbook.com/book/ncrcoe/java-for-small-teams

Other

69 stars 31 forks source link

Investigate build and possible migration to something else #37

Open iuliana opened 5 years ago

iuliana commented 5 years ago

Since building the current project files *.md to get a final printable PDF is not possible we have to look into how we can do this using something else. (LaTeX maybe)

Look into new gitbook.com and see if we can migrate to it.

fburato commented 5 years ago

The new gitbook has some limitation when it comes down to different media publishing support:

Doesn't support pdf export (source)
Doesn't allow to edit directly in Markdown (allowed only through the github integration, source)
It is not based on versioning (source)

iuliana commented 5 years ago

So, nothing that we need from it really. This is weird. This one cracked me up: instead we store rich JSON data structures. I cannot even imagine writing a book in JSON.

fburato commented 5 years ago

This seems to have everything, but might be a little complicated: https://github.com/rstudio/bookdown

fburato commented 5 years ago

Always on bookdown, I found some interesting articles for a starter kit: http://seankross.com/2016/11/17/How-to-Start-a-Bookdown-Book.html