Translate content to Japanese

[tunetheweb]

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

• base.html - @ksakae1216
• base_chapter.html- @ksakae1216
• error.html- @ksakae1216

2025

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

2024

• base.html -
• base.html - foreword
• contributors.html -
• index.html -
• table_of_contents.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 - @ksakae1216
• base.html - foreword added later @ksakae1216
• contributors.html - @ksakae1216
• index.html - @ksakae1216
• table_of_contents.html - @ksakae1216

2019

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

These are the chapters to be translated. They exist in the content directory:

2025

• fonts -
• webassembly -
• third-parties -
• generative-ai -
• seo -
• accessibility -
• performance -
• privacy -
• security -
• capabilties -
• pwa -
• cms -
• ecommerce -
• page-weight -
• cdn -
• cookies -

2024

• javascript - @ksakae1216
• markup - @ksakae1216
• structured-data - @ksakae1216
• fonts - @ksakae1216
• media - @ksakae1216
• third-parties - @ksakae1216
• seo - @ksakae1216
• accessibility - @ksakae1216
• performance - @ksakae1216
• privacy - @ksakae1216
• security - @ksakae1216
• cms - @ksakae1216
• ecommerce - @ksakae1216
• jamstack - @ksakae1216
• sustainability - @ksakae1216
• page-weight - @ksakae1216
• cdn - @ksakae1216
• http - @ksakae1216
• cookies - @ksakae1216

2022

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

2021

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

2020

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

2019

• accessibility - @MSakamaki
• caching - @ksakae1216
• cdn - @ksakae1216
• cms - @ksakae1216 (requires review)
• compression - @ksakae1216 (requires review)
• css - @ksakae1216 (requires review)
• ecommerce - @ksakae1216 (requires review)
• fonts - @ksakae1216 (requires review)
• http2 - @ksakae1216 - Translation of Http2 chapter to Japanese #661
• javascript - @ksakae1216 (requires review)
• markup - @MSakamaki
• media - @ksakae1216 (requires review)
• mobile-web - @ksakae1216 (requires review)
• page-weight- @ksakae1216 (requires review)
• performance - @MSakamaki
• pwa - @ksakae1216 (requires review)
• resource-hints - @ksakae1216 (requires review)
• security - @ksakae1216 (requires review)
• seo - @MSakamaki
• third-parties - @ksakae1216 (requires review)

Additionally the following pages need translated too in the language specific templates directory:

• 2022/methodology.html - @ksakae1216
• 2021/methodology.html - @ksakae1216
• accessibility_statement.html - @ksakae1216
• accessibility_statement.html additional update - @ksakae1216
• 2019/methodology.html - @ksakae1216
• 2020/methodology.html - @ksakae1216
• base_ebook.html - @ksakae1216

There is no need to translate the chapters HTML pages are they are generated off the markdown combined with the above templates.

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 Japanese-specific extras by editing this comment.

Japanese specific extra advice:

• Nayori of foreign words
  https://www.jtca.org/standardization/katakana_guide_3_20171222.pdf
  https://www.bunka.go.jp/kokugo_nihongo/sisaku/joho/joho/kijun/naikaku/gairai/index.html
• English, katakana, hiragana, and kanji should be carefully selected throughout the content.
• Use these textlint settings: https://gist.github.com/MSakamaki/a3b7cbf57231b6287a19be28534cb50d

[tunetheweb]

@ksakae1216 has expressed an interest in helping out.

@ksakae1216, for a start it would be great if you could review @MSakamaki 's work so far in https://github.com/HTTPArchive/almanac.httparchive.org/tree/master/src/content/ja/2019 and see if you spot any issues with the translations?

After that I've sent you an invite to the team and when you accept that, you should be able edit the first comment in this issue and put your name beside a chapter,

To do the translations, clone the repo, grab the markdown from the /src/templates/en/ folder and copy it to the /src/templates/ja/ folder and edit it, then submit a pull request with the translation and @MSakamaki can review for language and I (or someone else) will also review it from a non-language perspective and then we'll merge it into master.

Let me know if there are any questions!

[ksakae1216]

@tunetheweb , Thank you.

I have a question.
What should I review first?
I looked at the link but didn't know what to review.

[tunetheweb]

@ksakae1216 , ideally we'd have a second person reviewing all translations before we merge them to master. It's amazing what a second pair of eyes can spot. So anything you translate, @MSakamaki will review, and similarly anything he translates you can review. And if we get a third (or fourth!) Japanese translator then we can spread the load.

However when @MSakamaki translated those first three chapters (Markup, Performance and SEO), we didn't have a second Japanese translator so we just merged them without that review. We were hoping someone would join before we launched them so we could do that review - and now you're here! 😀

So it would be great if you could read those three translations now, and if you spot any issues then open a PR with suggested fixes. @MSakamaki can then review and he agrees approve the PR and we'll merge it in. If you're happy with the translations as they are and see no need for any changes then just add a comment to let us know.

One thing the French translation team did, that I really liked, was come up with a set of conventions for the French team to use. I copied those to the bottom of the first comment, but they are things like don't translation certain terms, which gender to use, and to use French versions of MDN documents whether they exist... etc. I don't know if those ones are exactly relevant to Japanese so feel free to discard them, but I'm sure there are similar conventions you and @MSakamaki should agree on. So as you read @MSakamaki 's translations I think it would be good to come up with some of these Japanese conventions too, so there's some consistency to the translations no matter who translated it. And actually documenting them in this issue will ensure these conventions are clear and help if another translator joins the team in future, or if someone queries any translations after go live.

Once you've read the three already translated chapters and have a sense of how to translate chapters, feel free to grab your own chapter by putting your name beside an unassigned chapter in the first comment and away you go!

Let me know if that all makes sense? However, these are all just suggestions. I've never done any translations and speak no Japanese, so you and @MSakamaki are the ones who can drive this issue through to completion - if you have better ways of working then go for it! Some of the translations teams are using one GitLocalise repo for all the translations, some have chat rooms (there's a Slack Channel for the Almanac - let me know if you can't access and need an invite), or you can message each other on Twitter or any other messaging platform, or just use this issue to comment back and forth. Up to you two!

[tunetheweb]

Oh just realised I gave the wrong link! That's probably why you're confused. Try this one: https://github.com/HTTPArchive/almanac.httparchive.org/tree/master/src/content/ja/2019 (and edited above comment).

[ksakae1216]

@tunetheweb , Thank you proposal.

I check three translated chapters.

Next, I will discuss to @MSakamaki whether rules should be created like the French team.

[MSakamaki]

Hello @ksakae1216 !

As for the translation rules for Japanese, I am currently working on the following rules:

Nayori of foreign words
https://www.jtca.org/standardization/katakana_guide_3_20171222.pdf
https://www.bunka.go.jp/kokugo_nihongo/sisaku/joho/joho/kijun/naikaku/gairai/index.html

Japanese proofreading (automation recommended, I useing Tool)
I am currently using 校正くん and moving to textlint.

There are other free OSSs, such as 校正くん and textlint and Redpen. If you have something you want to use, please let me know.

The other point is that English, katakana, hiragana, and kanji should be carefully selected throughout the content.

Feel free to talk about any other rules that might be needed.

[ksakae1216]

Hi @MSakamaki

Thanks advice.

I see.

[MSakamaki]

@ksakae1216
After translating accessibility, I tried to change Japanese proofreading to textlint.
Using this, I would like to match the sentences as much as possible.

Your settings can be made as shown in the following link.
https://gist.github.com/MSakamaki/a3b7cbf57231b6287a19be28534cb50d

Do you have any opinions?