saltudelft / software-analytics-book Goto Github PK

I think that it would be nice to be able to easily view the current version of the book. Such as the following: software-analytics-book (on our fork). This also provides easy access to the pdf/epub without having to go through the LaTeX hassle.

To enable this you'd need to set the GITHUB_PAT environment variable in Travis CI to a Private Access Token from GitHub. (Make sure to keep it secret so it can't be used from pull-requests and misused in general.)

And in the repo the GitHub pages source needs to be enabled.

The site would show up at https://saltudelft.github.io/software-analytics-book/

@gousiosg wrote in the Brightspace announcement: "I've updated the book front mater to use the ACM format." However, this has not actually happened, and I tried to do it myself, but failed miserably.

When changing the biblio-style from index.Rmd from apalike to acm, the build script fails with the error message "! Package natbib Error: Bibliography not compatible with author-year citations."

When changing the biblio-style to plain, the PDF has numeric citations, but the HTML still has author-year citations.

From the announcement:

- Content: You need keep all content in one place (no online tables etc). Move all tables to an appendix per chapter.

As per https://bookdown.org/yihui/bookdown/markdown-extensions-by-bookdown.html#special-headers It is pretty easy, but appendices should be at the end. So you can't create a chapter appendix in this way.

How should this look?

Example from #21: https://travis-ci.org/saltudelft/software-analytics-book/builds/435361483#L1116

Example where the build fails due to duplicate keys in the book.bib: https://travis-ci.org/chart-increasing-keyboard-Analytics/software-analytics-book/builds/435554106 (different branch)