页面设计 means different things to different people, but here it will mean the use of typography and formatting like what you see in professionally designed documents.

我们这里的重点是技术文档,这意味着简约的、实用的设计。

为了获取比这里看到的更详细的信息,请参考这两个行业标准资源:

页眉和页脚

People often confuse headers with headings. Headings, covered in tajuk utama 那些短语正在出现吗 在身体区域内 的文档。标题是那些短语以及可能出现的页码 在标题区域内 的文件。页脚是出现在文档底部的短语以及可能的页码。 在页脚区域内 sebuah dokumen. Satu kesilapan biasa, dan besar juga, adalah meletakkan tajuk dokumen dalam kawasan header, yang menyebabkan ia muncul di bahagian atas setiap halaman berikutnya.

看看典型文档页面的图示:

Botom of preceding page; top of following page

一个常见的页面设计是在页脚区域放置文档标题和页码。采用交替格式时,左页可能会按顺序显示页码和文档标题;右页可能会按顺序显示文档标题和页码。

Tajuk

以下是关于标题的一些标准指导方针。如需更详细的讨论,请参阅相关章节。 tajuk utama 在在线教材中。

Senarai

Lists are useful tools for highlighting important points, making it easier to scan text quickly, and giving more white space. The following outlines some standard guidelines on lists. For a more detailed discussion, refer to the chapter on senarai.

通知

Notices adalah teks yang diformat khas untuk memberi amaran kepada pembaca tentang perkara khusus, pengecualian, masalah yang mungkin timbul, atau bahaya. Berikut adalah beberapa garis panduan standard untuk notis. Untuk perbincangan yang lebih terperinci, sila rujuk bab tentang 通知.

图表

图形是各种插图、绘画、示意图、照片等等。请看 grafik 为了进一步讨论。与此同时,这里有一些重要的要点:

表格

Table adalah seperti senarai menegak, yang telah dibincangkan sebelum ini, tetapi lebih terstruktur dan formal. Dalam teks anda, cari pasangan, triplet, atau quadruplet item yang berulang yang boleh diformat sebagai jadual. Sebagai contoh, satu siri istilah dan definisi adalah penggunaan klasik untuk jadual. Berikut adalah beberapa garis panduan standard untuk jadual. Untuk perbincangan yang lebih terperinci, lihat bab tentang tables.

突出显示

Software documentation typically uses a lot of highlighting. Highlighting here refers to bold, italics, alternate fonts, caps, quotation marks, and other such typographical tricks used to call attention to text. The following presents some standard guidelines for highlighting. For a more detailed discussion, see the chapter on 突出显示.

边距,缩进与对齐

如在标题部分所提到的,给文本缩进一到两寸,同时将标题留在左边缘是个不错的做法。这个风格有两个好处:一是让标题更突出,二是缩短了普通文本的行长。

字体与颜色

这里有一些关于字体和颜色的建议:

I would appreciate your thoughts, reactions, and criticism regarding this chapter: your response.