How to translate to other language?

[ponyatov]

How to translate to another language?

I forked original to my GitHub and opened selected russian branch. Should I send pull requests? Are any limitations exist related to copyright/left, for example, can I extend translation more than original with extra themes, or change format (LaTeX markup or something like this)?

[ponyatov]

How can I publicize translation via GitHub pages not impacting on the master branch? Why Makefile for html/pdf render not included in the distro?

[narimiran]

Hello! Thanks for the interest in this tutorial!

Before anything else, I would like to tell you that I'm currently working on a small update, which will make sure that everything still works with v1.0, fix some typos, reword some sentences, and similar stuff. It shouldn't take longer than a day or two (I hope).

---

[can I] change format (LaTeX markup or something like this)?

If the translation would be a separate website then LaTeX is fine (although I think it will be easier for you to keep AsciiDoc and just change the content). If you would like that the translation is incorporated into the existing website so that there are links to the English and Russian versions, sticking to AsciiDoc seems to be the way to go.

can I extend translation more than original?

When it comes to content, there should be no extra chapters/examples/content than in the original.

If you think something in the existing chapters is missing: please open an issue or send a PR. Additional chapters should not be added, as those topic might go into the "level 2 tutorial".

... with extra themes?

What did you have in mind? I think the answer is similar to the one about changing the format. If you want to have a separate website, it is ok to use a separate theme.

Why Makefile for html/pdf render not included in the distro?

You're right, building instructions should be included in the readme.