diff --git a/3-terrarium/1-intro-to-html/translations/README.zh-cn.md b/3-terrarium/1-intro-to-html/translations/README.zh-cn.md new file mode 100644 index 00000000..85cd7761 --- /dev/null +++ b/3-terrarium/1-intro-to-html/translations/README.zh-cn.md @@ -0,0 +1,231 @@ +# 花艺瓶项目 Part 1: HTML 简介 + +![HTML 简介](/sketchnotes/webdev101-html.png) +> 由 [Tomomi Imura](https://twitter.com/girlie_mac) 绘制 + +## 课前测试 + +[课前测试](https://nice-beach-0fe9e9d0f.azurestaticapps.net/quiz/15?loc=zh_cn) + +### 介绍 + +HTML,全称 HyperText Markup Language,它是网页的骨架。如果说 CSS 在装扮你的 HTML,并且 JavaScript 让它活起来,HTML 则是你的网页应用程序的身体。而 HTML 的语法也正好能证明这种看法,它包含了名为 "head"(头部)、 "body"(身子) 和 "footer"(脚部) 的标签。 + +在这次课程中,我们将会使用 HTML 去布局我们的虚拟**花艺瓶**界面的骨架。它将包含一个标题和三列内容:左右两列放置的可以拖拽的植物,中间的区域放置的是一个玻璃造型的花艺瓶。完成这堂课的内容,你应该可以看到放置着植物的列,但界面可能看起来有点奇怪。但没必要担心,在后面的内容里你会使用 CSS 编写样式使得它变得好看起来。 + +### 任务 + +在你的电脑上,创建一个名为 'terrarium' 的文件夹,并且在其中创建 'index.html'。你可以在 Visual Studio Code 中打开一个新的 VS Code 窗口去创建你的 terrarium 文件夹,点击「打开文件夹」来查看你的文件目录。在侧边管理面板中点击微小的「文档」按钮來创建新的文件: + +![VS Code 的侧边管理面板](../images/vs-code-index.png) + +也可以这样 + +在 git bash 中执行以下命令: +* `mkdir terrarium` +* `cd terrarium` +* `touch index.html` +* `code index.html` 或是 `nano index.html` + +> index.html 文件会被你的浏览器识别为文件夹中的默认要打开的文件。例如这个网址:`https://anysite.com/test` 所对应的项目,是以包含着名为 `test` 目录且该目录存在 `index.html` 文件的结构构建的。并且 `index.html` 不需要展示在网址的末尾。 + +--- + +## DocType(文档类型声明) 和 html 标签 + +HTML 文件的第一行就是文档类型声明。要将这一行内容放在文档的最顶端的位置实在会让人有点惊讶,但是它却能告诉旧版本浏览器,它应该使用当前指定的 HTML 规范以标准的模式来渲染页面。 + +> 提示:在 VS Code 中,你可以把鼠标悬浮在标签上,以此来获取 MDN 参考指南中关于其使用的信息。 + +文档的第二行就应该是 `` 的起始标签,后面应该跟着的是 `` 的结束标签。这对标签是我们编写的界面的根元素。 + +### 任务 + +把这几行内容写到你的 `index.html` 文档开头: + +```HTML + + +``` + +✅ 通过设置带有查询字符串(query string)的 DocType 可以设定几种不同的模式:[怪异模式与标准模式](https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode)。这些模式用于支持现在非常不常用的古老浏览器(Netscape Navigator 4 和 Internet Explorer 5)。你仍可以使用标准的文档类型声明。 + +--- + +## 文档的 'head'(脑袋) + +HTML 文档中的 'head' 包含的区域有很多关于页面的重要信息,它也被称作[元数据(metadata)](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta)。在我们的例子中,我们告诉 web 服务器这个页面将依据哪些信息被发送进行渲染,主要是四种: + +- 网页的标题 +- 网页的元数据,它包含: + - 字符集(Character Set),说明在页面中使用的字符编码。 + - 浏览器信息,包括 `x-ua-compatible`,表示支持IE=edge浏览器 + - 关于视图在加载时应该如何表现的信息。将视口设置为初始比例为 1 可以控制页面首次加载时的缩放级别。 + +### 任务 + +在文档中,新增 'head' 部分在 `` 的标签里。 + +```html + + Welcome to my Virtual Terrarium + + + + +``` + +✅ 当你把视图信息标签的内容设置成这个样子 `` 会发生什么事情? 请阅读更多关于[Viewport](https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag)的信息吧。 + +--- + +## 文件的 `body`(身子) + +### HTML 标签 + +在 HTML 中,往你的 .html 文档中添加标签去创建元素到你的页面中。每个标签都通常都有一个开始标签和结束标签,像是:`

hello

` 就表明是一个段落。 使用一组 `` 标签放在`` 标签中以创建你界面的身体部分,现在你的文档应该变成下面这样: + +### 任务 + +```html + + + + Welcome to my Virtual Terrarium + + + + + + +``` + +现在,你可以开始构建你的页面了。一般来说,你会使用 `
` 标签在页面中创建单独的元素。我们将创建一系列包含图片的 `
` 元素。 + +### 图片 + +有一个不需要结束标签的 html 标签就是 `` 标签,因为它有一个 `src` 元素,它包含页面渲染该项所需的所有信息。 + +在你的项目目录中创建一个名为 `images` 的文件夹,把[源代码文件夹](../../solution/images)中所有的图片都放到新建的文件夹中。(里面总共有14张植物的图片) + +### 任务 + +把这些植物图片分为两列放到 `` 标签里: + +```html +
+
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+ plant +
+
+
+``` + +> 笔记: Spans 和 Divs。 Divs 是块元素,而 Spans 是行内元素。如果把它们替换了会发生什么? + +更新完我们代码后,屏幕上植物图片都展示出来了。只是看起来十分糟糕,因为我们还没有用 CSS 样式来美化它们,我们会在下一节课里面去处理。 + +每个图像都有 alt 文本,当你无法看到或者无法渲染图片的时候就会出现。这是可访问性的一个重要属性。你可以在在以后的课程中了解更多关于可访问性的内容;现在,只需要记住,如果用户由于某种原因不能查看图像,alt 属性为图像提供替代信息(造成的原因可能有 加载太慢、src 属性错误、或者用户可能使用的是屏幕阅读器等)。 + +✅ 你注意到每张图片都有相同的 alt 标签了吗?这是好的实现吗?为什么或为什么不?你能改进这个代码吗? + +--- + +## 语义化的标签 + +一般来说,在编写 HTML 时,最好使用有意义的 “语义” 。这是什么意思?这意味着你使用 HTML 标签来表示它们所被设计的数据或交互的类型。举个例子,网页上的核心标题就应该使用 `

` 标签。 + +在开头的 `` 标签下面添加以下一行: + +```html +

My Terrarium

+``` + +使用语义化的标签例如:标题使用 `

` 、无序列表使用 `
    ` ,这样能帮助屏幕阅读器理解页面的内容。一般来说,按钮需要写作 `

` 标签上面: + +```html +
+
+
+
+
+
+
+
+
+``` + +✅ 即使在屏幕上添加了这些内容,你仍然看不到任何东西渲染出来。为什么? + +--- + +## 🚀 挑战 + +HTML 中还有一些狂野的'旧'标签,玩起来仍然很有趣。虽然[这些标签](https://developer.mozilla.org/en-US/docs/Web/HTML/Element#Obsolete_and_deprecated_elements)不推荐你使用,但是,你还是可以试试,能否用 `` 标签让 h1 标题文字变成纵向展示的吗?(如果你这么尝试了,不要忘了在后面移除它们) + +## 课后测试 + +[课后测试](https://nice-beach-0fe9e9d0f.azurestaticapps.net/quiz/16?loc=zh_ch) + +## 复习 & 预习 + +HTML是 '久经考验的' 构建模块系统,它帮助构建了今天的 web 。通过研究一些旧的和新的标签来了解它的历史。你能找出为什么有些标签被弃用而有些被添加吗?未来可能引入哪些标签? + +要了解更多关于为web和移动设备建立网站的信息,请访问:[Microsoft Learn](https://docs.microsoft.com/learn/modules/build-simple-website/?WT.mc_id=academic-13441-cxa)。 + + +## 作业 + +[练习你的 HTML:建立一个博客模型](assignment.zh-tw.md)