使用 CSS 让你的 HTML 项目更具风格。
当你编写文档时，无论是为开源项目还是技术写作项目，你都应该有两个目标：文档应该写得好，同时要易于阅读。前者通过清晰的写作技巧和技术编辑来解决。第二个目标可以通过对 HTML 文档进行一些简单的更改来解决。
超文本标记语言（HTML）是互联网的支柱。自 1994 年“万维网”问世以来，所有网络浏览器都使用 HTML 来显示文档和网站。几乎与此同时，HTML 一直支持样式表，它是对 HTML 文档的一种特殊添加，用于定义文本在屏幕上的呈现方式。
单纯用 HTML 编写项目文档也是可以的。然而，纯 HTML 样式可能感觉有点简陋。因此，尝试向 HTML 文档添加一些简单的样式，为文档添加一点活力，并使文档更清晰、更易于阅读。
定义一个 HTML 文档
让我们从一个纯 HTML 文档开始，探索如何向其添加样式。一个空的 HTML 文档在顶部包含 定义，后面跟着一个 块来定义文档本身。 在 元素中，你还需要加上一个文档标头，其中包含有关文档的元数据，例如标题。文档正文的内容放在父 块内的 块中。
你可以使用以下 HTML 代码定义一个空白页面：
在另一篇关于 用 HTML 编写项目文档的文章中，我将一个开源棋盘游戏的自述文件从纯文本更新为 HTML 文档，并使用一些基本的 HTML 标记，如 和 作为标题和副标题， 用于段落， 和 用于粗体和斜体文本。让我们从那篇文章结束的地方继续讲：
简易 Senet
游戏玩法
游戏会自动为你“投掷”投掷棒，并在屏幕右下角显示结果。
如果“投掷”结果为零，你失去本轮机会。
轮到你的时候，游戏会自动选择 你在棋盘上的第一块棋子。 你不一定 能够用这个棋子走棋，所以选择你的棋子 移动，然后按 
应用样式
你可以使用样式使这个自述文件更易于阅读。 因为你刚刚开始学习样式，还是先只用一些简单的样式元素：
background-color设置背景颜色color设置文字颜色font-family使用不同的文本字体margin-top在元素上方添加空间margin-bottom在元素下方添加空间text-align改变文本的对齐方式，例如靠左、靠右或居中
让我们重新开始你的样式表并将这些新样式应用到文档中。首先，在文档中使用更令人愉悦的字体。如果你的 HTML 文档没有指定字体，网络浏览器会为你选择一种。根据浏览器的设置方式，这可能是衬线字体（如我的屏幕截图中使用的字体）或无衬线字体。衬线字体在每个字母上添加了一个小笔画，这样在打印时更容易阅读。无衬线字体缺少这种额外的笔划，这使得文本在计算机显示器上显得更清晰。常见的衬线字体包括 Garamond 或 Times New Roman。 流行的无衬线字体包括 Roboto 和 Arial。
例如，要将文档正文字体设置为 Roboto，你可以使用以下样式：
body { font-family: Roboto; }
通过设置字体，你假设查看文档的人也安装了该字体。有些字体已经十分常见，以至于它们被认为是事实上的“网页安全”字体。 这些字体包括 Arial 等无衬线字体和 Times New Roman 等衬线字体。Roboto 是一种较新的字体，可能还无法随处可用。因此，网页设计师通常不会只列出一种字体，而是设置一种或多种“备用”字体。你可以通过用逗号分隔来添加这些替代字体。 例如，如果用户的系统上没有 Roboto 字体，你可以使用以下样式定义将 Arial 字体用作文本正文：
body { font-family: Roboto, Arial; }
所有网络浏览器都定义了默认的衬线和无衬线字体，你可以使用这些名称来引用它们。用户可以更改他们喜欢用于显示衬线和无衬线的字体，因此不太可能对每个人都一样，但在字体列表中使用 serif或sans-serif通常是个好主意。通过添加该字体，至少用户可以大致了解你希望 HTML 文档的呈现方式：
body { font-family: Roboto, Arial, sans-serif; }
如果字体名称不止一个单词，则你必须在其两边加上引号。HTML 允许你在此处使用单引号或双引号。 为标题和副标题定义一些衬线字体，包括 Times New Roman：
h1 { font-family: "Times New Roman", Garamond, serif; }h2 { font-family: "Times New Roman", Garamond, serif; }
请注意，H1 标题和 H2 副标题使用完全相同的字体定义。如果你想避免无谓的打字，可以使用样式表快捷方式为 H1 和 22 使用相同的样式定义：
h1, h2 { font-family: "Times New Roman", Garamond, serif; }
在编写文档时，许多技术作者更喜欢将主标题放在页面的中央。你可以在块元素（例如 H1 标题）上使用 text-align来使标题居中：
h1 { text-align: center; }
为了让粗体和斜体文本更突出，请将它们置于稍微不同的颜色中。对于某些文档，我可能会使用深蓝表示粗体文本，使用深绿表示斜体文本。这些颜色非常接近黑色，但颜色的细微差别足以吸引读者的注意力。
b { color: darkblue; }i { color: darkgreen; }
最后，我更喜欢在我的列表元素周围添加额外的间距，以使它们更易于阅读。如果每个列表项只有几个词，额外的空间可能无关紧要。但是我的示例文本中的中间项很长，可以换到第二行。 额外的空间有助于读者更清楚地看到此列表中的每个项目。 你可以使用边距样式在块元素上方和下方添加空间：
li { margin-top: 10px; margin-bottom: 10px; }
这种样式定义了一个距离，此处我将其指定为每个列表元素上方和下方的 10px（十个像素）。 你可以使用多种不同的距离度量。十像素实际上就是屏幕上十个像素的空间，无论是台式机显示器、笔记本电脑显示屏，还是手机或平板电脑屏幕。
假设你真的只是想在列表元素之间添加一个额外的空行，你也可以使用 em来测量。em是一个旧的排版术语，如果你指的是左右间距，它就是大写M的宽度，或者对于垂直间距，就是大写M的高度。所以你可以改用 1em 来写边距样式：
li { margin-top: 1em; margin-bottom: 1em; }
HTML 文档中的完整样式列表如下所示：
简易 Senet
游戏玩法
游戏会自动为你“投掷”投掷棒，并在屏幕右下角显示结果。
如果“投掷”结果为零，你失去本轮机会。
轮到你的时候，游戏会自动选择 你在棋盘上的第一块棋子。 你不一定 能够用这个棋子走棋。所以选择你的棋子 移动，然后按 
这是在技术写作中使用样式的简单介绍。掌握了基础知识后，你可能会对 Mozilla 的 HTML 指南感兴趣。它包括一些很棒的初学者教程，因此你可以学习如何创建自己的网页。
有关 CSS 样式的更多信息，我推荐 Mozilla 的 CSS 指南。
（题图： MJ:web internet traffic design）
via: ***/article/22/8/css-html-project-documentation
本文由 LCTT原创编译，Linux中国荣誉推出
