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

fix: sync content #14677

Merged
merged 21 commits into from
Jul 30, 2023
Merged

fix: sync content #14677

merged 21 commits into from
Jul 30, 2023

Conversation

pocketdr
Copy link
Contributor

Description

同步 Web 入门中的文章内容

Motivation

Additional details

考虑到网络问题,额外加入了译注,本地化指南中没有关于译注的要求,如果译注不妥可以删掉

@pocketdr pocketdr requested a review from a team as a code owner July 28, 2023 10:22
@pocketdr pocketdr requested review from jasonren0403 and removed request for a team July 28, 2023 10:22
@github-actions github-actions bot added the l10n-zh Issues related to Chinese content. label Jul 28, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Jul 28, 2023

Preview URLs

Flaws (104)

URL: /zh-CN/docs/Learn/Getting_started_with_the_web/Dealing_with_files
Title: 处理文件
Flaw count: 33

  • macros:
    • /zh-CN/docs/Learn/CSS/Building_blocks/Cascade_layers does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Cascade_layers
    • /zh-CN/docs/Learn/Performance/Multimedia does not exist but fell back to /en-US/docs/Learn/Performance/Multimedia
    • /zh-CN/docs/Learn/Performance/video does not exist but fell back to /en-US/docs/Learn/Performance/video
    • /zh-CN/docs/Learn/Performance/JavaScript does not exist but fell back to /en-US/docs/Learn/Performance/JavaScript
    • /zh-CN/docs/Learn/Performance/HTML does not exist but fell back to /en-US/docs/Learn/Performance/HTML
    • and 28 more flaws omitted

URL: /zh-CN/docs/Learn/Getting_started_with_the_web/HTML_basics
Title: HTML 基础
Flaw count: 38

  • macros:
    • /zh-CN/docs/Learn/CSS/Building_blocks/Cascade_layers does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Cascade_layers
    • /zh-CN/docs/Learn/Performance/Multimedia does not exist but fell back to /en-US/docs/Learn/Performance/Multimedia
    • /zh-CN/docs/Learn/Performance/video does not exist but fell back to /en-US/docs/Learn/Performance/video
    • /zh-CN/docs/Learn/Performance/JavaScript does not exist but fell back to /en-US/docs/Learn/Performance/JavaScript
    • /zh-CN/docs/Learn/Performance/HTML does not exist but fell back to /en-US/docs/Learn/Performance/HTML
    • and 30 more flaws omitted
  • broken_links:
    • Can't resolve /zh-CN/docs/learn/Accessibility
    • Can't resolve /zh-CN/docs/learn/Accessibility
    • Can't resolve /zh-CN/docs/learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#为什么我们需要结构化?

URL: /zh-CN/docs/Learn/Getting_started_with_the_web/What_will_your_website_look_like
Title: 设计网站外观
Flaw count: 33

  • macros:
    • /zh-CN/docs/Learn/CSS/Building_blocks/Cascade_layers does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Cascade_layers
    • /zh-CN/docs/Learn/Performance/Multimedia does not exist but fell back to /en-US/docs/Learn/Performance/Multimedia
    • /zh-CN/docs/Learn/Performance/video does not exist but fell back to /en-US/docs/Learn/Performance/video
    • /zh-CN/docs/Learn/Performance/JavaScript does not exist but fell back to /en-US/docs/Learn/Performance/JavaScript
    • /zh-CN/docs/Learn/Performance/HTML does not exist but fell back to /en-US/docs/Learn/Performance/HTML
    • and 28 more flaws omitted
External URLs (5)

URL: /zh-CN/docs/Learn/Getting_started_with_the_web/What_will_your_website_look_like
Title: 设计网站外观

(comment last updated: 2023-07-30 05:05:55)

@yin1999
Copy link
Member

yin1999 commented Jul 29, 2023

同时,请更正文档格式,参考:https://github.com/mdn/translated-content/blob/main/docs/zh-cn/translation-guide.md

@pocketdr
Copy link
Contributor Author

@yin1999 如果加入额外内容,如何确保后续的改动不会将其覆盖呢?Google 的替代链接倒是其次,主要是安全字体这一部分。原文并没有提及汉语的安全字体,而且英语的”安全字体“概念不太能直接套用到汉语上🤔

@yin1999
Copy link
Member

yin1999 commented Jul 29, 2023

@yin1999 如果加入额外内容,如何确保后续的改动不会将其覆盖呢?Google 的替代链接倒是其次,主要是安全字体这一部分。原文并没有提及汉语的安全字体,而且英语的”安全字体“概念不太能直接套用到汉语上thinking

Arial 应该也属于中文的安全字体(https://zh.wikipedia.org/zh-cn/Arial_Unicode_MS)。最佳的做法是修改英文文档,使其包含有关 Unicode 的说明。我并不是非常赞成对于本地化的内容分别添加额外的说明(也有不少读者会直接阅读英文文档,而且 MDN 目前支持的本地化语言有限)

@pocketdr
Copy link
Contributor Author

pocketdr commented Jul 29, 2023

@yin1999 看起来 Arial 和 Arial Unicode 是不同的字族,Arial 不算是中文的安全字体🤦‍♂️。而且汉语作为几乎唯一的语素文字,看起来也是唯一需要加入额外说明的(。_。)

@yin1999
Copy link
Member

yin1999 commented Jul 29, 2023

@yin1999 看起来 Arial 和 Arial Unicode 是不同的字族,Arial 不算是中文的安全字体man_facepalming。

是的,我弄错了

而且汉语作为几乎唯一的语素文字,看起来也是唯一需要加入额外说明的(。_。)

MDN 的本地化语言包括日语、韩语,还有就是我上面所说的,字体问题绝不仅仅是中文环境需要考虑的问题,这是国际化所必须涉及的。建议修改英文文档。

@pocketdr
Copy link
Contributor Author

MDN 的本地化语言包括日语、韩语,还有就是我上面所说的,字体问题绝不仅仅是中文环境需要考虑的问题,这是国际化所必须涉及的。建议修改英文文档。

也对,我看下加一点语素文字的说明进去,译注我就都删掉了

Comment on lines 99 to 103
- `<!DOCTYPE html>` — [文档类型](/zh-CN/docs/Glossary/Doctype)。这是必不可少的开头。混沌初分,HTML 尚在襁褓(大约是 1991/92 年)之时,这个元素用来关联 HTML 编写规范,以供自动查错等功能所用。而在当今,它作用有限,可以说仅用于保证文档正常读取。现在知道这些就足够了。
- `<html></html>` — {{htmlelement("html")}} 元素。该元素包含整个页面的所有内容,有时候也称作根元素。里面也包含了 `lang` 属性,写明了页面的主要语种。
- `<head></head>` — {{htmlelement("head")}} 元素。所有那些你加到页面中,且*不*向看客展示的页面成员,都以这个元素为容器。其中包含诸如提供给搜索引擎的{{Glossary("keyword", "关键字")}}和页面描述、用作风格化页面的 CSS、字符集声明等等。
- `<meta charset="utf-8">` — 该元素指明你的文档使用 UTF-8 字符编码,UTF-8 包括世界绝大多数书写语言的字符。它基本上可以处理任何文本内容。以它为编码还可以避免以后出现某些问题,没有理由再选用其他编码。
- `<meta name="viewport" content="width=device-width">` — [视口元素](/zh-CN/docs/Web/CSS/Viewport_concepts#mobile_viewports)可以确保页面以视口宽度进行渲染,避免移动端浏览器上因页面过宽导致缩放。
Copy link
Member

Choose a reason for hiding this comment

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

请阅读翻译指南,并更正标点和排版

@yin1999
Copy link
Member

yin1999 commented Jul 29, 2023

后续由 @jasonren0403 审查文档修改

Copy link
Contributor

@jasonren0403 jasonren0403 left a comment

Choose a reason for hiding this comment

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

还有一些问题和建议

Copy link
Contributor

@jasonren0403 jasonren0403 left a comment

Choose a reason for hiding this comment

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

👍 感谢

@jasonren0403 jasonren0403 merged commit dc10b46 into mdn:main Jul 30, 2023
9 checks passed
@pocketdr pocketdr deleted the sync_web_start branch August 1, 2023 15:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
l10n-zh Issues related to Chinese content.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants