mozilla 標籤使用參考文件

這份文件描述 mozilla.org 中使用標籤的語意及習慣，讓文件能套用本站 CSS 樣式－不用寫一行 CSS 規則，便可以使文件看起來與本站結為一體。

站上的樣式有個原則－需用者用。如果你的文章看起來不須要強調樣式，那麼也不必看這份文件；不過如果你想為文件加上 CSS 來點綴，就先看一下這篇－搞不好我們早就提供你需要的樣式了。如果我們沒提供，也可能是因為沒必要，若對樣式有所建議，可以在討論區發言。

一般結構

段落 <p> 及 <div class="para">

請用 <p> 來標示段落，也就是「含括」一段文字，而非用以分隔兩段。

<div class="para"> 則可用於一些特例：在 HTML DTD 中規定，有些區段性元素不能放在 <p> 裡頭。舉例而言，您可能會想將 <blockquote> 擺在一個段落中間，這麼一來分開來的兩段皆需獨立成為一個段落，有各自成對的 <p>；整段（兩組<p> 跟一組 <blockquote>）外圍並以 <div class="para"> 標示。請別因為想讓同軸 (inline) 的圖片以區段元素方式呈現，就以 div標示起來－ <img> 可以放在 <p> 裡頭，而且就算是 NS 4.x 也會當它為區塊元素。

(範例不翻)

小節 <div class="section">

用 <div class="section"> 標示文件中的小節，請記得同時包覆標題及內文。小節通常較其他文字縮排。

資料表格 <table class="data">

若某 HTML 表格為資料表格，請使用此樣式類別以便加上色彩及邊框樣式。（由於 mozilla.org 文件中尚有許多排版用表格，所以沒辦法直接定義表格的樣式。）如果您想加上隔行的背景換色效果，請在 <tr> 元素中加上 even 或 odd 類別，而不要又自己設定一個。

引用

整段引用: <blockquote> 加上 <address>

以此引用整段或其他區塊級 (block-level) 內容，註明出處時可於結束標籤前放上 <address>。

少量引言: <div class="quote"> 加上 <q> 及 <cite>

以此引用短句或其他不足以採用 blockquote 的內容，其中引用句以 <q> 標示，隨後可加上 <cite> 註明出處。

章節題詞: <blockquote class="epigraph"> 或 <div class="epigraph">

章節題詞通常是格言名句，放在一個章節的最前頭以明示主題。依據前述原則選用 <blockquote class="epigraph"> 或 <div class="epigraph">。

各式註記

草稿標註: <div class="remark"> 或 <span class="remark">

以此標示某草稿中作者／編者的附註，亦可標示程式碼中的註解。不要加上方括號，套用樣式表時會自動加上去。

一般註記: &ltspan class="note">、&ltp class="note"> 或 &ltdiv class="note">

以此標示一般註記，樣式表會自動在前面加上「Note:」字樣並套用字型、色彩等樣式。

所以 moztw 樣式表裡的 Note: 應該翻為「註:」 ? --BobChao 02:20, 24 May 2005 (CST)

補充說明: <div class="sidenote">

以此標註與本文無直接相關的額外資訊（或連結），使其獨立於文件一般排版而自成一區。雖然這些補充資訊通常會浮 (float) 至邊欄，但請確保文字在未浮動的情形下依然合理可閱，故最多僅能為此區加上不同背景色或邊框。（或者什麼也不加，如 Lynx。）

要點: <div class="key-point">

以此標示關鍵要點，使其顯眼易見。（如果是極重要資訊請標以 important 。）

重要（必讀）說明: <* class="important">

以此標示極重要、必閱資訊。通常 important 會用比較大點的字，或許再加上更顯眼的顏色。可讓文字再以 <strong> 標示。

Mozilla Taiwan (MozTW)

舊文件

Views

MozTW 標籤使用指南

出自 MozTW Wiki

mozilla 標籤使用參考文件

個人工具

本站導覽：

搜尋

工具: