The Swift Programming Language Translations


(Vinicius Vendramini) #1

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 someone have any ideas on how to start a new book, imitating the original’s style? (Maybe using iBooks Author? I have no idea.)

I thought this thread could end up being kind of a central starting point for any other translations that come up, so I’m searching for the best solutions here :slight_smile:

PS: Swift.org recommends looking at an existing Chinese translation project (The Swift Programming Language (Chinese translation, GitHub project) <https://github.com/numbbbbb/the-swift-programming-language-in-chinese>), but since I have absolutely no knowledge of Chinese it’s really hard to navigate and understand that repository.


(Rogelio Gudino) #2

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 only interested in translating if it can be done
collaboratively through GitHub, so I’ll still give it a shot.

Here’s the repo I made for Spanish (Mexico)
https://github.com/Cananito/the-swift-programming-language-spanish-mx

Thanks,
Rogelio Gudino

···

On Wed, Dec 16, 2015 at 11:31 AM, Vinicius Vendramini via swift-dev < swift-dev@swift.org> wrote:

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 someone have any ideas on how to start a new book,
imitating the original’s style? (Maybe using iBooks Author? I have no idea.)

I thought this thread could end up being kind of a central starting point
for any other translations that come up, so I’m searching for the best
solutions here :slight_smile:

PS: Swift.org <http://swift.org> recommends looking at an existing
Chinese translation project (The Swift Programming Language (Chinese
translation, GitHub project)
<https://github.com/numbbbbb/the-swift-programming-language-in-chinese>),
but since I have absolutely no knowledge of Chinese it’s really hard to
navigate and understand that repository.

_______________________________________________
swift-dev mailing list
swift-dev@swift.org
https://lists.swift.org/mailman/listinfo/swift-dev


(Vinicius Vendramini) #3

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-programming-language-portuguese-br
I’ll probably copy some of the structure you already created, for practicality as well as standardization. Hope you don’t mind :slight_smile:

Cheers!

···

On Dec 16, 2015, at 4:23 PM, Rogelio Gudino <cananito@gmail.com> wrote:

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 only interested in translating if it can be done collaboratively through GitHub, so I’ll still give it a shot.

Here’s the repo I made for Spanish (Mexico) https://github.com/Cananito/the-swift-programming-language-spanish-mx

Thanks,
Rogelio Gudino

On Wed, Dec 16, 2015 at 11:31 AM, Vinicius Vendramini via swift-dev <swift-dev@swift.org <mailto:swift-dev@swift.org>> wrote:
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 someone have any ideas on how to start a new book, imitating the original’s style? (Maybe using iBooks Author? I have no idea.)

I thought this thread could end up being kind of a central starting point for any other translations that come up, so I’m searching for the best solutions here :slight_smile:

PS: Swift.org <http://swift.org/> recommends looking at an existing Chinese translation project (The Swift Programming Language (Chinese translation, GitHub project) <https://github.com/numbbbbb/the-swift-programming-language-in-chinese>), but since I have absolutely no knowledge of Chinese it’s really hard to navigate and understand that repository.

_______________________________________________
swift-dev mailing list
swift-dev@swift.org <mailto:swift-dev@swift.org>
https://lists.swift.org/mailman/listinfo/swift-dev


(Rogelio Gudino) #4

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. Keeping the styling and formatting of the original ePub.
2. Pinpoint the exact changes of the English ePub every time it gets
updated.

Thanks,
Rogelio Gudino

···

On Wed, Dec 16, 2015 at 2:34 PM, Vinicius Vendramini <vinivendra@gmail.com> wrote:

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-programming-language-portuguese-br
I’ll probably copy some of the structure you already created, for
practicality as well as standardization. Hope you don’t mind :slight_smile:

Cheers!

On Dec 16, 2015, at 4:23 PM, Rogelio Gudino <cananito@gmail.com> wrote:

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 only interested in translating if it can be
done collaboratively through GitHub, so I’ll still give it a shot.

Here’s the repo I made for Spanish (Mexico)
https://github.com/Cananito/the-swift-programming-language-spanish-mx

Thanks,
Rogelio Gudino

On Wed, Dec 16, 2015 at 11:31 AM, Vinicius Vendramini via swift-dev < > swift-dev@swift.org> wrote:

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 someone have any ideas on how to start a new
book, imitating the original’s style? (Maybe using iBooks Author? I have no
idea.)

I thought this thread could end up being kind of a central starting point
for any other translations that come up, so I’m searching for the best
solutions here :slight_smile:

PS: Swift.org <http://swift.org/> recommends looking at an existing
Chinese translation project (The Swift Programming Language (Chinese
translation, GitHub project)
<https://github.com/numbbbbb/the-swift-programming-language-in-chinese>),
but since I have absolutely no knowledge of Chinese it’s really hard to
navigate and understand that repository.

_______________________________________________
swift-dev mailing list
swift-dev@swift.org
https://lists.swift.org/mailman/listinfo/swift-dev


(Vinicius Vendramini) #5

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 weird (I can’t translate keywords and types, for instance) but I think it makes it easier for non-english speakers to grasp the code’s goals and therefore understand how it works. Also, it helps that we finally have a language in which I can actually write translated names with decent accents, not some dumbed down version, thanks to UTF-8 support. Have you thought about this?

···

On Dec 17, 2015, at 2:30 AM, Rogelio Gudino <cananito@gmail.com> wrote:

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. Keeping the styling and formatting of the original ePub.
2. Pinpoint the exact changes of the English ePub every time it gets updated.

Thanks,
Rogelio Gudino

On Wed, Dec 16, 2015 at 2:34 PM, Vinicius Vendramini <vinivendra@gmail.com <mailto:vinivendra@gmail.com>> wrote:
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-programming-language-portuguese-br
I’ll probably copy some of the structure you already created, for practicality as well as standardization. Hope you don’t mind :slight_smile:

Cheers!

On Dec 16, 2015, at 4:23 PM, Rogelio Gudino <cananito@gmail.com <mailto:cananito@gmail.com>> wrote:

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 only interested in translating if it can be done collaboratively through GitHub, so I’ll still give it a shot.

Here’s the repo I made for Spanish (Mexico) https://github.com/Cananito/the-swift-programming-language-spanish-mx

Thanks,
Rogelio Gudino

On Wed, Dec 16, 2015 at 11:31 AM, Vinicius Vendramini via swift-dev <swift-dev@swift.org <mailto:swift-dev@swift.org>> wrote:
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 someone have any ideas on how to start a new book, imitating the original’s style? (Maybe using iBooks Author? I have no idea.)

I thought this thread could end up being kind of a central starting point for any other translations that come up, so I’m searching for the best solutions here :slight_smile:

PS: Swift.org <http://swift.org/> recommends looking at an existing Chinese translation project (The Swift Programming Language (Chinese translation, GitHub project) <https://github.com/numbbbbb/the-swift-programming-language-in-chinese>), but since I have absolutely no knowledge of Chinese it’s really hard to navigate and understand that repository.

_______________________________________________
swift-dev mailing list
swift-dev@swift.org <mailto:swift-dev@swift.org>
https://lists.swift.org/mailman/listinfo/swift-dev


(Rogelio Gudino) #6

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
translate as much code while reading the book.

The one thing I am translating for sure is the content of all string values.

Rogelio Gudino

···

On Thu, Dec 17, 2015 at 3:54 PM, Vinicius Vendramini <vinivendra@gmail.com> wrote:

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 weird (I can’t
translate keywords and types, for instance) but I think it makes it easier
for non-english speakers to grasp the code’s goals and therefore understand
how it works. Also, it helps that we finally have a language in which I can
actually write translated names with decent accents, not some dumbed down
version, thanks to UTF-8 support. Have you thought about this?

On Dec 17, 2015, at 2:30 AM, Rogelio Gudino <cananito@gmail.com> wrote:

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. Keeping the styling and formatting of the original ePub.
2. Pinpoint the exact changes of the English ePub every time it gets
updated.

Thanks,
Rogelio Gudino

On Wed, Dec 16, 2015 at 2:34 PM, Vinicius Vendramini <vinivendra@gmail.com > > wrote:

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-programming-language-portuguese-br
I’ll probably copy some of the structure you already created, for
practicality as well as standardization. Hope you don’t mind :slight_smile:

Cheers!

On Dec 16, 2015, at 4:23 PM, Rogelio Gudino <cananito@gmail.com> wrote:

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 only interested in translating if it can be
done collaboratively through GitHub, so I’ll still give it a shot.

Here’s the repo I made for Spanish (Mexico)
https://github.com/Cananito/the-swift-programming-language-spanish-mx

Thanks,
Rogelio Gudino

On Wed, Dec 16, 2015 at 11:31 AM, Vinicius Vendramini via swift-dev < >> swift-dev@swift.org> wrote:

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 someone have any ideas on how to start a new
book, imitating the original’s style? (Maybe using iBooks Author? I have no
idea.)

I thought this thread could end up being kind of a central starting
point for any other translations that come up, so I’m searching for the
best solutions here :slight_smile:

PS: Swift.org <http://swift.org/> recommends looking at an existing
Chinese translation project (The Swift Programming Language (Chinese
translation, GitHub project)
<https://github.com/numbbbbb/the-swift-programming-language-in-chinese>),
but since I have absolutely no knowledge of Chinese it’s really hard to
navigate and understand that repository.

_______________________________________________
swift-dev mailing list
swift-dev@swift.org
https://lists.swift.org/mailman/listinfo/swift-dev