About the official site (ahkscript.org)

[amnesiac]

Excuse me. Can we host it in the github.com?

I think it is convenient to maintain it for the admins. Besides, it's helpful to translate it into other languages for me and lovers from non-English countries. So it would be similar to the ruby's official site (the project is here).

• At the moment, the ahk help is hosted at github, but it doesn't use it as websever. I can fork it and translate into Chinese but can't push back and see it at the English help's page.
• The ahkscript.github.io project has been existed but doesn't host the ahkscript.org's contents.

[guest3456]

We would still need someplace to host the forums.. how would that work?

[tank]

To be honest I didn't know it was possible. I'm a bit of a github noob maybe I should get into it more

[amnesiac]

We would still need someplace to host the forums.. how would that work?

Although I saw such website with a separated forum, I don't know how to implement it.

To be honest I didn't know it was possible. I'm a bit of a github noob maybe I should get into it more

I'm pleased that you will think over it. It's easy if you are familiar with GIT.

[lexikos]

How would the integration of other languages (such as Chinese) work?

FYI,
http://lexikos.github.io/v1/docs/AutoHotkey.htm (not up to date at the moment)
http://lexikos.github.io/v2/docs/AutoHotkey.htm (probably the latest documentation, but incomplete)

[nnnik]

At the site we refer to the Docs twice, once at the start page another time at the Commands link.
If clicking these links would detect the browser language and return the link to the helpfile for that language, that'd be great.
The Helpfiles could still be hosted at ahkscript.org.

[amnesiac]

How would the integration of other languages (such as Chinese) work?

FYI,
http://lexikos.github.io/v1/docs/AutoHotkey.htm (not up to date at the moment)
http://lexikos.github.io/v2/docs/AutoHotkey.htm (probably the latest documentation, but incomplete)

Adjust the directory structure:

• Place non-translated files to other dirs, e.g. images.
• Use one dir hold other files and create other dirs named language code, i.e. en/docs, en/Table of Contents.hhc and so on. So when I have translated them into Chinese, I can push back to zh-cn/.

Maybe I needn't push back to your project and use the method by which v1 and v2 link to other project. What is it?

[tank]

Technically there is a http item that may most of the time detect the local Accept-Language: en-US,en;q=0.8

I could use this to dynamically point to the proper language link.

thoughts?

[tank]

http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Its not terribly difficult to set up the logic and code I would just need the mappings to the correct pages based on the language and default any non matches to english

[fincs]

Please don't. I extremely hate it when a web page tries to be "smart" and show its content in my native language. I'd rather read it in English, thank you very much. It's even worse if there's no way to change it or if this setting doesn't persist. Even though my browser's default language is set to English (and so my OS/all other software), my v4 IP is still a Spanish IP and many sites love using geolocation. Google, I'm looking at you

Oh, not to mention that non-English documentation may take a longer time to be updated.

[tank]

not based on IP
its based entirely on your browser settings

[tank]

any way I am just bringing up the information that is available

[amnesiac]

Please don't. I extremely hate it when a web page tries to be "smart" and show its content in my native language. I'd rather read it in English, thank you very much. It's even worse if there's no way to change it or if this setting doesn't persist. Even though my browser's default language is set to English (and so my OS/all other software), my v4 IP is still a Spanish IP and many sites love using geolocation. Google, I'm looking at you :roll:

Well, I'm just for promoting the internationalization of the official site. As tank said, you would see the English page if your browser UI is in English. Moreover, you could visit the special language's page with the special link, e.g. https://www.ruby-lang.org/en/ for English. Of cource you could also switch to it in the main page.

Oh, not to mention that non-English documentation may take a longer time to be updated.

The German help is updated immediately, and the Chinese is also updated quickly (I notice that many Chinese would use old Chinese help instead of the latest help in English). I hope there will be many documentations for more languages.

PS: If there were promotion ambassadors for AutoHotkey, I hope I would be one. haha

[amnesiac]

http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Its not terribly difficult to set up the logic and code I would just need the mappings to the correct pages based on the language and default any non matches to english

I wish I could know the update for the site in time and get it's new contents conveniently, so recommend the github. Besides I also think over the collaboration about translating these. This will be long-term, so it can last as long as someone would be willing to do it.

[joedf]

AutoHotkey Ambassadors you say?
Cool!

[lexikos]

I wish I could know the update for the site in time and get it's new contents conveniently, so recommend the github.

If you watch AutoHotkey_L-Docs you will see any updates the moment they are available, possibly even before I upload them to ahkscript.org.

Can ahkscript.org/en/docs/ and ahkscript.org/cn/docs/ (or whatever) simply point to different GitHub hosted pages? If so, our 'ambassadors' can update their documentation directly. (Actually, I'm not opposed to moving the documentation to the ahkscript.org organization on GitHub and allowing others to maintain it.)

[tank]

Can ahkscript.org/en/docs/ and ahkscript.org/cn/docs/ (or whatever) simply point to different GitHub hosted pages? If so, our 'ambassadors' can update their documentation directly. (Actually, I'm not opposed to moving the documentation to the ahkscript.org organization on GitHub and allowing others to maintain it.)

I like it
Any other thoughts maybe some mini flags to set lang pref in a cookie and use the header for default in absense of cookie choice?

[amnesiac]

I wish I could know the update for the site in time and get it's new contents conveniently, so recommend the github.

If you watch AutoHotkey_L-Docs you will see any updates the moment they are available, possibly even before I upload them to ahkscript.org.

I know that and did it. Here what I mean is mainly for the whole site.

Can ahkscript.org/en/docs/ and ahkscript.org/cn/docs/ (or whatever) simply point to different GitHub hosted pages? If so, our 'ambassadors' can update their documentation directly. (Actually, I'm not opposed to moving the documentation to the ahkscript.org organization on GitHub and allowing others to maintain it.)

I don't know whether it works if we use the domain name followed some subpaths. Maybe we can use another method with the subdomain name, i.e. en.ahkscript.org, cn.ahkscript.org... So they can point to different projects and works the same as you expected.

[tank]

Yea I understood you meant homepage and download pages etc as well.
Much as lexikos works on ahk functionality that interest him. This topic interests me.

I very much want to find a solution that doesn't offend folks like fincs but offers community input and language support. AND from a code perspective its not difficult. Give me saturday to consider all of this feedback, and work out the detail.

Currently and it may not be known but the forum faq is hosted at github. The forum does a live grab of that content when the page is requested.

Point is we can do this quite seamlesly.

[amnesiac]

tank, we could use the following method maybe.

• www.ahkscript.org (ahkscript.org points here), jump to proper language's page based on the brower's language of a visitor automatically.
• en.ahkscript.org: the English pages, hosted at the github and use own domain name. Other ambassadors can translate from this project. The main page contains all links to all language's main page (including English page's link).
• cn.ahkscript.org: the translated Chinese pages, point to the github project selected by Chinese translators.
• ...
• forum.ahkscript.org: this forum, hosted at current room.

For the documents, let en.ahkscript.org/docs refer to AutoHotkey_L-Docs by git submodule.

Is it seamless?