Tracking markdown convertion for zh-{CN,TW}

[yin1999]

It's used to track the markdown convertion for zh-{CN, TW} documents. Before starting the conversion, we need to:

• clean up <a> tag (at least remove title and style), see: update links for zh-TW (cleaning up <a> tags) #6065 for zh-TW
• clean up <p>, <dt>, <dd>, see: clean up all <p>, <dt> and <dd> tag #6035 clean up all <p>, <dt> and <dd> tag for zh-CN (Part 1) #6088 clean up all <p>, <dt> and <dd> tag for zh-CN (Part 2) #6127 clean up all <p>, <dt> and <dd> tag for zh-CN (Part 3) #6168 (almost done)
• replace standard-table with {{Specifications}} macros (optional, still working on it daily) replace standard-table with macros (Part 1) #5782, replace standard-table with macros for zh-CN (Part 28) #6873
• remove all <font> and <span> tags~ (done in both zh-CN and zh-TW, see Tracking removal of span and font tags in zh-{TW,CN} #5436)
• clean up h1-h5, strong tags prue <h2> - <h5> tags for zh-CN (Part 1) #6515, pure strong tags for l10n-zh #6879

To working on it, please see #2474 to set up the environment first.

[yin1999]

zh-TW:

• games convert to markdown for games zh-TW #6651
• glossary convert to markdown for glossary zh-TW #6578
• learn/* convert to markdown for learn zh-TW #7453
• learn/{accessibility, common_questions} convert two sections into markdown for zh-TW #6689
• learn/html convert to markdown for learn/html zh-TW #7121
• learn/javascript/{asynchronous, building_blocks} convert to markdown for learn/javascript/{asynchronous, building_blocks} zh-TW #7416
• learn/{forms, server-side} convert to markdown for learn/{forms, server-side} zh-TW #7356
• learn/performance convert to markdown for learn/performance #6978
• learn/server-side/django convert to markdown for learn/server-side/django zh-TW #7206
• learn/server-side/express_nodejs convert to markdown for learn/server-side/express_nodejs zh-TW #7314
• learn/tools_and_testing convert to markdown for tools_and_testing zh-TW #7161
• mdn convert to markdown for mdn section zh-TW #6773
• mozilla convert to markdown for mozilla zh-TW #6846
• web/* convert to markdown for web/* zh-TW #7576
• web/accessibility markdown convertion for web/accessibility zh-TW #6513
• web/{guide, html} convert to markdown for web/{guide, html} zh-TW #7562
• web/{http, javascript, manifest, mathml} convert to markdown for web/{http, javascript, manifest, mathml} zh-TW #7539
• web/{opensearch, performance, security, progressive_web_apps} convert to markdown for web/{opensearch, performance, security, progressive_web_apps} zh-TW #7509
• web/{svg, tutorials} convert to markdown for web/{svg, tutorials} zh-TW #7017
• webassembly convert to markdown and sync with english version for WebAssembly #5501

[awxiaoxian2020]

Hi, @yin1999 I want to write a guide in Simplified Chinese for this issue as the project is huge and complex. Do you think it is necessary to make a PR?

[yin1999]

I want to write a guide in Simplified Chinese for this issue as the project is huge and complex. Do you think it is necessary to make a PR?

Feel free to do this.

[yin1999]

zh-CN:

• games convert to markdown for games zh-CN #6655
• learn/* convert to markdown for learn zh-CN #7452
• learn/{accessibility, common_questions} convert two sections into markdown for zh-CN #6686
• learn/html convert to markdown for learn/html zh-CN #7120
• learn/javascript/* convert to markdown for learn/javascript zh-CN #7420
• learn/javascript/building_blocks convert to markdown for learn/javascript/building_blocks zh-CN #7355
• learn/performance convert to markdown for learn/performance #6978
• learn/server-side/django convert to markdown for Learn/Server-side/Django zh-CN #7191
• learn/server-side/express_nodejs convert to markdown for learn/server-side/express_nodejs zh-CN #7264
• learn/server-side/* convert to markdown for learn/server-side zh-CN #7316
• learn/tools_and_testing convert to markdown for tools_and_testing zh-CN #7159
• glossary convert to markdown for glossary zh-CN #6625
• mdn convert to markdown for mdn section zh-CN #6772
• mozilla convert to markdown for mozilla zh-CN #6922
• web/accessibility convert to markdown for web/accessibility zh-CN #6942
• web/* convert to markdown for web/* zh-CN #7718
• web/api convert to markdown for web/api zh-CN #7705
• web/api/abortcontroller convert to markdown for web/api/abortcontroller zh-CN #7001
• web/api/performanceobserver web/api/performanceobserver h2m Performance observer #7280
• web/css convert to markdown for web/css zh-CN #7678
• web/{demos, events, exslt} convert to markdown for web/{demos, events, exslt} zh-CN #7031
• web/guide convert to markdown for web/guide zh-CN #7646
• web/html convert to markdown for web/html zh-CN #7635
• web/http convert to markdown for web/http zh-CN #7601
• web/{javascript, manifest, mathml, media, performance} convert to markdown for web/{javascript, manifest, mathml, media, performance} zh-CN #7558
• web/{progressive_web_apps, security, tutorials, web_components, xml} convert some sections in web to markdown for zh-CN #7494
• web/svg convert to markdown for web/svg zh-CN #7521
• web/{xpath, xslt} convert to markdown for web/{xpath, xslt} zh-CN #6988
• webassembly convert to markdown for webassembly zh-CN #6809

[awxiaoxian2020]

Could we only convert them and not care the content review for the time being?

[yin1999]

Could we only convert them and not care the content review for the time being?

If you want, you can add a continue; here (locally): https://github.com/mdn/yari/blob/528d743ae2935d3dc5482585a28449ba5a2a0d30/markdown/cli.ts#L190-L196

Then you can just run --mode replace to convert non-error documents (section by section, and leave mozilla section for me)

If there are too many unhandled errors, it's harder to resolve in .md files.

[awxiaoxian2020]

Could we only convert them and not care the content review for the time being?

If you want, you can add a continue; here (locally): https://github.com/mdn/yari/blob/528d743ae2935d3dc5482585a28449ba5a2a0d30/markdown/cli.ts#L190-L196

Then you can just run --mode replace to convert non-error documents (section by section, and leave mozilla section for me)

If there are too many unhandled errors, it's harder to resolve in .md files.

格式问题我会处理的，我是说将文件转换成 md 文件而不关心翻译是否过时，是否准确等问题。等到全部转换完成（merge）后有时间再重新维护内容。格式问题我会处理的。
如果可以的话，我将发起一个 PR 去批量地处理文件。

[yin1999]

格式问题我会处理的，我是说将文件转换成 md 文件而不关心翻译是否过时，是否准确等问题。等到全部转换完成（merge）后有时间再重新维护内容。格式问题我会处理的。 如果可以的话，我将发起一个 PR 去批量地处理文件。

对于批量文件转换，不用关心是否过时

[awxiaoxian2020]

格式问题我会处理的，我是说将文件转换成 md 文件而不关心翻译是否过时，是否准确等问题。等到全部转换完成（merge）后有时间再重新维护内容。格式问题我会处理的。 如果可以的话，我将发起一个 PR 去批量地处理文件。

对于批量文件转换，不用关心是否过时

I‘ll work on it.

[queengooborg]

Hey all -- FYI, I've written a new conversion guide at https://github.com/mdn/markdown/blob/main/conversion-guide.md with updated instructions, as many of the special cases that had to be taken care of before conversion are now automatically handled! Hope this helps with your locale's conversion!

[yin1999]

Hi @irvin, there are only conflicting documents left in html format (zh-TW). How should we deal with them?

I usually sync the associated non-conflicting document and remove the conflicting one. But I am not good at traditional Chinese.

/cc @queengooborg

[irvin]

hi @yin1999 feel free to removed them, thanks.