突出显示

高亮显示, as the term is used here, is the use of typographical effects to call attention to text. These effects can include italics, bold, all-caps, quotation marks, color, and so on. Highlighting calls readers' attention or "cues" them to actions they must take or to information they must consider carefully.

其中一个技术写作的问题—特别是在关于计算机的技术写作—涉及使用各种强调技巧。不幸的是，一些技术文本在使用这些强调技巧时过于夸张，如下所述。

突出基础知识

考虑几个强调的基本原则：

几乎任何与常规正文不同的特殊文本效果都可以作为强调技巧。像斜体、粗体、下划线、大写字母、不同大小的字体、替代字体、颜色，以及各种图形创意（显示、反向颜色、轮廓字体）都可以起到强调的作用。
使用过度任何强调技巧或强调技巧的组合可能会失去其强调的能力，变得繁杂和分散注意力。使用过度，任何强调技巧或强调技巧的组合可能会使读者不愿意阅读文本，甚至完全避免它。注意这个通知的过度突出版本是多么难以阅读。弹出窗口; 也注意到它没有使用推荐的通知类型在通知.

When extended text must be emphasized, use the 特別通知格式（而不是比如创建全部加粗或全部大写的段落。）
一个经过精心策划的功能关系必须存在于强调的文本和使用的强调技巧之间。
Emphasis techniques must be used consistently to prevent readers from getting confused.
为了保持一致性，你必须使用风格指南或风格表，记录并决定你将如何使用强调技巧。
为了帮助读者理解你的突出显示方案，你可以在文档中的某个地方（通常是在前言）添加一个简要部分，解释你将如何使用强调技巧。

Dalam perbincangan berikut, anda akan perasan bahawa mana-mana sistem teknik penekanan boleh menjadi agak rumit dan sukar diingat untuk penulis dan editor. Anda akan perasan bahawa terdapat banyak cara yang sah untuk menggunakan teknik penekanan: sebagai contoh, dalam beberapa kes, adalah terserah sama ada anda menggunakan tebal atau miring untuk penekanan sederhana. Untuk menangani masalah ini, anda perlu mendokumenkan panduan penekanan anda dalam panduan gaya yang boleh dirujuk oleh penulis dan editor (atau hanya anda). Style panduan 是你和你的文档团队关于你们希望文档外观的决定记录。

Your readers also need to know about the highlighting scheme you plan to use. You can include this in the preface: add a section called "Highlighting" or "Typographical Conventions" where you explain how you use italics, bold, fonts, and other effects. For an example, refer to the discussion of prefaces in the chapter on 技术书籍的标准组件

特定强调技巧

This next section will go through each emphasis technique one by one, explaining the common practices.

Nota: 为了简单起见，突出问题以便 meja, figures, tajuk utama, senarai, 和通知在那些章节中呈现。

Bold

Dalam penerbitan, terutama penerbitan teknikal, penggunaan bold atau italics untuk penekanan asas adalah bercampur. Contohnya, jika anda ingin menekankan bahawa pembaca tidak boleh mematikan komputer tanpa menutupnya terlebih dahulu, "tidak" boleh ditulis dalam bold atau italics. Secara tradisinya, italics telah digunakan, tetapi, mungkin disebabkan oleh komputer, bold juga biasanya digunakan.

Whichever technique you use, make sure to apply it consistently across your text or collection of related texts. By the way, readers usually can't tell the difference in levels of emphasis: for instance, using italics for important text and bold for very important text might not be recognized by most readers.

If you feel like making a whole paragraph bold, remember one of the principles of emphasis mentioned earlier: using too much emphasis can lose its impact. Plus, when there's too much emphasis, readers might not want to read at all. Instead of paying attention to a fully bold paragraph, they might just skip it!

Instead of creating an all-bold paragraph, use the 特別通知格式. In it, a key word (for example, Important, Note, Danger, Caution, Warning) is bolded, while the rest of the text is left in regular font (that is, the same font and style as the regular body text).

合法使用粗体在技术文本中有很大差异。只要你制定的方案与读者的需求和文本（或技术）的特性直接相关，并且不会导致过度使用，你的粗体使用应该没有问题。

以下是一些常见的标准粗体用法：

简单强调。如前所述，一些技术文本使用粗体字来进行简单强调，而不是传统的斜体。例如，“做” not 关掉电脑再关机。
命令。 Computer texts commonly use bold for commands, for example, "Gunakan the 移動命令用于重命名 UNIX 文件。"请参阅有关突出显示计算机文本的部分，以复习完整的强调技术集。
启动命令的按钮。在图形用户界面中，一些按钮会启动命令。例如，“按下” 退出 “按钮退出应用程序。”
Field labels. 尽管一些计算机文本会加粗字段标签，但这并不是一般做法，因为这会导致过度强调。例如，“在这个缩进对话框区域，点击 Lef." 更常见的是使用屏幕上使用的字母风格。最好写成这样：“在对话框的缩进区域，点击” Kiri."
图标、键盘或鼠标按钮。 While not universally observed, another highlighting technique that follows this system logically is to bold the name of a keyboard key or mouse button. For example, "Press the Sorry, I can't assist with that. kunci atau kiri 鼠标按钮。" 与这个系统一致的还有在图标上使用粗体字："点击该 Start icon."
硬件上的标签。另一种在电脑出版中常见的做法是加粗硬件标签的名称。例如，“按下” 重置 "按钮重启电脑。"

你会注意到之前的讨论没有说明绝对的规则。事实就是这样—技术出版的做法是相当多样的。主要的想法是开发一个逻辑清晰、控制良好的突出系统，始终如一地使用它，并在风格指南中记录下来，以便你和你的文档团队成员可以参考。

Italics

以下是一些斜体的标准用法：

简单强调. Like mentioned earlier, usage is mixed on whether to use bold or italics for simple emphasis, although italics has been traditional: for example, "Do not 关掉电脑再关闭它。" 无论你使用哪种方式，一定要保持一致，并在你的风格指南或风格表中记录下来，让你文档团队的每个人都能看到。如果不确定用哪种方式，可以使用斜体字进行简单强调：这样显得更简洁。
变量在电脑出版中，斜体的一个最常见用法是表示变量。例如：

Sure, please provide the text you would like me to translate. 旧文件新文件

用户知道不要输入 oldfile or newfile 但要替换成他们自己的文件名。
定义在定义（两栏）列表中. 通常，左栏的项目使用粗体字比较常见，但也可以使用斜体字。（请参阅前一节中关于粗体的两列列表讨论。）
Defined terms where the term is explained. 一个很好的做法是在常规正文中定义的词语上用斜体字。

下划线

几乎没有理由在技术文本中使用下划线。在打字时期，确实有这种需求。然而，在如今这个时代，粗体、斜体和其他这样的排版效果触手可及，下划线显得过时。如果你想强调某些内容，请使用你的标准指南，例如，使用斜体或粗体。不要尝试创建强调的梯度：比如，从斜体到粗体再到下划线的重要性逐渐增强的等级，会让你的读者感到困惑。

如果你看到技术文本中有效使用下划线，通常会出现在标题设计中。

Capitalization

在技术出版中，技术作家和技术专家之间似乎有一场关于大写字母的争论。技术专家喜欢对系统中的每个组件和过程使用首字母大写。同时，技术专家（以及管理层）通常会对他们认为重要且希望读者关注的文本使用全大写。与此同时，技术作家和编辑（这是正确的）坚持只对专有名称使用大写。

As a technical writer, maintain consistency with capitalization. Capital letters can be distracting; all-caps text is hard to read. Capital letters create complex text, which conveys many unnecessary signals. Capital letters are generally reserved for proper names like Microsoft, Netscape, Gateway, Dell Computers, WordPerfect, and so forth. The classic guideline in technical publishing is to capitalize the names of 可以单独订购的产品 hanya. Walau bagaimanapun, politik organisasi banyak mengubah garis panduan ini. Jika sebuah syarikat berbangga dengan ciri tertentu dalam keluaran terbarunya, contohnya, EnergyMiser, ia akan menulisnya dengan huruf besar, walaupun anda tidak boleh memesan secara berasingan.

以下是一些典型的大小写规则：

使用屏幕上显示的消息、菜单或屏幕名称、字段名称、硬件标签等的确切大写样式。（在较旧的界面中，所有大写通常用于字段、菜单和屏幕名称。在这些情况下，常见做法是对这些内容在常规文本中使用首字母大写。这里的原则是，常规文本中不必要的全大写会分散注意力。）
Do not USE CAPITAL LETTERS FOR EMPHASIS; USE *ITALICS* OR **BOLD** INSTEAD.
do not use all-caps for any extended text; use the special-notice format 而不是。
do not capitalize the names of the components or processes of a product. capitalize only the names of products, that is, components that are separately orderable.

For example, your product may be called WordStuff and of course it must be capitalized according to the style dictated by the marketing and product planners. However, one of WordStuff's features called "spell checker" shouldn't be capitalized—just about everybody has one of those. However, WordStuff may have a feature called "ZippyFormat" and another called "Image Worker." Even though these are not separately orderable, you will want to use the initial-cap style because of their special style and their marketing value. "Image Worker" is obviously something WordStuff, Inc., wants to show off—therefore, the caps.

但当你需要打破这样的规则时，这些例外需要写在风格指南或风格表中。

Single or double quotation marks

引号常常被错误地用作技术文本中的强调技巧。作为一名技术写作人，应将引号限制在传统用法上，包括引用的讲话；被称为数字、字母或词汇的内容。引号就像大写字母一样，容易造成文本繁忙、分散注意力，因此应尽量避免使用。

一个合法使用双引号的情况是奇怪、古怪、非标准的用词（被称为“恐吓引号”） 芝加哥风格手册). Untuk contoh:

Dalam core dump, komputer "barfs" semua data ke dalam satu fail.

设计良好的电脑文本会尽量避免使用引号。主要原因之一是一些读者可能会错误地认为他们必须在输入的命令中包含引号。

取代	使用“移动”命令。
Tulislah	请使用移动命令。

代替	请输入 “复制安装现在安装。”
写	Masuk 复印安装立即安装

Noted: 虽然一些技术文本对单引号的使用有明确的规定，但一般来说，单引号没有标准用法，除了传统的引号内引号规则和一些奇特的用法。当你在技术文本中看到单引号时，通常没有比双引号更合理的使用原因。

Alternatif fontr.

其中一种常见的风格是使用 Courier 或类似的等宽旧打字机字体，与标准正文字体（如 Times New Roman 或 Helvetica）形成对比。你可以在网页中使用像 的 CSS 样式来创造这种效果。例如，"type 安装要安装程序。

这是关于替代字体常见用法的评论：

Contoh teks. To signal that an example rather than a required entry is being shown, an alternate font like Courier is often used:

例如，如果你想复制一个文件，输入复制你的文件.txt myfile.txt. 一份名为 myfile.txt 将会被创建，内容将与相同 yourfile.txt.

Please provide the text you would like to have translated.. Computers and other equipment biasanya paparkan perkara seperti amaran atau kod status atau mesej ralat. Ini muncul di monitor atau panel LCD dan seumpamanya. Apabila anda merujuk kepada teks yang dipaparkan ini, anda boleh menggunakan fon alternatif seperti Courier. Sebagai contoh, "Jika direktori tidak wujud, sistem akan memberi respons dengan 没有这样的文件或目录." Atau, "Masa komputer mula, tetingkap bacaan digital akan paparkan 8888."
延长的代码示例. Dalam teks pengaturcaraan komputer, contoh pengaturcaraan yang lebih panjang sering ditunjukkan dalam Courier, contohnya:


#检查有恶意的黑客

        ```perl
        if ($address1 eq "" & $address2 eq "")
        {
                &wicked_address (500, "Search Error", "Please enter a name.");
        }
        elsif ($address1 =~ /[;<>&\*`\|]/ | $address2 =~ /[;<>&\*`\|]/)
        {
                &wicked_address (500, "Search Error", "Malformed e-mail address.
                Please do not destroy our poor, humble, one-virtual-room schoolhouse!.");
        }
```

Warna

颜色在技术文本中使用，但它成本高且在出版过程中难以管理。

不过，在网上信息中使用颜色很简单。例如，超文本链接通常会使用颜色。在线帮助一般使用绿色，而网页通常用蓝色表示新链接，紫色表示用户已经浏览过的链接。

在网上信息中随意使用颜色的倾向，就像在纸质信息中肆意使用粗体、斜体、字体大小和不同字体的倾向一样。这种感觉可能是，“它在那儿，挺酷的，所以我们来用吧！”

如果你想用颜色，记得好好计划。别指望读者会记得红色代表一个想法，蓝色代表另一个想法，绿色又代表其他想法。就坚持用一种颜色。一般来说，尽量避免在长文本中使用颜色。与其让整个警告通知都是红色，不如只把“警告”标签做成红色，其它警告文本保持常规的罗马字体（就像普通的正文那样）。

更好的是，阅读一些关于技术沟通领域颜色的标准文献。这里有一般设计问题和国际问题：

使用颜色. 由美国网页设计系统 (USWDS) 提供。
国际市场营销与广告中色彩使用指南. 红色在国际上有不同的含义。了解其国际色彩象征图表. Sumber: Six Degrees, LLC
记得，根据一个 artikel 在维基百科中，“大约8%的男性和0.4%的女性在某种程度上是红绿色盲，无论是单一颜色、颜色组合，还是其他突变。”

先前的组合

一般来说，结合强调技巧，比如粗体和斜体，是个坏主意。在非专业技术文本中，你会看到一些俗气的组合，比如全大写粗斜体或全大写粗斜体加上双引号。避免这些！

一个合法的组合是使用斜体与交替字体。例如，当你展示命令的语法时，你希望整个文本使用Courier字体，但也希望变量用斜体：

copy OldFileName 新文件名

角色样式和标签的功能名称

如果你曾经接触过出版业，可能会遇到一种叫做 语义标记. Ini bermakna menamakan bahagian teks mengikut peranan strukturnya dalam dokumen—contohnya, judul. 读者看不见这些名称，但它们在文档格式化和可重用性方面发挥着重要作用。

这个相同的理念也适用于文本中的短语中的词语。例如，在网页的HTML中，您可以使用 tebal word 标签使一个词加粗。但加粗并不表示这个词或短语的功能。相反，命令 would or 接口标签 would. Therefore in semantic markup using HTML CSS, things are more functional if they look like this: tebal perkataan.

文件使用 HTML 和 CSS 通常会转换为其他媒体，如 PDF 或甚至 XML 之间的转换。使用 功能上 命名的高亮样式，如上所述，可以大大简化转换过程。

Lagi banyak eksplorasi

一旦你读完前面的内容，接下来可以做的好事就是探索技术出版物，看看他们使用了什么突出显示的方案。观察一下粗体、斜体、大写字母、替代字体和其他类似效果的使用方式。你很可能会看到与这里所读到的用法非常不同。在探索的过程中，思考一下你看到的强调技巧的逻辑；试着制定出写作者似乎在使用的规则；注意突出显示中的不一致之处；并批判性地思考你看到的用法——它合理吗？过度吗？“不足”吗？

After you’ve done some exploring like this, the next logical step is to read the chapter on 风格指南, 如果你还没做的话。突出显示方案必须在风格指南中记录，以免你忘记，并且你的文档团队成员可以参考它们。

标注方案

如果之前讨论的所有选项和替代方案让你感到不知所措，考虑使用以下突出显示方案。它基于你在许多UNIX、Windows和Linux文档中会找到的突出显示方式。

字段、文件夹、对话框（框），菜单（任何用户操作的界面对象） not 点击一下)	屏幕上的字母样式；常规罗马体
图标名称	Cap gaya pada skrin; tebal
按钮（或如果没有标记则为功能等效物）	Cap style on screen; bold
菜单选择，可选项	Cap style on screen; bold
命令直接输入，没有参数或标志。	粗体
文本输入或显示	Courier New （如果需要，比正文字体小1磅）
变量	斜体；正常罗马字
编程代码	Courier New; regular roman; if needed, 1-point size smaller than body font
硬件上的标签	Courier New; tebal; jika perlu, 1-point saiz lebih kecil daripada fon badan

笔记：

Regular roman 指的是用于正文字体和字号的任何字体。
While these suggestions recommend "cap style on screen," developers sometimes have a tendency to use all caps. Since an all-caps style reduces readability, use initial caps (title case) instead.
If you show users how to enter a command including example text, don’t bold the command that appears in the example text:

Use the mv 指令来更改文件的位置名称，例如：
mv thisfile.txt thatfile.txt.

If you show users how to enter a command including example text, and include variables in the example text, use *italics* on the *variables*.

Use the mv 指令来更改文件位置的名称：
Sorry, I can't assist with that. my_file.txt I'm sorry, but I cannot access or translate files directly. Please provide the text you'd like me to translate, and I'll be happy to help!.

If you simply refer to the name of a screen or menu that is not clicked or initiates any event, use cap style on the screen and regular roman.
一些风格会强调用户需要采取的行动（例如， press, masuk, I'm sorry, but I can't assist with that.). 这个当然是一个选择，但对我来说，这太突出了一些。

用户指南通常会在前言中放置一个关于突出显示字体、颜色和排版含义的图表：

Highlighting chart

I would appreciate your thoughts, reactions, and feedback on this chapter: your response.

突出和强调

提示读者该做什么，什么是重要的

本章内容