Re: [swift-dev] The Swift Programming Language Translations

2015-12-18 Thread Rogelio Gudino via swift-dev
Yeah I’m starting to have conflicting ideas about this. On the one hand the reader still needs to learn a decent amount of English to have a better idea of what the standard library’s structs/classes/functions do, so might as well keep all the code in English. On the other hand, they don’t have to

Re: [swift-dev] The Swift Programming Language Translations

2015-12-17 Thread Vinicius Vendramini via swift-dev
This sounds like a good idea, especially for the second benefit. I’m just gonna keep translating text for now, but I'll have to think of a solution for that later. Something else: I’ve been translating most parts of the code, such as variable and function names. The resulting code is a bit weir

Re: [swift-dev] The Swift Programming Language Translations

2015-12-16 Thread Rogelio Gudino via swift-dev
Don’t mind at all! However, I did decide to go with a different strategy. What I’ll try to do now is extract the content (mostly HTML) out of the English ePub, do translation work directly on it, and finally re-package the content into an ePub (generate-epub.sh). The benefits of this approach: 1

Re: [swift-dev] The Swift Programming Language Translations

2015-12-16 Thread Vinicius Vendramini via swift-dev
Sounds like a great approach. In any case, I guess the important part is actually writing the translation - the resulting format is only relevant once there is actual text to use with it. I’m creating a repo for a Portuguese (Brazil) translation: https://github.com/vinivendra/the-swift-programm

Re: [swift-dev] The Swift Programming Language Translations

2015-12-16 Thread Rogelio Gudino via swift-dev
I just started to look into this myself since I’m interested in doing the Spanish translation. The first approach I’ll be trying is doing everything in Markdown and compile it to ePub using Pandoc. Based on this article http://nshipster.com/colophon/ , Pandoc may be a bit painful to use, but I’m o

[swift-dev] The Swift Programming Language Translations

2015-12-16 Thread Vinicius Vendramini via swift-dev
I just saw a tweet from Chris Lattner talking about translating the Swift Programming Language ebook. This is a project I’d be very interested in; however, I don’t really know where to start. Is there some kind of git repository, containing the original book, that I can clone? If not, does some