Documentation 0.1

Common Content

版 0

Dude McDude

My Org Best Div in the place

版權 © 2009 Red Hat, Inc.

法律聲明

Copyright © 2009 Red Hat, Inc.. This material may only be distributed subject to the terms and conditions set forth in the Open Publication License, V1.0, (the latest version is presently available at http://www.opencontent.org/openpub/).
Fedora and the Fedora Infinity Design logo are trademarks or registered trademarks of Red Hat, Inc., in the U.S. and other countries.
Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat Inc. in the United States and other countries.
All other trademarks and copyrights referred to are the property of their respective owners.
Documentation, as with software itself, may be subject to export control. Read about Fedora Project export controls at http://fedoraproject.org/wiki/Legal/Export.
(preface title goes here)
1. 文​件​常​規​
1.1. 排​字​上​的​常​規​
1.2. 引​述​常​規​
1.3. 註​解​和​警​告​
2. 我​們​需​要​您​的​意​見​！

(preface title goes here)

1. 文​件​常​規​

本​指​南​使​用​了​幾​種​常​規​來​強​調​特​定​文​字​與​詞​組​並​著​重​於​特​定​的​資​訊​。​
在 PDF 和​書​面​版​本​中​，本​指​南​使​用​了​來​自​於 Liberation Fonts 字​體​組​的 typefaces。​倘​若 Liberation Fonts 字​體​已​安​裝​在​您​系​統​上​的​話​，該​字​體​也​會​被​使​用​於 HTML 版​本​中​。​若​是​沒​有​的​話​，其​它​相​等​的 typefaces 便​會​被​顯​示​。​請​注​意​：就​預​設​值​來​講​，Red Hat Enterprise Linux 5（與​更​新​版​本​）已​包​含​了 Liberation Fonts 字​體​。​

1.1. 排​字​上​的​常​規​

有​四​種​被​用​來​強​調​特​定​文​字​與​詞​組​的​排​字​常​規​。​這​些​常​規​以​及​它​們​所​適​用​於​的​情​況​如​下​。​
固​定​粗​體​字​型​（Mono-spaced Bold）
用​來​強​調​系​統​輸​入​，包​括 shell 指​令​、​檔​案​名​稱​與​路​徑​。​同​時​也​被​使​用​來​強​調 key caps 與​按​鍵​組​合​。​例​如​：
若​要​查​看​位​於​您​目​前​工​作​目​錄​中​的 my_next_bestselling_novel 檔​案​的​話​，請​在 shell 提​示​中​輸​入 cat my_next_bestselling_novel 指​令​並​按​下 Enter 來​執​行​該​指​令​。​
以​上​包​含​了​一​個​檔​案​名​稱​、​shell 指​令​，以​及 key cap，並​且​全​部​以​固​定​粗​體​字​型​來​顯​示​。​
按​鍵​組​合​可​透​過 key caps 藉​由​連​字​符​號​連​接​按​鍵​組​合​鍵​來​辨​別​。​例​如​：
請​按​下 Enter 來​執​行​指​令​。​
請​按​下 Ctrl+Alt+F1 來​切​換​至​第​一​個​虛​擬​終​端​機​。​按​下 Ctrl+Alt+F7 來​返​回​您​的 X-Windows session。​
第​一​個​句​子​強​調​了​應​輸​入​的​特​定 key cap。​第​二​個​句​子​強​調​了​兩​組​含​有​三​個 key caps 的​組​合​，各​個​組​合​都​是​同​時​按​下​的​。​
若​原​始​碼​被​討​論​到​的​話​，某​段​落​中​所​提​及​的 class 名​稱​、​method、​functions、​variable 名​稱​與​回​傳​值​都​將​會​如​上​一​般​地​以 Mono-spaced Bold 顯​示​出​。​例​如​：
和​檔​案​相​關​的 class，其​中​包​含​了​filesystem（檔​案​系​統​）、​file（檔​案​）以​及 dir（目​錄​）。​各​個 class 都​有​和​它​關​聯​的​權​限​組​。​
Proportional Bold
這​代​表​在​系​統​上​所​會​看​見​的​文​字​或​詞​組​，這​包​含​了​應​用​程​式​名​稱​；對​話​方​塊​文​字​；被​標​記​的​按​鈕​；核​取​方​塊​與 radio button 標​籤​；選​單​標​題​以​及​子​選​單​標​題​。​例​如​：
由​主​選​單​選​取​系​統 > 偏​好​設​定 > 滑​鼠​ 來​啟​動​滑​鼠​偏​好​設​定​。​請​在​按​鈕​分​頁​中​點​選​左​手​操​作​滑​鼠​核​取​方​塊​並​按​下​關​閉​來​將​主​要​滑​鼠​按​鍵​由​左​邊​切​換​至​右​邊​（這​可​讓​滑​鼠​適​合​使​用​於​左​手​）。​
若​要​將​特​殊​字​元​插​入​一​個 gedit 檔​案​中​的​話​，請​由​主​選​單​中​選​擇​應​用​程​式 > 附​屬​應​用​程​式 > 字​元​對​應​表​。​接​下​來​，請​由​字​元​對​應​表​的​選​單​中​選​擇​搜​尋 > 尋​找​…，並​在​搜​尋​欄​位​中​輸​入​字​元​的​名​稱​然​後​按​下​下​一​個​。​您​所​選​擇​的​字​元​將​會​顯​示​於​字​元​表​中​。​在​被​選​定​的​字​元​上​點​兩​下​滑​鼠​左​鍵​便​可​將​它​放​置​在​準​備​複​製​的​文​字​欄​位​中​，接​下​來​請​按​下​旁​邊​的​複​製​按​鈕​。​現​在​，請​切​換​回​您​的​文​件​並​由 gedit 的​選​單​上​選​擇​編​輯 > 貼​上​。​
以​上​文​字​包​含​了​應​用​程​式​名​稱​；系​統​全​域​的​選​單​名​稱​與​項​目​；應​用​程​式​特​屬​的​選​單​名​稱​；以​及​在 GUI 介​面​中​所​看​到​的​按​鈕​與​文​字​全​部​都​以 Proportional Bold 來​顯​示​，並​且​可​透​過​內​文​來​辨​別​。​
請​注​意​： > 是​個​用​來​表​示​瀏​覽​至​某​個​選​單​以​及​它​的​子​選​單​的​縮​寫​。​這​是​為​了​避​免​像​是​「​由​主​選​單​的​系​統​選​單​中​的​偏​好​設​定​子​選​單​中​選​擇​滑​鼠​」​一​般​難​以​遵​循​的​方​式​。​
Mono-spaced Bold Italic（固​定​粗​體​斜​體​字​型​）或​是 Proportional Bold Italic（相​稱​粗​體​斜​體​字​型​）
無​論​是 Mono-spaced Bold 或​是 Proportional Bold，額​外​的​斜​體​字​型​便​表​示​可​替​換​或​是​變​數​文​字​。​斜​體​字​型​代​表​您​不​會​照​字​面​地​輸​入​的​文​字​或​是​會​依​照​情​況​而​改​變​的​文​字​。​比​方​說​：
若​要​透​過​使​用 ssh 來​連​至​一​部​遠​端​機​器​，請​在 shell 提​示​中​輸​入 ssh 用​戶​名​稱​@網​域​.名​稱​。​若​遠​端​機​器​為 example.com 而​您​在​該​機​器​上​的​用​戶​名​稱​為 john 的​話​，請​輸​入 ssh john@example.com。​
mount -o remount 檔​案​系​統​ 指​令​會​將 named 檔​案​系​統​重​新​掛​載​。​比​方​說​，若​要​重​新​掛​載 /home 檔​案​系​統​的​話​，該​指​令​就​會​是 mount -o remount /home。​
使​用 rpm -q 套​件​ 指​令​來​查​看​目​前​已​安​裝​套​件​的​版​本​。​系​統​將​會​回​傳​此​結​果​：套​件​發​行​版​本​。​
請​注​意​以​上​以​粗​體​斜​體​字​型​所​表​現​出​的​文​字 — 用​戶​名​稱​、​網​域​.名​稱​、​檔​案​系​統​、​套​件​以​及​發​行​版​本​。​各​個​文​字​都​是​個​佔​位​符​號​，這​可​代​表​您​提​供​一​項​指​令​時​所​輸​入​的​文​字​或​是​系​統​所​顯​示​的​文​字​。​
除​了​用​來​顯​示​一​項​作​業​標​題​這​樣​的​標​準​用​法​，斜​體​字​也​可​代​表​第​一​次​使​用​的​重​要​新​詞​彙​。​比​方​說​：
當 Apache HTTP Server 接​受​了​請​求​，它​便​會​派​遣​子​程​序​或​是​線​程​來​處​理​它​們​。​這​組​子​程​序​或​線​程​又​被​視​為 server-pool。​在 Apache HTTP Server 2.0 下​，建​立​與​維​護​這​些 server-pool 的​責​任​為​一​組​稱​為 多​重​處​理​模​組​（MPMs）的​模​組​所​屬​。​與​其​它​模​組​不​同​，MPM 群​組​中​只​有​一​個​模​組​可​被 Apache HTTP Server 載​入​。​

1.2. 引​述​常​規​

有​兩​種​（一​般​多​行​的​）資​料​類​型​會​在​圍​繞​它​的​文​字​中​被​強​調​出​。​
傳​送​至​終​端​機​的​輸​出​設​置​為 Mono-spaced Roman 並​且​以​此​方​式​顯​示​： 
books        Desktop   documentation  drafts  mss    photos   stuff  svn
books_tests  Desktop1  downloads      images  notes  scripts  svgs
原​始​碼​排​列​也​設​置​為 Mono-spaced Roman 不​過​會​被​以​下​列​方​式​顯​示​並​強​調​： 
package org.jboss.book.jca.ex1;

import javax.naming.InitialContext;

public class ExClient
{
   public static void main(String args[]) 
       throws Exception
   {
      InitialContext iniCtx = new InitialContext();
      Object         ref    = iniCtx.lookup("EchoBean");
      EchoHome       home   = (EchoHome) ref;
      Echo           echo   = home.create();

      System.out.println("Created Echo");

      System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
   }
   
}

1.3. 註​解​和​警​告​

最​後​，我​們​會​使​用​三​種​視​覺​上​的​形​式​來​強​調​可​能​會​被​漏​掉​的​資​訊​。​

Note（註​解​）

註​解​代​表​某​些​項​目​的​提​示​、​捷​徑​或​是​其​它​完​成​方​式​。​忽​略​註​解​並​不​會​有​太​大​的​影​響​，不​過​您​可​能​會​忽​略​掉​某​些​能​較​輕​鬆​完​成​工​作​的​方​式​。​

Important（重​點​）

重​點​方​塊​會​將​容​易​漏​掉​的​項​目​詳​細​列​出​：只​對​應​於​當​下 session 的​配​置​變​更​，或​是​某​些​要​套​用​更​新​前​必​須​將​之​重​新​啟​用​的​服​務​。​倘​若​您​忽​略​掉​重​點​方​塊​，雖​然​不​會​造​成​資​料​遺​失​，不​過​卻​會​造​成​工​作​上​的​不​便​和​其​它​影​響​。​

Warning（警​告​）

任​何​警​告​都​不​該​被​忽​略​掉​。​忽​略​警​告​的​話​很​有​可​能​會​造​成​資​料​上​的​遺​失​。​

2. 我​們​需​要​您​的​意​見​！

若​您​在​本​指​南​中​發​現​印​刷​上​的​錯​誤​，或​有​讓​本​指​南​改​進​的​方​式​，我​們​將​誠​摯​歡​迎​您​和​我​們​取​得​聯​繫​！請​在 Bugzilla 中​對​於 Documentation. 這​個​產​品​提​交​您​的​報​表​：http://bugzilla.redhat.com/bugzilla/。​
當​您​提​交​錯​誤​報​告​時​，請​務​必​提​供​指​南​的​識​別​碼​：Common_Content
若​您​擁​有​改​善​文​件​的​建​議​，請​儘​可​能​地​將​它​詳​細​描​述​清​楚​。​若​您​您​發​現​錯​誤​的​話​，請​包​含​區​段​編​號​以​及​該​錯​誤​周​圍​的​部​分​文​字​，如​此​一​來​我​們​便​能​輕​易​地​找​到​該​錯​誤​。​