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

pt-BR: Replaced {{HTMLRefTable}} with markdown table #12018

Merged
merged 6 commits into from
Mar 18, 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 ("Sectioning root", "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/20230115140446/https://developer.mozilla.org/pt-BR/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 21:49
@manjuu-eater manjuu-eater requested review from nathipg and removed request for a team March 4, 2023 21:49
@github-actions github-actions bot added the l10n-pt-br Issues related to Brazilian Portuguese label Mar 4, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Mar 4, 2023

Preview URLs

Flaws (118)

URL: /pt-BR/docs/Web/HTML/Element
Title: Elementos HTML
Flaw count: 118

  • macros:
    • /pt-BR/docs/Web/HTML/Attributes/accept does not exist but fell back to /en-US/docs/Web/HTML/Attributes/accept
    • /pt-BR/docs/Web/HTML/Attributes/autocomplete does not exist but fell back to /en-US/docs/Web/HTML/Attributes/autocomplete
    • /pt-BR/docs/Web/HTML/Attributes/capture does not exist but fell back to /en-US/docs/Web/HTML/Attributes/capture
    • /pt-BR/docs/Web/HTML/Attributes/crossorigin does not exist but fell back to /en-US/docs/Web/HTML/Attributes/crossorigin
    • /pt-BR/docs/Web/HTML/Attributes/disabled does not exist but fell back to /en-US/docs/Web/HTML/Attributes/disabled
    • and 104 more flaws omitted
  • broken_links:
    • Can't resolve /pt-BR/docs/Sections_and_Outlines_of_an_HTML5_document#sectioning_root
    • Can use the English (en-US) link as a fallback
    • Can use the English (en-US) link as a fallback
    • Can't resolve /En/Media_formats_supported_by_the_audio_and_video_elements
    • Can't resolve /pt-BR/JavaScript
    • and 3 more flaws omitted
  • translation_differences:
    • Differences in the important macros (0 in common of 3 possible)
External URLs (3)

URL: /pt-BR/docs/Web/HTML/Element
Title: Elementos HTML

(comment last updated: 2023-03-04 23:14:01)

@manjuu-eater
Copy link
Contributor Author

manjuu-eater commented Mar 4, 2023

Sorry, but I failed to convert on pt-BR.
Description was all English...
Please wait for a while.

@manjuu-eater
Copy link
Contributor Author

Now I converted to pt-BR correctly.
Sorry for mistake.

Copy link
Collaborator

@josielrocha josielrocha left a comment

Choose a reason for hiding this comment

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

LGTM ;)

@josielrocha josielrocha merged commit c75d85f into mdn:main Mar 18, 2023
@josielrocha
Copy link
Collaborator

Thank you for your help @manjuu-eater! 🚀

@manjuu-eater manjuu-eater deleted the htmlreftable-pt-br branch March 19, 2023 04:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
l10n-pt-br Issues related to Brazilian Portuguese
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants