Chore - convert all HTML files to Markdown

[queengooborg]

This issue is an overview issue for the Markdown conversion project. Throughout the localized content, there are still 20,919 6,813 files that have yet to be converted from HTML to Markdown. This applies to all locales and should be considered a high priority task.

Instructions:

Please carefully read the conversion guide in the mdn/markdown repository. The script that you will need is also contained within this repository.

Reviewers: remember to rebase merge instead of squash merge to retain Git history for converted files!

Locales:

• es - 2366 2047 1723 files remain Meta - Tracking issue for Markdown conversion es #8635
• fr
• ja - 3806 0 files remain ja の記事を HTML から MD へ一括変換 #7782
• ko - 2126 403 329 0 files remain [ko] Markdown conversion for ko RoadMap #2894
• pt-br - 2071 1201 503 files remain Meta - Tracking issue for Markdown conversion pt-BR #7950
• ru - 2861 2389 files remain Meta - Tracking issue for Markdown conversion ru #7580
• zh - 4968 0 files remain Tracking markdown convertion for zh-{CN,TW} #6173

[SphinxKnight]

Thanks a lot @queengooborg
I hope https://github.com/mdn/translated-content/discussions/2474 may also be useful to provide a guide/process.

[queengooborg]

Thanks for linking that guide, @SphinxKnight, this is really amazing!

Do you mind if I update the guide text, including pointing translators to my fork of mdn/markdown, and update a few descriptions of special cases that don't need to be handled any longer? I know that sounds like a little bit of self-advertising (since it's my own fork and all), but the upstream script contains a critical issue that causes loss of information (and my updates do handle a lot of the special cases previously unhandled) and I want to discourage the upstream script's use until the issues have been resolved (AKA my PR is merged)!

[SphinxKnight]

Do you mind if I update the guide text, including pointing translators to my fork of mdn/markdown, and update a few descriptions of special cases that don't need to be handled any longer?

Please do if you can edit it :)
And if you can't directly, let me know your version over a pastebin or Matrix and I'll apply it

[queengooborg]

Good news: my changes were now merged upstream and I have write access to the upstream repository now, so I'll be able to update the script much easier!

[hochan222]

3. Run yarn h2m <folder> --locale <locale> --mode replace

It seems that md is missing somehow, is that correct..? Or are there any other recent changes?

yarn md h2m <folder> --locale <locale> --mode replace

[queengooborg]

That's correct, yes! Because "h2m" is the only command in the repository, I removed the "md" part of the command for a little more simplicity!

[hochan222]

If so, the code merge hasn't been done yet. Thanks for the reply :)

package.json for yari

"md": "ts-node markdown/cli.ts",

[queengooborg]

Ah, you should actually be using https://github.com/mdn/markdown, not Yari -- the code has been moved out of Yari a long time ago (I thought it was actually removed from Yari), and the version in Yari is not getting any updates!

[mfuji09]

'ja' locale is done.

[SphinxKnight]

see https://hacks.mozilla.org/2022/09/the-100-percent-markdown-expedition/ and mdn/mdn-community#227 from @schalkneethling

Edit: the Google spreadsheet: https://docs.google.com/spreadsheets/d/1Mk3bQoHXozN2rUWn9rxVHA5MiO0whDLuj71KKC0iMSg/edit#gid=353394626

[hochan222]

ko locale is done :)

[SphinxKnight]

pt-BR is done apart from conflicting and orphaned folders :) Thanks @josielrocha and @nathipg for the reviews 🙇

[Graywolf9]

es locale is done!

[SphinxKnight]

and ru is done as well thanks to @sashasushko :)

Only HTML files remaining are oprhaned/conflicting for ru and pt-BR