Gitbook Versioning (For 3, 4, etc)

[gillianml]

Figure out Gitbook Versioning

AC:

• a link to gitbook versioning capabilties
• a plan of how to use them for subsequent releases of A2.

Timebox: rough 0.5d

[troyt-42]

There is a link showing how to read specific version of a gitbook, and it depends on branch, tag, or SHA of a commit of the repo. So I made a demo book for further discussion.

[bennett000]

I propose we use a tagging system to do this. I also notice there is an example of this working on one of our other GitBooks.

[bennett000]

I will need to check up on how it works, then I'll actually add a cards as needed.

[bennett000]

@watrool if you have capacity would you be able to rebase this and test what happens when we generate a pdf?

[troyt-42]

@bennett000 I rebased https://github.com/rangle/ngCourse2/pull/756, and opened the E-Books downloads setting of the demo book. But the provided download link does not seems to be working... Could you take a look on this: https://www.gitbook.com/book/watrool/ngcourse2/details ?

[bennett000]

@watrool thanks. I'm not sure why that link doesn't work. I'm guessing it's related to your version not being published?

You might be able to test this manually: https://github.com/GitbookIO/gitbook-pdf

(I've never tried the above link, it might not work or there might be something better)

[troyt-42]

@bennett000 It turns out that to generate pdf locally using gitbook pdf command, we need to download Calibre. And by testing the pdf book locally, I found one issue about font: setting font-family in my css leads to a disappearance of the label content (i.e. 2.0.0-RC.6). Other things seem to be working well. I tried to manually include @font-family in the pdf.css (which is supposed to be applied when generating pdf), but still fails.

[bennett000]

This is closed for now. We will need a solution for when Angular 3 comes out, but since there are not going to be any breaking changes this card is no longer needed.