search

kellertuer / Kartei

Eine Karteikartenklasse für LaTeX
48 stars 23 forks source link

Translating manual / README into English #8

Open mandarg opened 7 years ago

mandarg commented 7 years ago

Hi,

I found your package while looking for a LaTeX package for flashcards, and so far, it seems like exactly the sort of thing I was looking for.

I would like to help by translating as much of the instructions, etc. as I can into English – so perhaps it can become accessible to a wider audience.

Firstly, would you be interested a pull request for such a translation? I have an example translation of the first page of the manual in my fork. Your project page does mention Instructions in English.

If the answer to the above is yes, what do you think would be the best way to go about doing this? I can see a few options:

  1. Retain single files (e.g. README.md, manual.pdf, and just have sections of German and English text in each.

  2. Have separate files for English and German README.md, README-en.md, manual-en.pdf, etc. (This is the approach I am currently taking in my repo).

  3. Simply maintain a different branch in Git for the English translation, and (I'm not quite sure how this would work) generate -en releases from it or something.

  4. Something else?

Anyway, let me know what you think!

kellertuer commented 7 years ago

Oh that sounds like an awesome idea, I always wanted to translate is but never got the time to. I think it would be good to habe one readme (first english then german block) and two manuals; but one branch. The only thing I am not so sure about is whether we should be equally authors of the manuscript; just because I don't know how other LaTeX projects do that. I'll check for that but I think it would be nicer to have you mentioned as „translated to english by“ or something?

mandarg commented 7 years ago

Thanks for answering all my questions perfectly!

I don't care about the authors thing, I'll remove my name from the \author and maybe add a footnote somewhere if (hopefully when) I finish the translation.

kellertuer commented 7 years ago

It does not have to be a footnote, just a was to distinguish between coding and manual :) Im fine e.g. with

my name

translated to english by your name

:)

joelfischerr commented 6 years ago

@mandarg Are you still working on the translation?

It might be smart to translate the readme and the beispiel.tex first and only then start with the manual.

mandarg commented 6 years ago

@joelfischerr I haven't worked on it in a while; but translating the README and beispiel.tex first is a good idea. I'll get a PR up for that.

mandarg commented 6 years ago

Opened PR #14, which also fixes issue #11.