Translation of Swift.org in Chinese


(John Lin) #1

Hi

I’m working on a traditional Chinese translation of Swift.org <http://swift.org/>
https://swiftlang.tw <https://swiftlang.tw/>

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org <http://swift.org/> ?

Thanks

John Lin


(Ted Kremenek) #2

Hi John,

I think we would be open to having the community help host translations on Swift.org. My primary concern is maintenance. The material on the site will continue to evolve. What did you have in mind in terms of keeping the translation up-to-date?

Note if the translation was on Swift.org, from a legal perspective we'd consider it to be an open source contribution. The website material is hosted on GitHub. We were planning on opening it up once a few more logistical rollout issues were settled.

Cheers,
Ted

···

On Jan 11, 2016, at 9:45 PM, John Lin via swift-dev <swift-dev@swift.org> wrote:

Hi

I’m working on a traditional Chinese translation of Swift.org
https://swiftlang.tw

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org ?

Thanks

John Lin

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


(John Lin) #3

Hi Ted,

Swift.org has updated several times since I started the translation. The part that changes most frequently is the download page. I’ve made a script to auto update these download links. For other text updates, whenever I translate a page, I alway keep the origin English copy so that I can track the changes in the future.

I think keeping the translation up-to-date will be easier if the site's source is open. Currently I use page2rss & IFTTT to get notifications about changes, but if the source is open, we can track these changes on GitHub.

I’m more than happy to contribute these translations back to Swift.org <http://swift.org/>, but maybe the site structure will need some changes to accommodate translations in various languages.

Best,
John

···

On Jan 16, 2016, at 3:56 PM, Ted kremenek <kremenek@apple.com> wrote:

Hi John,

I think we would be open to having the community help host translations on Swift.org <http://swift.org/>. My primary concern is maintenance. The material on the site will continue to evolve. What did you have in mind in terms of keeping the translation up-to-date?

Note if the translation was on Swift.org <http://swift.org/>, from a legal perspective we'd consider it to be an open source contribution. The website material is hosted on GitHub. We were planning on opening it up once a few more logistical rollout issues were settled.

Cheers,
Ted

On Jan 11, 2016, at 9:45 PM, John Lin via swift-dev <swift-dev@swift.org <mailto:swift-dev@swift.org>> wrote:

Hi

I’m working on a traditional Chinese translation of Swift.org <http://swift.org/>
https://swiftlang.tw <https://swiftlang.tw/>

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org <http://swift.org/> ?

Thanks

John Lin

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


(Ted Kremenek) #4

Hi John,

I'm re-confirming any legal questions, but the idea all along was to make the website material both publicly available but also open for the community to help curate. The material for the website is currently hosted on GitHub in a private repository, which we can easily open up.

The material for the website itself is written in Markdown, and we use Jekyll to generate static HTML content. There is a variety of ways we can handle hosting multiple translations. One model that was proposed to me is that we can have git branches with different translations, although I'm not certain if that would be a useful model. We obviously could have parallel folders as well to host different translations.

There's also the question of how we allow users to select a language on the website. Perhaps we would want to the most-likely language choice based on browser preferences, but I'm not sure. Maybe it's simple to just default to English, make it obvious on the landing page that alternate translations are available, and then allow them to select that to get a different URL that indicates the rest of the content is a different translation.

Thoughts?

Ted

···

On Jan 16, 2016, at 11:33 PM, John Lin <johnlinvc@gmail.com> wrote:

Hi Ted,

Swift.org has updated several times since I started the translation. The part that changes most frequently is the download page. I’ve made a script to auto update these download links. For other text updates, whenever I translate a page, I alway keep the origin English copy so that I can track the changes in the future.

I think keeping the translation up-to-date will be easier if the site's source is open. Currently I use page2rss & IFTTT to get notifications about changes, but if the source is open, we can track these changes on GitHub.

I’m more than happy to contribute these translations back to Swift.org, but maybe the site structure will need some changes to accommodate translations in various languages.

Best,
John

On Jan 16, 2016, at 3:56 PM, Ted kremenek <kremenek@apple.com> wrote:

Hi John,

I think we would be open to having the community help host translations on Swift.org. My primary concern is maintenance. The material on the site will continue to evolve. What did you have in mind in terms of keeping the translation up-to-date?

Note if the translation was on Swift.org, from a legal perspective we'd consider it to be an open source contribution. The website material is hosted on GitHub. We were planning on opening it up once a few more logistical rollout issues were settled.

Cheers,
Ted

On Jan 11, 2016, at 9:45 PM, John Lin via swift-dev <swift-dev@swift.org> wrote:

Hi

I’m working on a traditional Chinese translation of Swift.org
https://swiftlang.tw

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org ?

Thanks

John Lin

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


(John Lin) #5

Hi Ted,

I think one of the advantages of using folders is that if a new page haven’t been translated yet, we can show English version as fallback . If we use git branches, It’ll be hard to do that in Jekyll.

Default English sounds reasonable. Even if we choose language by browser preference, we still need to provide links to translations for safe.

Best,
John

···

On Jan 18, 2016, at 2:06 PM, Ted kremenek <kremenek@apple.com> wrote:

Hi John,

I'm re-confirming any legal questions, but the idea all along was to make the website material both publicly available but also open for the community to help curate. The material for the website is currently hosted on GitHub in a private repository, which we can easily open up.

The material for the website itself is written in Markdown, and we use Jekyll to generate static HTML content. There is a variety of ways we can handle hosting multiple translations. One model that was proposed to me is that we can have git branches with different translations, although I'm not certain if that would be a useful model. We obviously could have parallel folders as well to host different translations.

There's also the question of how we allow users to select a language on the website. Perhaps we would want to the most-likely language choice based on browser preferences, but I'm not sure. Maybe it's simple to just default to English, make it obvious on the landing page that alternate translations are available, and then allow them to select that to get a different URL that indicates the rest of the content is a different translation.

Thoughts?

Ted

On Jan 16, 2016, at 11:33 PM, John Lin <johnlinvc@gmail.com <mailto:johnlinvc@gmail.com>> wrote:

Hi Ted,

Swift.org <http://swift.org/> has updated several times since I started the translation. The part that changes most frequently is the download page. I’ve made a script to auto update these download links. For other text updates, whenever I translate a page, I alway keep the origin English copy so that I can track the changes in the future.

I think keeping the translation up-to-date will be easier if the site's source is open. Currently I use page2rss & IFTTT to get notifications about changes, but if the source is open, we can track these changes on GitHub.

I’m more than happy to contribute these translations back to Swift.org <http://swift.org/>, but maybe the site structure will need some changes to accommodate translations in various languages.

Best,
John

On Jan 16, 2016, at 3:56 PM, Ted kremenek <kremenek@apple.com <mailto:kremenek@apple.com>> wrote:

Hi John,

I think we would be open to having the community help host translations on Swift.org <http://swift.org/>. My primary concern is maintenance. The material on the site will continue to evolve. What did you have in mind in terms of keeping the translation up-to-date?

Note if the translation was on Swift.org <http://swift.org/>, from a legal perspective we'd consider it to be an open source contribution. The website material is hosted on GitHub. We were planning on opening it up once a few more logistical rollout issues were settled.

Cheers,
Ted

On Jan 11, 2016, at 9:45 PM, John Lin via swift-dev <swift-dev@swift.org <mailto:swift-dev@swift.org>> wrote:

Hi

I’m working on a traditional Chinese translation of Swift.org <http://swift.org/>
https://swiftlang.tw <https://swiftlang.tw/>

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org <http://swift.org/> ?

Thanks

John Lin

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


(Ted Kremenek) #6

Hi Ted,

I think one of the advantages of using folders is that if a new page haven’t been translated yet, we can show English version as fallback . If we use git branches, It’ll be hard to do that in Jekyll.

Indeed. I was thinking multiple folders myself.

I'm not understand the "show English version as fallback" part. If we used separate folders, I suspect we would just have subfolders for each translation, and a different URL for each translation. How would you expect the fallback to work? Have the web server redirects based on the URL to the English version, presuming it exists?

Default English sounds reasonable. Even if we choose language by browser preference, we still need to provide links to translations for safe.

Best,
John

Makes sense.

···

On Jan 18, 2016, at 7:42 PM, John Lin <johnlinvc@gmail.com> wrote:

On Jan 18, 2016, at 2:06 PM, Ted kremenek <kremenek@apple.com> wrote:

Hi John,

I'm re-confirming any legal questions, but the idea all along was to make the website material both publicly available but also open for the community to help curate. The material for the website is currently hosted on GitHub in a private repository, which we can easily open up.

The material for the website itself is written in Markdown, and we use Jekyll to generate static HTML content. There is a variety of ways we can handle hosting multiple translations. One model that was proposed to me is that we can have git branches with different translations, although I'm not certain if that would be a useful model. We obviously could have parallel folders as well to host different translations.

There's also the question of how we allow users to select a language on the website. Perhaps we would want to the most-likely language choice based on browser preferences, but I'm not sure. Maybe it's simple to just default to English, make it obvious on the landing page that alternate translations are available, and then allow them to select that to get a different URL that indicates the rest of the content is a different translation.

Thoughts?

Ted

On Jan 16, 2016, at 11:33 PM, John Lin <johnlinvc@gmail.com> wrote:

Hi Ted,

Swift.org has updated several times since I started the translation. The part that changes most frequently is the download page. I’ve made a script to auto update these download links. For other text updates, whenever I translate a page, I alway keep the origin English copy so that I can track the changes in the future.

I think keeping the translation up-to-date will be easier if the site's source is open. Currently I use page2rss & IFTTT to get notifications about changes, but if the source is open, we can track these changes on GitHub.

I’m more than happy to contribute these translations back to Swift.org, but maybe the site structure will need some changes to accommodate translations in various languages.

Best,
John

On Jan 16, 2016, at 3:56 PM, Ted kremenek <kremenek@apple.com> wrote:

Hi John,

I think we would be open to having the community help host translations on Swift.org. My primary concern is maintenance. The material on the site will continue to evolve. What did you have in mind in terms of keeping the translation up-to-date?

Note if the translation was on Swift.org, from a legal perspective we'd consider it to be an open source contribution. The website material is hosted on GitHub. We were planning on opening it up once a few more logistical rollout issues were settled.

Cheers,
Ted

On Jan 11, 2016, at 9:45 PM, John Lin via swift-dev <swift-dev@swift.org> wrote:

Hi

I’m working on a traditional Chinese translation of Swift.org
https://swiftlang.tw

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org ?

Thanks

John Lin

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


(John Lin) #7

Hi Ted,

It’s possible to scan the site map and copy the English version to corresponding location. There’s a Jekyll plugin can do that https://github.com/untra/polyglot. But I think we can just simple copy the new English page/post markdown source to each language’s folder in the beginning.

John

···

On Jan 20, 2016, at 2:07 PM, Ted kremenek <kremenek@apple.com> wrote:

On Jan 18, 2016, at 7:42 PM, John Lin <johnlinvc@gmail.com <mailto:johnlinvc@gmail.com>> wrote:

Hi Ted,

I think one of the advantages of using folders is that if a new page haven’t been translated yet, we can show English version as fallback . If we use git branches, It’ll be hard to do that in Jekyll.

Indeed. I was thinking multiple folders myself.

I'm not understand the "show English version as fallback" part. If we used separate folders, I suspect we would just have subfolders for each translation, and a different URL for each translation. How would you expect the fallback to work? Have the web server redirects based on the URL to the English version, presuming it exists?

Default English sounds reasonable. Even if we choose language by browser preference, we still need to provide links to translations for safe.

Best,
John

Makes sense.

On Jan 18, 2016, at 2:06 PM, Ted kremenek <kremenek@apple.com <mailto:kremenek@apple.com>> wrote:

Hi John,

I'm re-confirming any legal questions, but the idea all along was to make the website material both publicly available but also open for the community to help curate. The material for the website is currently hosted on GitHub in a private repository, which we can easily open up.

The material for the website itself is written in Markdown, and we use Jekyll to generate static HTML content. There is a variety of ways we can handle hosting multiple translations. One model that was proposed to me is that we can have git branches with different translations, although I'm not certain if that would be a useful model. We obviously could have parallel folders as well to host different translations.

There's also the question of how we allow users to select a language on the website. Perhaps we would want to the most-likely language choice based on browser preferences, but I'm not sure. Maybe it's simple to just default to English, make it obvious on the landing page that alternate translations are available, and then allow them to select that to get a different URL that indicates the rest of the content is a different translation.

Thoughts?

Ted

On Jan 16, 2016, at 11:33 PM, John Lin <johnlinvc@gmail.com <mailto:johnlinvc@gmail.com>> wrote:

Hi Ted,

Swift.org <http://swift.org/> has updated several times since I started the translation. The part that changes most frequently is the download page. I’ve made a script to auto update these download links. For other text updates, whenever I translate a page, I alway keep the origin English copy so that I can track the changes in the future.

I think keeping the translation up-to-date will be easier if the site's source is open. Currently I use page2rss & IFTTT to get notifications about changes, but if the source is open, we can track these changes on GitHub.

I’m more than happy to contribute these translations back to Swift.org <http://swift.org/>, but maybe the site structure will need some changes to accommodate translations in various languages.

Best,
John

On Jan 16, 2016, at 3:56 PM, Ted kremenek <kremenek@apple.com <mailto:kremenek@apple.com>> wrote:

Hi John,

I think we would be open to having the community help host translations on Swift.org <http://swift.org/>. My primary concern is maintenance. The material on the site will continue to evolve. What did you have in mind in terms of keeping the translation up-to-date?

Note if the translation was on Swift.org <http://swift.org/>, from a legal perspective we'd consider it to be an open source contribution. The website material is hosted on GitHub. We were planning on opening it up once a few more logistical rollout issues were settled.

Cheers,
Ted

On Jan 11, 2016, at 9:45 PM, John Lin via swift-dev <swift-dev@swift.org <mailto:swift-dev@swift.org>> wrote:

Hi

I’m working on a traditional Chinese translation of Swift.org <http://swift.org/>
https://swiftlang.tw <https://swiftlang.tw/>

First, will there be any legal issue?
Second, is it possible to add the translation to the official Swift.org <http://swift.org/> ?

Thanks

John Lin

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