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

es: Replaced {{HTMLRefTable}} with markdown table #12015

Merged
merged 6 commits into from
Mar 6, 2023

Conversation

manjuu-eater
Copy link
Contributor

@manjuu-eater manjuu-eater commented Mar 4, 2023

Description

The {{HTMLRefTable}} macro became obsolete, and the entire table content was gone. So, I converted the macros as described below:

  1. Get the markdown corresponding to the "Element" cell of each table from the English version
  2. Set the markdowns to the "Element" cells in the translated version
  3. For each element (=HTML tag), get the first line of the translated version of the page
    (specifically, the first line that is not a front-matter, heading, or Lv1 list)
  4. Set the retrieved line to the "Description" cell
  5. If "Description" cell was empty, fill with en-US description ({{HTMLRefTable}} did not seem to have this process)

I am not entirely sure what the {{HTMLRefTable}} macro was actually doing.
I assumed it probably did something like the above.
A PR in the Japanese version (#11993) was determined that there was no problem.

I can't understand what the translated text means.
So, I would like the reviewer to do the following tasks:

  1. Since I did the conversion semi-mechanically, there may be some strange things in the text. Please check it lightly.
  2. Please compare with WayBackMachine page and check if there are any significant changes.
  3. The chapters that existed in the English version but were not in the translated version (SVG and MathML) have been copied directly from the English version. Please translate them later.

I am writing this English text with using a translator. Sorry if there are parts that are difficult to read.

Thank you in advance.

Motivation

Additional details

WayBackMachine page: http://web.archive.org/web/20221209144013/https://developer.mozilla.org/es/docs/Web/HTML/Element
current page: https://developer.mozilla.org/es/docs/Web/HTML/Element

Related issues and pull requests

Relates to #11953

@manjuu-eater manjuu-eater requested a review from a team as a code owner March 4, 2023 20:59
@manjuu-eater manjuu-eater requested review from davbrito and removed request for a team March 4, 2023 20:59
@manjuu-eater manjuu-eater changed the title Replaced {{HTMLRefTable}} with a summary of each tag es: Replaced {{HTMLRefTable}} with a summary of each tag Mar 4, 2023
@github-actions github-actions bot added the l10n-es Issues related to Spanish content. label Mar 4, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Mar 4, 2023

Preview URLs

Flaws (63)

URL: /es/docs/Web/HTML/Element
Title: Referencia de Elementos HTML
Flaw count: 63

  • macros:
    • /es/docs/Web/HTML/Attributes/autocomplete does not exist but fell back to /en-US/docs/Web/HTML/Attributes/autocomplete
    • /es/docs/Web/HTML/Attributes/capture does not exist but fell back to /en-US/docs/Web/HTML/Attributes/capture
    • /es/docs/Web/HTML/Attributes/disabled does not exist but fell back to /en-US/docs/Web/HTML/Attributes/disabled
    • /es/docs/Web/HTML/Attributes/elementtiming does not exist but fell back to /en-US/docs/Web/HTML/Attributes/elementtiming
    • /es/docs/Web/HTML/Attributes/for does not exist but fell back to /en-US/docs/Web/HTML/Attributes/for
    • and 39 more flaws omitted
  • broken_links:
    • Can't resolve /en/Sections_and_Outlines_of_an_HTML5_document#sectioning_root
    • Can't resolve /es/HTML/Element/article
    • Can't resolve /es/HTML/Element/aside
    • Can't resolve /es/HTML/Element/nav
    • Can't resolve /es/HTML/Element/section
    • and 13 more flaws omitted
  • translation_differences:
    • Differences in the important macros (0 in common of 2 possible)

(comment last updated: 2023-03-04 21:16:26)

@manjuu-eater manjuu-eater changed the title es: Replaced {{HTMLRefTable}} with a summary of each tag es: Replaced {{HTMLRefTable}} with md table Mar 4, 2023
@manjuu-eater manjuu-eater changed the title es: Replaced {{HTMLRefTable}} with md table es: Replaced {{HTMLRefTable}} with markdown table Mar 4, 2023
Copy link
Contributor

@Graywolf9 Graywolf9 left a comment

Choose a reason for hiding this comment

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

Some corrections

files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
files/es/web/html/element/index.md Outdated Show resolved Hide resolved
Copy link
Contributor

@Graywolf9 Graywolf9 left a comment

Choose a reason for hiding this comment

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

Awesome job! Thank you so much for your time and help!

@Graywolf9 Graywolf9 merged commit a2f722c into mdn:main Mar 6, 2023
@manjuu-eater manjuu-eater deleted the htmlreftable-es branch March 16, 2023 07:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
l10n-es Issues related to Spanish content.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants