Compilation to PDF and epub

[jnavila]

Hi all,

I'm in the process of making an automatic publication of the book on git-scm.com, using asciidoctor and Travis-CI for generating the PDF and epub. That should solve #56 .

This rework requires to move files around, change how cross-refs are done and change build script. This is quite disruptive and would cause conflicts with ongoing changes.

Please ping me when the repo is idle, so that I can make the transition before you guys restart your work.

Thanks,

[jnavila]

Ping @andres-mancera

[andres-mancera]

@jnavila : Quick Question: Has this new flow for the automatic publication of the book been enabled for any language or even the original English version?

[jnavila]

Yes, it has. You can see the result on https://git-scm.com/book . For all the translations with this workflow, there are the availability to download the books in pdf, epub and mobi files.

[andres-mancera]

Ok, I don't have any pending pull request right now, so please go ahead and make the required changes. Let me know if you need anything from me. Thanks @jnavila 👍

[jnavila]

Just a heads up to indicate that the book is not compiling right now. This is mostly due to remains of conflicts marks that weren't removed.

[andres-mancera]

Is there some kind of log that I can take a look at so that we can fix the issues(s)?
Otherwise, we'll be trying to find a needle in a haystack!

[jnavila]

Don't worry, I'm on it. The ugly thing about it is that the errors of compilation don't point to the place where the mistake was made, but where the parser can no longer cope with the errors. The branch should be ready before this week end.

[andres-mancera]

Great, thanks a lot for your help @jnavila 😃

[andres-mancera]

@jnavila : After your changes, I see that the "contributors.asc" file now has a link to a file called "contributors.txt". However, I don't see that file anywhere. Where did the list of contributors go?

[jnavila]

The file contributors.txt is now dynamically created by the Rakefile

progit2-es/Rakefile

Lines 46 to 47 in b665495

	puts "Generating contributors list"
	exec_or_raise("git shortlog -s --all| grep -v -E '(Straub|Chacon)' | cut -f 2- | column -c 120 > book/contributors.txt")

It is always up to date with the correct list of contributors. You can run the command line in order to generate it for yourself, without requiring the full ruby environment.

[andres-mancera]

I see. Thanks @jnavila 👍