Open tunetheweb opened 4 years ago
You really need these to be able to run the site in a new language so suggest you start with them first:
They are also a lot easier to translate than the chapters themselves as a lot shorter!
then up to you whether you finish out all the templates or tackle a chapter.
You'll also need to add Korean to here:
and the language code (ko?) to here (but let's not commit this second one until we have at least the main templates and a chapter or two done because committing it here means it would be put live on next release):
And while when you submit your first PR, add yourself to the contributors section of the config under your GitHub id, which means you'll show up in the 2019 Contributors page:
@techhtml I'd like to post something from the HTTP Archive Twitter account to promote this translation effort and hopefully find more translators to help with it. Could you translate this text for the tweet?
Do you speak Korean? Help us translate the Web Almanac as part of our effort to make it globally accessible to the web community!
Thanks for your help!
@rviscomi If you still need some help, here is the translation! ๐
EN: Do you speak Korean? Help us translate the Web Almanac as part of our effort to make it globally accessible to the web community! KO: ํ๊ตญ์ด๋ฅผ ํ ์ค ์์๋์? ๊ทธ๋ ๋ค๋ฉด ์น ์ปค๋ฎค๋ํฐ๋ฅผ ์ ์ธ๊ณ์์ ์ก์ธ์คํ ์ ์๋๋ก Web Almanac์ ๋ฒ์ญ์ ๋์ ์ฃผ์ธ์!
Thanks @goleedev! I've just tweeted it here: https://twitter.com/HTTPArchive/status/1293965549588877314
Hi, is this issue valid now? if so, I want to contribute it! how can I contribute?
Hey @taechonkim would love to have your help. Unfortunately we've not made much progress on this so far.
I've just sent you an invite to the team. After you accept that, you should be able to edit the first comment and put your name besides some of the files to translate to let others know you're working on that one.
Please do them in the order listed (so start base.html and finish with methodology.html). Then just fork the repo, copy the English file to a ko
folder and translate it! Then submit a PR with that.
We've a Translator's Guide and also a Git Guide that are worth a read before you start!
Let me know if you have any questions.
Hey @tunetheweb I have a question. I have forked the original repository, cloned forked repository to local, and made branch for my translation job. I think my next job is copying src/templates/en to src/templates/ko, starting translation with base.html. is it right?
Correct. Only copy across the templates as you translate them so you don't commit any English version ones into src/templates/ko. You can decide how many translated files to include in each pull request. base.html is quite big so maybe do one PR for that, for example. Another example the 2019 and 2020 contributor pages are obviously very similar so can submit both in the same PR. Can also do all the templates at once if you want, but smaller PRs are easier to review and merge so recommend that!
Hey @tunetheweb Thank you for quick reply. I translating base.html now, there are details about contributors bottom part of base.html (about 114 line, starting with details of kleinnab...) I wonder where these details comes with in Web Almanac. And is there need to translate them?
I think you mean line 179 not 114? Try to keep the line numbering consistent with English as makes it easier to manage.
These are author bios and they are given at the bottom of the chapters they wrote (here's mine for example as I wrote the HTTP/2 chapter!) so yes they do need translated too.
@tunetheweb thank you for reply :) I think my prettier configuration messed up line number... I should think about the way to correct them. Anyway, I'll translate the thing I mentioned previous comment!
Hello, @tunetheweb I've created a branch from the forked repository. I'm trying to start to translate base.html, but is it marked as completed from the job lists? If once the translation job for base.html is completed, what should I do next?
No they were completed so shouldn't be ticked. They were started upon but don't think we made much progress on them and didn't see a PR or branch with any of them done. Have unticked them now so work away!
These are the core templates - without which we cannot release any translated chapters. They are in the language specific templates directory:
2022
2021
2020
2019
These are the chapters to be translated, in rough order of popularity. They exist in the content directory:
2022
2021
2020
2019
Additionally the following pages need translated too in the language specific templates directory, but less important than core templates and chapters:
There is no need to translate the chapters HTML pages are they are generated off the markdown combined with the above templates.
Please include "Makes progress on #926" in all pull requests so a link is created from the PR to this issue.
Common notes for writing consistency are here: https://github.com/HTTPArchive/almanac.httparchive.org/wiki/Translators'-Guide. Feel free to edit that and/or add Korean-specific extras by editing this comment.
Korean specific extra advice: