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

/MDN 以下のファイルを md へ一括変換 #7765

Merged
merged 12 commits into from
Aug 19, 2022
Merged

Conversation

mfuji09
Copy link
Collaborator

@mfuji09 mfuji09 commented Aug 18, 2022

試験的に /mdn ディレクトリ以下を一括変換してみました。

@mfuji09 mfuji09 added l10n-ja Issues related to Japanese content. markdown-conversion 100% markdown project labels Aug 18, 2022
@mfuji09 mfuji09 requested a review from a team as a code owner August 18, 2022 02:09
@mfuji09 mfuji09 requested review from potappo and removed request for a team August 18, 2022 02:09
@github-actions
Copy link
Contributor

github-actions bot commented Aug 18, 2022

Preview URLs

Flaws

Note! 11 documents with no flaws that don't need to be listed. 🎉

URL: /ja/docs/MDN/At_ten/History_of_MDN
Title: MDN のあゆみ
on GitHub
Flaw count: 1

  • broken_links:
    • Can't resolve /ja/docs/MDN/Contribute/Localize

URL: /ja/docs/MDN/Contribute
Title: MDN への協力
on GitHub
Flaw count: 1

  • broken_links:
    • Can't resolve /ja/MDN/Community/Contributing/Getting_started

URL: /ja/docs/MDN/Contribute/Changelog
Title: MDN への貢献の変更履歴
on GitHub
Flaw count: 2

  • broken_links:
    • Can't resolve /ja/docs/MDN/Contribute/Howto/Write_an_API_reference/Information_contained_in_a_WebIDL_file#mixins
    • Can use the English (en-US) link as a fallback

URL: /ja/docs/MDN/Community
Title: コミュニティガイドライン
on GitHub
Flaw count: 3

  • broken_links:
    • Can use the English (en-US) link as a fallback
    • Can't resolve /ja/docs/MDN/Community/Learn_forum/
    • Can't resolve https://developer.mozilla.org/docs/Learn

URL: /ja/docs/MDN/Community/Open_source_etiquette
Title: オープンソースプロジェクトのための基本的なエチケット
on GitHub
Flaw count: 1

  • broken_links:
    • Can't resolve /ja/docs/MDN/Contribute/Getting_started#step_4_ask_for_help

URL: /ja/docs/MDN/Community/Contributing/Our_repositories
Title: MDN 上のものはどこにあるのか - リポジトリーのガイド
on GitHub
Flaw count: 1

  • translation_differences:
    • Differences in the important macros (1 in common of 2 possible)

URL: /ja/docs/MDN/Community/Contributing/Getting_started
Title: MDN で始めよう
on GitHub
Flaw count: 3

  • broken_links:
    • Can't resolve /ja/docs/MDN/Contribute/Open_source_etiquette
    • Can't resolve /ja/docs/MDN/Contribute/GitHub_beginners
    • Can't resolve /ja/docs/MDN/Contribute/Where_is_everything

URL: /ja/docs/MDN/Community/MDN_content
Title: MDN コンテンツのバグ修正
on GitHub
Flaw count: 3

  • broken_links:
    • Can't resolve /ja/docs/Tools
    • Can't resolve /ja/docs/MDN/Contribute/GitHub_best_practices
    • Can't resolve /ja/docs/MDN/Contribute/Getting_started

URL: /ja/docs/MDN/Community/Issues/Issue_triage
Title: MDN コンテンツのバグのトリアージ手順
on GitHub
Flaw count: 3

  • broken_links:
    • Can't resolve /ja/docs/MDN/Contribute/Fixing_MDN_content_bugs
    • Can use the English (en-US) link as a fallback
  • translation_differences:
    • Differences in the important macros (0 in common of 1 possible)

External URLs

URL: /ja/docs/MDN
Title: MDN Web Docs プロジェクト
on GitHub


URL: /ja/docs/MDN/At_ten
Title: MDN は 10 周年を迎えました
on GitHub

No new external URLs


URL: /ja/docs/MDN/At_ten/History_of_MDN
Title: MDN のあゆみ
on GitHub


URL: /ja/docs/MDN/MDN_Product_Advisory_Board
Title: MDN 製品諮問委員会
on GitHub


URL: /ja/docs/MDN/MDN_Product_Advisory_Board/Members
Title: 製品諮問委員会
on GitHub


URL: /ja/docs/MDN/MDN_Product_Advisory_Board/Membership
Title: 製品諮問委員会憲章および会員資格
on GitHub


URL: /ja/docs/MDN/Contribute
Title: MDN への協力
on GitHub


URL: /ja/docs/MDN/Contribute/Processes
Title: 文書作成のプロセス
on GitHub

No new external URLs


URL: /ja/docs/MDN/Contribute/Processes/Short_surveys
Title: 短いアンケートの実施プロセス
on GitHub


URL: /ja/docs/MDN/Contribute/Changelog
Title: MDN への貢献の変更履歴
on GitHub


URL: /ja/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN
Title: Markdown で書くには
on GitHub


URL: /ja/docs/MDN/Community
Title: コミュニティガイドライン
on GitHub


URL: /ja/docs/MDN/Community/Learn_forum
Title: 学習フォーラム
on GitHub


URL: /ja/docs/MDN/Community/Open_source_etiquette
Title: オープンソースプロジェクトのための基本的なエチケット
on GitHub


URL: /ja/docs/MDN/Community/Contributing/Our_repositories
Title: MDN 上のものはどこにあるのか - リポジトリーのガイド
on GitHub

No new external URLs


URL: /ja/docs/MDN/Community/Contributing/Getting_started
Title: MDN で始めよう
on GitHub


URL: /ja/docs/MDN/Community/MDN_content
Title: MDN コンテンツのバグ修正
on GitHub


URL: /ja/docs/MDN/Community/Issues
Title: MDN のための GitHub のベストプラクティス
on GitHub


URL: /ja/docs/MDN/Community/Issues/Issue_triage
Title: MDN コンテンツのバグのトリアージ手順
on GitHub

No new external URLs


URL: /ja/docs/MDN/Yari
Title: Yari: MDN のレンダリングプラットフォーム
on GitHub

(this comment was updated 2022-08-18 14:41:09.096564)

@mfuji09
Copy link
Collaborator Author

mfuji09 commented Aug 18, 2022

一括変換時のログメッセージです。
今回は、エラー部分は手作業で対応しました。

Report from 2022/8/17 22:55:36

All unhandled elements

  • div.notecard.warning (3)
  • td (3)
  • div.quote (1)

Details per Document

/ja/docs/MDN/At_ten

Missing conversion rules

  • div.quote (26:1)

/ja/docs/MDN/Community/Learn_forum

Missing conversion rules

  • div.notecard.warning (87:1)

/ja/docs/MDN/Contribute

Invalid AST transformations

td (42:4) => tableCell
type: "list"
ordered: false
start: 

spread: false
children: 
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "協力する分野のウェブ技術の知識 (JavaScript や CSS など)。"
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "英語に関する合理的な理解 (完璧でなくても構いません。私たちが支援します)。"
td (52:4) => tableCell
type: "list"
ordered: false
start: 

spread: false
children: 
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "協力する分野のウェブ技術の知識 (JavaScript や CSS など)。"
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "英語に関する合理的な理解 (完璧でなくても構いません。私たちが支援します)。"
td (62:4) => tableCell
type: "list"
ordered: false
start: 

spread: false
children: 
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "協力する分野のウェブ技術の知識 (JavaScript や CSS など)。"
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "技術的なトピックを説明したり、初心者がコードを学べるようにすることに対する熱意。"
  type: "listItem"
  spread: false
  children: 
    type: "paragraph"
    children: 
      type: "text"
      value: "適度な英語力。完璧である必要はありません。"

/ja/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN

Missing conversion rules

  • div.notecard.warning (11:1)
  • div.notecard.warning (153:1)

@mfuji09
Copy link
Collaborator Author

mfuji09 commented Aug 18, 2022

#7782

Copy link
Collaborator

@potappo potappo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

以下の変換ミスがあるようです。

  • 「学習フォーラム」のページの深いネストのリストの変換が上手く行っていない。
  • Note ブロックの変換が上手く行っていない(全般的に)。

@mfuji09
Copy link
Collaborator Author

mfuji09 commented Aug 18, 2022

両方とも対処してみました。

「学習フォーラム」の件ですが、どうやら変換スクリプトの処理の都合(バグ?)で、 <ol> がネストされたリストを変換すると、正しくインデントが解釈できなくなるようです。
<ol> を変換するときに、見出し番号の次に空白が2つ付いてしまうために、その項目の下位のインデントが正しく解釈できなくなってしまうようです。
事前処理で対策するのは無理そうなので、変換後に直すしかなさそうです。

Note: についてもわかる範囲で修正してみました。こちらも HTML の時には何通りもの書き方があったので(中には Yari になってから現れたものもある)、変換プロセスの中ですべてに対応するのは無理そうです。こちらは数が大変多いので、致命的なものと、単純な置換で対処できるものを除いて、変換完了後(マージ後)に気が付いた人が直すようにした方が現実的かもしれません。

@mfuji09 mfuji09 requested a review from potappo August 18, 2022 14:49
Copy link
Collaborator

@potappo potappo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK です。

@potappo potappo merged commit 6d67d52 into mdn:main Aug 19, 2022
@mfuji09 mfuji09 deleted the 20220818-mdn branch August 19, 2022 06:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
l10n-ja Issues related to Japanese content. markdown-conversion 100% markdown project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants