ja の記事を HTML から MD へ一括変換

[mfuji09]

日本語版の記事を HTML から MD へ、スクリプトを使用して一括変換します。
一括変換は下記のような分野に分けて、順に行っていきます。

分類と進捗

（分類は見直すことがあります）

• conflicting
• games
• glossary
• learn
• mdn
• mozilla
  • mozilla/firefox
• orphaned
• web
  • web/accessibility
  • web/api
    • web/api/audio*
    • web/api/blob*
    • web/api/clients
    • web/api/css*
    • web/api/document
    • web/api/element
    • web/api/gamepad*
    • web/api/htmlformelement
    • web/api/media*
    • web/api/navigator
    • web/api/performance*
    • web/api/readablestream*
    • web/api/serviceworker*
    • web/api/sourcebuffer
    • web/api/speechrecognition
    • web/api/url*
    • web/api/vr*
    • web/api/webglrenderingcontext
    • web/api/webxr_device_api
    • web/api/window
    • web/api - 1
    • web/api - 2
    • web/api - 3
    • web/api - 4
    • web/api - 5
  • web/css
  • web/events
  • web/guide
  • web/html
  • web/http
  • web/javascript
  • web/mathml
  • web/media
  • web/progressive_web_apps
  • web/security
  • web/svg
  • web/xpath
  • web/xslt
• webassembly

進め方

1. 該当部分について前処理（手作業）を行い、スクリプトでの変換後の修正量が少なくなるようにする
2. スクリプトで一括変換を行う
3. 変換済みの状態で PR を作成
4. レビュー

• 特にうまく変換できていない点に気が付いたら、レビュアーに限らず修正をお願いします。
• markdown 変換作業を効率よく行うため、内容の更新や誤りの修正などについては、致命的なものを除き、変換後に別な PR にて行ってくださるようお願いします。
• markdown 変換は放置すると影響が大きいので、大きな問題がないと判断できたら数日程度で自己マージしますのでご了承ください。
• マージ完了後に問題に気づいた場合は、ふつうの修正の手順（PR の発行）に従って修正をお願いします。

その他

• レビュアーの方は、マージを行うときには必ず Rebase and merge でマージするようにお願いします。（ファイル名変更によって履歴が継承できなくなるのを防ぐため。）
• その他、何か不明点や要望があればこの Issue に書き込んでください。

[potappo]

ざっとチェックし始めました。藤本さんも気が付いている通り(#7768)、Note ブロックの変換が上手く行っていないようです。
MDN ディレクトリがもうすぐ見終わるので、次に javascript ディレクトリの方を見ます（昔に関わっているページが多いので）。

実質、レビュアーが私一人なので、レビューの優先度上げて欲しいディレクトリがあれば、リクエストください。金、土（ミートアップが午後からあります）、日は対応可能です（月曜以降もなるべく時間取りますが、仕事始まるのでどれだけ取れるかは未定）。

自分でチェックして、問題の有無のコメントをしていただいてもかまいません。

[mfuji09]

@potappo さん
Note: ブロックは使われているところが多いうえに、書き方がたくさんあり（Markdown 化直前に導入された、新しい書き方すらある）、使われている翻訳語もまちまちなので、マージ前にすべてを対処しようとすると、かなり時間がかかってしまいそうです。

マージを待たせることの方が影響が大きいと思うので、単純な置換で済むところや、致命的なところだけをマージ前に対処して、それ以降はメンテナンスに合わせて対処していくという方が現実的かもしれません。

[potappo]

@mfuji09 さん
なるほど、Note ブロックについて了解です。その対処方針で問題ないと思います。

[mfuji09]

@potappo さん
今までどのメタデータ項目が必要なのか、はっきりしていなかったんですよね・・・。
Issue を #7858 で作っておきました。

[mfuji09]

現在出ているプルリクエストがすべてマージできれば、 HTML ファイルはすべてなくなり、すべてのファイルが markdown になる見込みです。

[mfuji09]

ja ロケールのすべてのファイルの変換が完了しました。