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.

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

Translate content into Korean #926

Open
tunetheweb opened this issue Jun 27, 2020 · 14 comments
Open

Translate content into Korean #926

tunetheweb opened this issue Jun 27, 2020 · 14 comments
Labels
good first issue Good for newcomers translation world wide web

Comments

@tunetheweb
Copy link
Member

tunetheweb commented Jun 27, 2020

These are the core templates - without which we cannot release any translated chapters. They are in the language specific templates directory:

  • base.html -
  • base_chapter.html -
  • error.html -

2022

  • base.html -
  • contributors.html -
  • index.html -
  • table_of_contents.html -

2021

  • base.html -
  • base.html - foreword
  • contributors.html -
  • index.html -
  • table_of_contents.html -

2020

  • base.html -
  • contributors.html -
  • index.html -
  • table_of_contents.html -

2019

  • base.html -
  • contributors.html -
  • index.html -
  • table_of_contents.html -

These are the chapters to be translated, in rough order of popularity. They exist in the content directory:

2022

  • css -
  • javascript -
  • markup -
  • structured-data -
  • fonts -
  • media -
  • webassembly -
  • third-parties -
  • interoperability -
  • seo -
  • accessibility -
  • performance -
  • privacy -
  • security -
  • mobile-web -
  • capabilities -
  • pwa -
  • cms -
  • jamstack -
  • sustainability -
  • page-weight -
  • cdn -
  • http -

2021

  • css -
  • javascript -
  • markup -
  • structured-data -
  • media -
  • webassembly -
  • third-parties -
  • seo -
  • accessibility -
  • performance -
  • privacy -
  • security -
  • mobile-web -
  • capabilities -
  • pwa -
  • cms -
  • ecommerce -
  • jamstack -
  • page-weight -
  • compression -
  • caching -
  • cdn -
  • resource-hints -
  • http -

2020

  • css -
  • javascript -
  • seo -
  • markup -
  • accessibility -
  • cms -
  • performance -
  • security -
  • jamstack -
  • fonts -
  • mobile-web -
  • pwa -
  • http2 -
  • capabilities -
  • third-parties -
  • page-weight -
  • caching -
  • resource-hints -
  • privacy -
  • compression -
  • ecommerce -
  • media -

2019

  • javascript -
  • css -
  • seo -
  • performance -
  • http2 -
  • markup -
  • third-parties -
  • fonts -
  • accessibility -
  • pwa -
  • cms -
  • security -
  • media -
  • mobile-web -
  • cdn -
  • ecommerce -
  • page-weight -
  • caching -
  • compression -
  • resource-hints -

Additionally the following pages need translated too in the language specific templates directory, but less important than core templates and chapters:

  • 2021/methodology.html -
  • accessibility_statement.html -
  • base_ebook.html -
  • 2019/methodology.html -
  • 2020/methodology.html -

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:

@tunetheweb
Copy link
Member Author

You really need these to be able to run the site in a new language so suggest you start with them first:

  • base.html
  • base_chapter.html
  • index.html
  • table_of_contents.html

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.

@tunetheweb
Copy link
Member Author

You'll also need to add Korean to here:

# Currently we are only supporting languages and not regions
class Language(object):
JA = _Language('日本語', 'ja', 'JP')
EN = _Language('English', 'en', 'US')
ES = _Language('Español', 'es', 'ES')
FR = _Language('Français', 'fr', 'FR')

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):

"supported_languages": ["en","es","fr","ja"],

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:

"contributors": {
"kleinab": {
"name": "Abigail Klein",
"teams": [
"authors"
],
"avatar_url": "https:\/\/avatars2.githubusercontent.com\/u\/1319324?v=4&s=200",
"github": "kleinab"
},

@rviscomi
Copy link
Member

@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!

@goleedev
Copy link

@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의 번역을 도와 주세요!

@rviscomi
Copy link
Member

Thanks @goleedev! I've just tweeted it here: https://twitter.com/HTTPArchive/status/1293965549588877314

@tunetheweb tunetheweb added the good first issue Good for newcomers label Aug 25, 2020
@taechonkim
Copy link

Hi, is this issue valid now? if so, I want to contribute it! how can I contribute?

@tunetheweb
Copy link
Member Author

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.

@taechonkim
Copy link

taechonkim commented Sep 30, 2020

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?

@tunetheweb
Copy link
Member Author

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!

@taechonkim
Copy link

taechonkim commented Sep 30, 2020

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?

@tunetheweb
Copy link
Member Author

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.

@taechonkim
Copy link

taechonkim commented Sep 30, 2020

@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!

@rviscomi rviscomi modified the milestones: 2019 Backlog, 2020 Backlog Nov 11, 2020
@tunetheweb tunetheweb changed the title Translate 2019 content into Korean Translate content into Korean Nov 21, 2020
@hanj0415
Copy link

hanj0415 commented Feb 23, 2021

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?

@tunetheweb
Copy link
Member Author

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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers translation world wide web
Projects
None yet
Development

No branches or pull requests

6 participants