Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Configuration Guide Translation - Chinese Simplified #447

Open
McSloverd opened this issue Apr 18, 2022 · 13 comments
Open

Configuration Guide Translation - Chinese Simplified #447

McSloverd opened this issue Apr 18, 2022 · 13 comments

Comments

@McSloverd
Copy link

Hi, I would like to translate the Configuration Guide located at [Here] into Simplified Chinese. Is there anything I should know about?
@Valiance
Copy link

Valiance commented Apr 18, 2022 via email

@McSloverd
Copy link
Author

Not really. Marlin is a big piece of software that interfaces to
hardware. Murphy's law applies here: 'Whatever can go wrong, will go
wrong. At the worst possible moment."

On Mon, Apr 18, 2022 at 2:43 AM Simeng Fu @.***> wrote:

Hi, I would like to translate the Configuration Guide located at [Here
https://marlinfw.org/docs/configuration/configuration.html] into
Simplified Chinese. Is there anything I should know about?

—
Reply to this email directly, view it on GitHub
#447, or
unsubscribe
https://github.com/notifications/unsubscribe-auth/AMAKJHE3MQ547NX7SAZDQRTVFT77XANCNFSM5TVDO4PA
.
You are receiving this because you are subscribed to this thread.Message
ID: @.***>

Haha! Thanks for the reply. It exactly illustrates my daily situation.

What I actually meant was "DonI have the permission to translate? Or should I include any specific lines to show the original copyright or license?"

I just want to make it Chinese so that maybe it is easier for people who have language barrier.

I have already finished the first part - Configuration.h but not yet put out to public. I can also give it to Marlin Official if they want it. The first part is around 50k Chinese Characters.

@Valiance
Copy link

Valiance commented Apr 19, 2022 via email

@McSloverd
Copy link
Author

I believe what you are doing is a great thing! I would imagine you will need to get in touch with the staff that run Marlin directly.
…
On Mon, Apr 18, 2022 at 9:55 PM Simeng Fu @.> wrote: Not really. Marlin is a big piece of software that interfaces to hardware. Murphy's law applies here: 'Whatever can go wrong, will go wrong. At the worst possible moment." On Mon, Apr 18, 2022 at 2:43 AM Simeng Fu @.> wrote: Hi, I would like to translate the Configuration Guide located at [Here https://marlinfw.org/docs/configuration/configuration.html] into Simplified Chinese. Is there anything I should know about? — Reply to this email directly, view it on GitHub #447 <#447>, or unsubscribe https://github.com/notifications/unsubscribe-auth/AMAKJHE3MQ547NX7SAZDQRTVFT77XANCNFSM5TVDO4PA . You are receiving this because you are subscribed to this thread.Message ID: @.> Haha! Thanks for the reply. It exactly illustrates my daily situation. What I actually meant was "DonI have the permission to translate? Or should I include any specific lines to show the original copyright or license?" I just want to make it Chinese so that maybe it is easier for people who have language barrier. I have already finished the first part - Configuration.h but not yet put out to public. I can also give it to Marlin Official if they want it. The first part is around 50k Chinese Characters. — Reply to this email directly, view it on GitHub <#447 (comment)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/AMAKJHDANSZGLIS55NXA35DVFYHBJANCNFSM5TVDO4PA . You are receiving this because you commented.Message ID: @.>

Thanks for the reply! I believe so too and I have tried to find any contact method to reach the staff and I couldn't even find an email address. I thought if I open an issue here maybe someone from the staff could see it.

I have started the translation of Configuration_adv.h today.

@Valiance
Copy link

Valiance commented Apr 20, 2022 via email

@McSloverd
Copy link
Author

McSloverd commented Apr 21, 2022 •
edited by thinkyhead
Loading

Thanks for pointing me to the direction. I have joined the discord, however there are quite a lot of channels and I couldn't tell which one is a good one for me to ask such question. Do you have any suggestion? Thanks!

@ellensp
Copy link
Contributor

ellensp commented Apr 21, 2022

All posts in Marlin github are already re posted in discord channels.

I have some concerns,

  1. who will maintain it once your board of it? (this is inevitable)
  2. there is nothing in place to support language choices (though a independent page is an option)
  3. I'm told google translate does a fairly good job (I use it for French and German pages quite often) this will always be up to date with main page. (vs someone having to update each version of the guide every time the English guide is updated)

@thinkyhead Can we get your views on this?

@McSloverd
Copy link
Author

All posts in Marlin github are already re posted in discord channels.

I have some concerns,

  1. who will maintain it once your board of it? (this is inevitable)

  2. there is nothing in place to support language choices (though a independent page is an option)

  3. I'm told google translate does a fairly good job (I use it for French and German pages quite often) this will always be up to date with main page. (vs someone having to update each version of the guide every time the English guide is updated)

@thinkyhead Can we get your views on this?

Thanks for the reply!

  1. I can maintain it as long as I am asked to. Or my company which is basically working with marlin everyday. I can assign this task to a small group of staff.

  2. I was originally planning to "publish" it on Zhihu.com - a Chinese alternative of Reddit / quora. Quite a place for professionals. But if we are discussing long-term professional maintaining, I can get a domain, like "marlinfw.cn" and put it there. And yes, marlin officials can have the ownership. I will pay for everything, as a tiny contribution to the fantastic community.

  3. Google (and essentially other big offshore online service) is almost all banded by the "Great Wall", I can put it on Google, but a lot of Chinese will never see it. This basically defeats the original purpose of what I am trying to do. If I put it domestically (in China), not just Chinese can get access to it but also everyone in the world could as well. Of course, to make this happen, not only the domain name and the storage of the content has to be located in China, but also permission and licenses has to be granted. I can arrange these license and just like I have mentioned, the cost is on me.

@Valiance
Copy link

Valiance commented Apr 21, 2022 via email

@McSloverd
Copy link
Author

I would show you guys how it look like but I have not yet publish it. This is a screen shot of it.

I tried to keep the exact structure of the original document.

image

@McSloverd
Copy link
Author

McSloverd commented Apr 22, 2022 •
edited by thinkyhead
Loading

Thanks! I will give a look at the channel. Honestly, I have never used discord before. Guess I am getting old😹

@thinkyhead
Copy link
Member

thinkyhead commented Apr 22, 2022 •
edited
Loading

Can we get your views on this?

My hope is to produce a nice script in Python or Perl that will convert the files Configuration.h and Configuration_adv.h (and maybe elements of SanityCheck.h) into Jekyll, with a separate page for each top-level option, and sub-options documented under those options.

So the first step in a Chinese translation would be to translate all the documentation in those files and post a Chinese set of configuration files. Those could be maintained as a bonus within the MarlinFirmware/Configurations repository.

Then, whenever I manage to write that Config-to-Jekyll script (and from that time onward) I can generate both English and Chinese pages at the same time.

@McSloverd
Copy link
Author

Can we get your views on this?

My hope is to produce a nice script in Python or Perl that will convert the files Configuration.h and Configuration_adv.h (and maybe elements of SanityCheck.h) into Jekyll, with a separate page for each top-level option, and sub-options documented under those options.

So the first step in a Chinese translation would be to translate all the documentation in those files and post a Chinese set of configuration files. Those could be maintained as a bonus within the MarlinFirmware/Configurations repository.

Then, whenever I manage to write that Config-to-Jekyll script (and from that time onward) I can generate both English and Chinese pages at the same time.

Thanks for your reply!

That would be awesome! I presume that this would be taking some time, right? I propose that I can start the translation of that web page and put it up online. And when you start this python project I can always participate to contribute the translation work, if you need of course. And since China is quite a market for 3D printing, I propose that I can translate the whole marlinfw.org into Chinese and put it to marlinfw.cn, for example. Of course all these work and cost is for free as my contribution to the community, and the ownership of all related work goes to marlinfw.org. I have benefited from marlin and I just want to give something back, to both Marlin and Chinese 3D Printing.

Thanks!

@thinkyhead thinkyhead changed the title I'd like to translate the Configutation Guide located on Marlinfw.org Configuration Guide Translation - Chinese Simplified Jun 4, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
4 participants
@ellensp @thinkyhead @Valiance @McSloverd