Migrate doc to Hugo/AsciiDoctor

I'm very pleased to announce the release of
our new website and documentation using
the new toolchain with Hugo and AsciiDoctor.

To get more information about the new toolchain
please read the FreeBSD Documentation Project Primer[1],
Hugo docs[2] and AsciiDoctor docs[3].

Acknowledgment:
Benedict Reuschling <bcr@>
Glen Barber <gjb@>
Hiroki Sato <hrs@>
Li-Wen Hsu <lwhsu@>
Sean Chittenden <seanc@>
The FreeBSD Foundation

[1] https://docs.FreeBSD.org/en/books/fdp-primer/
[2] https://gohugo.io/documentation/
[3] https://docs.asciidoctor.org/home/

Approved by:    doceng, core

1 files changed, 620 insertions, 0 deletions

diff --git a/documentation/content/zh-tw/books/handbook/desktop/_index.adoc b/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
new file mode 100644
index 0000000000..6746fe8250
--- /dev/null
+++ b/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
@@ -0,0 +1,620 @@
+---
+title: 章 6. 桌面應用程式
+part: 部 II. 一般作業
+prev: books/handbook/partii
+next: books/handbook/multimedia
+---
+
+[[desktop]]
+= 桌面應用程式
+:doctype: book
+:toc: macro
+:toclevels: 1
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:source-highlighter: rouge
+:experimental:
+:skip-front-matter:
+:toc-title: 目录
+:table-caption: 表
+:figure-caption: 图
+:example-caption: 例 
+:xrefstyle: basic
+:relfileprefix: ../
+:outfilesuffix:
+:sectnumoffset: 6
+
+ifeval::["{backend}" == "html5"]
+:imagesdir: ../../../images/books/handbook/desktop/
+endif::[]
+
+ifeval::["{backend}" == "pdf"]
+:imagesdir: ../../../../static/images/books/handbook/desktop/
+endif::[]
+
+ifeval::["{backend}" == "epub3"]
+:imagesdir: ../../../../static/images/books/handbook/desktop/
+endif::[]
+
+include::shared/authors.adoc[]
+include::shared/releases.adoc[]
+include::shared/zh-tw/mailing-lists.adoc[]
+include::shared/zh-tw/urls.adoc[]
+include::shared/zh-tw/teams.adoc[]
+
+toc::[]
+
+[[desktop-synopsis]]
+== 概述
+
+隨著 FreeBSD 優越的效能及穩定性越來越熱門，它同時適合作為每日使用的桌面系統。FreeBSD 套件或 Port 有超過 24,000 個可用的應用程式，可以簡單的建立一個自訂的桌面環境來執行各種不同的桌面應用程式。本章將示範如何安裝數個桌面應用程式，包含網頁瀏覽器、辦工軟體、文件閱覽程式以及財務軟體。
+
+[NOTE]
+====
+比起重頭設定與編譯，較偏好使用 FreeBSD 桌面環境已預先編譯好版本的使用者可參考 http://www.trueos.org/[trueos.org 網站]。
+====
+
+在閱讀這章之前，你必須了解如何：
+
+* 使用套件或 Port 安裝其他軟體如 crossref:ports[ports,安裝應用程式：套件與 Port] 所敘述。
+* 安狀 X 與視窗管理程式如 crossref:x11[x11,X Window 系統] 所敘述。
+
+要取得有關如何設定多媒體環境的資訊，請參考 crossref:multimedia[multimedia,多媒體]。
+
+[[desktop-browsers]]
+== 瀏覽器
+
+在 FreeBSD 中並未預先安裝好網頁瀏覽器。 但在 Port 套件集中的 https://www.FreeBSD.org/ports/[www] 分類中有許多瀏覽器可以採 Binary 套件安裝或自 Port 套件集編譯的方式安裝。
+
+KDE 和 GNOME 桌面環境都有提供自有的 HTML 瀏覽器。請參考 crossref:x11[x11-wm,桌面環境] 來了解更多有關如何設定完整桌面環境的資訊。
+
+有一些輕量化的瀏覽器可使用，包含 package:www/dillo2[], package:www/links[] 以及 package:www/w3m[]。
+
+本章節將示範如何安裝下列常見的網頁瀏覽器並說明該應用程式是否需要用到大量資源、花費大量時間自 Port 編譯或何主要的相依套件。
+
+[.informaltable]
+[cols="1,1,1,1", frame="none", options="header"]
+|===
+| 應用程式名稱
+| 所需資源
+| 自 Port 安裝時間
+| 說明
+
+|Firefox
+|中
+|多
+|有 FreeBSD 、 Linux(TM) 及在地化版本
+
+|Opera
+|少
+|少
+|有 FreeBSD 、 Linux(TM) 版本
+
+|Konqueror
+|中
+|多
+|需要 KDE 程式庫
+
+|Chromium
+|中
+|多
+|需要 Gtk+ 程式庫
+|===
+
+=== Firefox
+
+Firefox 是一套開放源始碼的瀏覽器，它具備符合 HTML 標準的顯示引擎、頁籤瀏覽、彈出視窗封鎖、擴充套件、強化安全性及其他更多功能。Firefox 的基礎使用了 Mozilla 的程式庫。
+
+要安裝最新釋出版本的 Firefox 套件可輸入：
+
+[source,bash]
+....
+# pkg install firefox
+....
+
+要安裝延長支援發佈 (Extended Support Release, ESR) 版本的 Firefox，可使用：
+
+[source,bash]
+....
+# pkg install firefox-esr
+....
+
+在地化的版本可在 package:www/firefox-i18n[] 及 package:www/firefox-esr-i18n[] 取得。
+
+使用 Port 套件地可以用原始碼編譯成您想要的 Firefox 版本。此範例編譯 package:www/firefox[]，其中 `firefox` 可替換為 ESR 或在地化版本來安裝。
+
+[source,bash]
+....
+# cd /usr/ports/www/firefox
+# make install clean
+....
+
+=== Opera
+
+Opera 是個具備完整功能、符合標準且輕量、執行速度快的瀏覽器。 它同時也具備了內建的郵件、新聞閱讀器、IRC 客戶端、RSS/Atom 來源閱讀器等。 可用的版本有兩種原生的 FreeBSD 版本及 Linux(TM) 模擬模式下執行的版本。
+
+以下指令可安裝 FreeBSD Binary 套件版本的 Opera，替換 `opera` 為 `linux-opera` 則可改安裝 Linux(TM) 版本。
+
+[source,bash]
+....
+# pkg install opera
+....
+
+或者，可安裝 Port 套件集中的版本，以下範例會編譯原生的版本：
+
+[source,bash]
+....
+# cd /usr/ports/www/opera
+# make install clean
+....
+
+要安裝 Linux(TM) 則替換 `opera` 為 `linux-opera`。
+
+要安裝 Adobe(TM)Flash(TM) 附加元件，需先編譯 package:www/linux-flashplayer[] Port，因受到授權條款限制無法事先編譯為 Binary 套件。然後再安裝 package:www/opera-linuxplugins[]。以下範例示範如何編譯 Port 中的這兩個應用程式：
+
+[source,bash]
+....
+# cd /usr/ports/www/linux-flashplayer
+# make install clean
+# cd /usr/ports/www/opera-linuxplugins
+# make install clean
+....
+
+安裝完成後，開啟瀏覽器檢查附加元件是否存在，在網址列輸入 `opera:plugins` 並按下 kbd:[Enter] 鍵，便會有清單顯示目前可用的附加元件。
+
+若要安裝 Java(TM) 附加元件請接著安裝 package:java/icedtea-web[]。
+
+=== Konqueror
+
+Konqueror 不只是個網頁瀏覽器， 它同時也是檔案管理器和多媒體瀏覽器。它包含在 package:x11/kde4-baseapps[] 套件或 Port 中。
+
+Konqueror 使用支援 WebKit 以及它自有的 KTHML。WebKit 是一套被許多現代瀏覽器所使用的繪圖引擎，包含 Chromium。要在 FreeBSD 的 Konqueror 使用 WebKit 需安裝 package:www/kwebkitpart[] 套件或 Port。此範例示範使用 Binary 套件安裝：
+
+[source,bash]
+....
+# pkg install kwebkitpart
+....
+
+從 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/www/kwebkitpart
+# make install clean
+....
+
+要啟動 Konqueror 中的 WebKit 點選 "Settings"、"Configure Konqueror"。在 "General" 設定頁面內點選 "Default web browser engine" 旁的下拉示選單並變更 "KHTML" 為 "WebKit"。
+
+Konqueror 也支援 Flash(TM)，"如何"在 Konqueror 上安裝 Flash(TM) 的說明可參考 http://freebsd.kde.org/howtos/konqueror-flash.php[http://freebsd.kde.org/howtos/konqueror-flash.php]。
+
+=== Chromium
+
+Chromium 是一個開放源始碼的瀏覽器計劃，該計劃的目標是要建立一個安全、快速且更穩定的網頁瀏覽體驗。Chromium 的功能有頁籤式瀏覽、彈出視窗封鎖、擴充套件等等。
+
+Chromium 可以使用套件來安裝，只要輸入：
+
+[source,bash]
+....
+# pkg install chromium
+....
+
+或者可從 Port 套件集的原始碼編譯 Chromium：
+
+[source,bash]
+....
+# cd /usr/ports/www/chromium
+# make install clean
+....
+
+[NOTE]
+====
+Chromium 的執行檔為 [.filename]#/usr/local/bin/chrome#，並非 [.filename]#/usr/local/bin/chromium#。
+====
+
+[[desktop-productivity]]
+== 辦工工具
+
+當開始進行辦公，使用者通常會找好用的辦公軟體或是好上手的文書處理程式。 雖然有些 crossref:x11[x11-wm,桌面環境] 像是 KDE 已經提供了辦公軟體，但並沒有預設的辦公軟體，FreeBSD 提供多套辦公軟體以及圖型化文書處理程式，不論您用那種的視窗管理程式都能使用。
+
+本章節元範如何安裝以下熱門的辦公軟體以及說明該應用程式所需的資源、自 Port 編譯的時間或者是否有其他主要相依套件。
+
+[.informaltable]
+[cols="1,1,1,1", frame="none", options="header"]
+|===
+| 應用程式名稱
+| 所需資源
+| 自 Port 安裝時間
+| 主要相依套件
+
+|Calligra
+|少
+|多
+|KDE
+
+|AbiWord
+|少
+|少
+|Gtk+ 或 GNOME
+
+|The Gimp
+|少
+|多
+|Gtk+
+
+|Apache OpenOffice
+|多
+|非常多
+|JDK(TM) 及 Mozilla
+
+|LibreOffice
+|有點多
+|非常多
+|Gtk+ 或 KDE/ GNOME 或 JDK(TM)
+|===
+
+=== Calligra
+
+KDE 桌面環境中內含辦公軟體可以與 KDE 分開安裝。Calligra 中也有可在其他辦公軟體中找到的標準元件，如 Words 是文件處理程式、Sheets 是試算表程式、Stage 可管理投影片以及 Karbon 用來繪製圖型文件。
+
+在 FreeBSD 中 package:editors/calligra[] 可以使用套件或 Port 的方式安裝，要使用套件安裝：
+
+[source,bash]
+....
+# pkg install calligra
+....
+
+若沒有可用的套件，可改使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/editors/calligra
+# make install clean
+....
+
+=== AbiWord
+
+AbiWord 是一個免費的文件處理軟體，外觀和感覺都近似於 Microsoft(TM) Word。 它非常快速，包含了許多功能而且非常容易上手。
+
+AbiWord 可以輸入或輸出許多檔案格式， 包括一些有專用的格式，例如 Microsoft(TM) [.filename]#.rtf# 格式。
+
+要安裝 AbiWord Binary 套件，可使用下列指令：
+
+[source,bash]
+....
+# pkg install abiword
+....
+
+若沒有 Binary 套件版本，也可以從 Port 套件集中編譯安裝：
+
+[source,bash]
+....
+# cd /usr/ports/editors/abiword
+# make install clean
+....
+
+=== The GIMP
+
+對於影像的編輯及修改來說，The GIMP 是非常精緻的影像處理軟體。 它可以當作簡單的繪圖軟體或是高品質的相片處理軟體。 它支援為數眾多的外掛程式及指令稿 (script-fu) 介面。 The GIMP 可以讀寫許多檔案格式。 它也支援掃描器和手寫板。
+
+要安裝套件可：
+
+[source,bash]
+....
+# pkg install gimp
+....
+
+或使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/graphics/gimp
+# make install clean
+....
+
+在 Port 套件集的 graphics 分類 (https://www.FreeBSD.org/ports/[freebsd.org/ports/]) 下也包含了許多 GIMP 相關的附加元件，說明檔及使用手冊。
+
+=== Apache OpenOffice
+
+Apache OpenOffice 是開放原始碼的辦工室軟體，由 Apache Software Foundation's Incubator 底下的團隊所開發。 它包含了所有完整的辦公軟體組合： 文字處理器、試算表、簡報軟體還有繪圖軟體。 除了它的使用者介面非常類似其他的辦公軟體， 他還能夠輸入和輸出許多熱門的檔案格式。 它也包含了不同語言的使用者介面、拼字檢查和字典。
+
+Apache OpenOffice 的文字處理器使用原生的 XML 檔案格式來增加移植性及彈性。 試算表程式支援巨集 (Macro) 功能而且能夠使用外來的資料庫介面。 Apache OpenOffice 已經十分穩定， 並且能夠在 Windows(TM), Solaris(TM), Linux(TM), FreeBSD 及 Mac OS(TM) X 等作業系統上面執行。 想知道更多關於 Apache OpenOffice 的資訊可以在 http://openoffice.org/[openoffice.org] 網頁上查詢。在 FreeBSD 特定的資訊可參考 http://porting.openoffice.org/freebsd/[porting.openoffice.org/freebsd/]。
+
+要安裝 Apache OpenOffice 套件：
+
+[source,bash]
+....
+# pkg install apache-openoffice
+....
+
+當套件安裝完成之後，只要輸入下面的指令就能執行 Apache OpenOffice：
+
+[source,bash]
+....
+% openoffice-X.Y.Z
+....
+
+其中 _X.Y.Z_ 是已安裝的 Apache OpenOffice 的版本編號。第一次執行 Apache OpenOffice 會詢問一些問題且會在使用者的家目錄建立一個 [.filename]#.openoffice.org# 資料夾。
+
+若無法由套件取得想要的 Apache OpenOffice，仍可選擇從 Port 編譯。 不過必須注意：編譯的過程會需要大量的磁碟空間與時間：
+
+[source,bash]
+....
+# cd /usr/ports/editors/openoffice-4
+# make install clean
+....
+
+[NOTE]
+====
+如果想要編譯在地化的版本，將前面的指令替換成為：
+
+[source,bash]
+....
+# make LOCALIZED_LANG=your_language install clean
+....
+
+替換 _your_language_ 為正確的語言 ISO 編碼。支援的語言編碼清單在 [.filename]#files/Makefile.localized#，位於該 Port 的目錄。
+====
+
+=== LibreOffice
+
+LibreOffice 是一套自由的辦公軟體由 http://www.documentfoundation.org/[documentfoundation.org] 所開發。它可相容其他主流的辦公軟體以及可在各種平台上使用。它是 Apache OpenOffice 品牌重塑後的分支，含有可在完整辦公生產力軟體中找到的應用程式：文件處理程式、試算表、簡報管理程式、繪圖程式、資料庫管理程式以及建立與編輯數學公式的工具。它也支援數種語言與國際化一直延伸到介面、拼字檢查程式與字典。
+
+LibreOffice 的文件處理程式使用了原生的 XML 檔案格式來增加可攜性與彈性，試算表程式支援可與外部資料庫連接的巨集語言。LibreOffice 非常穩定且可直接在 Windows(TM), Linux(TM), FreeBSD 以及 Mac OS(TM) X 上執行。更多有關 LibreOffice 的資訊可在 http://www.libreoffice.org/[libreoffice.org] 找到。
+
+要安裝英文版本的 LibreOffice 套件：
+
+[source,bash]
+....
+# pkg install libreoffice
+....
+
+Port 套件集的編輯器分類 (https://www.FreeBSD.org/ports/[freebsd.org/ports/]) 中含有數個 LibreOffice 的語系。安裝在地化套件時，請替換 `libreoffice` 為在地化套件的名稱。
+
+套件安裝之後，輸入以下指令來執行 LibreOffice：
+
+[source,bash]
+....
+% libreoffice
+....
+
+第一次啟動的過程中會詢問一些問題並在使用者的家目錄建立 [.filename]#.libreoffice# 資料夾。
+
+若找不到想使用的 LibreOffice 套件，也可從 Port 編譯，但這會要大量的磁碟空間及漫長的時間編譯。以下例子示範編譯英文版本：
+
+[source,bash]
+....
+# cd /usr/ports/editors/libreoffice
+# make install clean
+....
+
+[NOTE]
+====
+要編譯在地化版本，則需 `cd` 進入想要的語言 Port 目錄。支援的語言可在 Port 套件集的編輯器分類 (https://www.FreeBSD.org/ports/[freebsd.org/ports/]) 中找到。
+====
+
+[[desktop-viewers]]
+== 文件閱覽程式
+
+UNIX(TM) 出現之後，有一些新的文件格式才越來越熱門，這些文件所需的檢視程式可能並不在基礎系統中。本節將示範如何安裝以下文件檢視程式：
+
+[.informaltable]
+[cols="1,1,1,1", frame="none", options="header"]
+|===
+| 應用程式名稱
+| 所需資源
+| 自 Port 安裝時間
+| 主要相依套件
+
+|Xpdf
+|少
+|少
+|FreeType
+
+|gv
+|少
+|少
+|Xaw3d
+
+|Geeqie
+|少
+|少
+|Gtk+ 或 GNOME
+
+|ePDFView
+|少
+|少
+|Gtk+
+
+|Okular
+|少
+|多
+|KDE
+|===
+
+=== Xpdf
+
+如果你想要一個小型的 FreeBSD PDF 閱覽軟體， Xpdf 是個輕量級而且有效率的閱覽器。 它只需要非常少的資源而且十分穩定。 它只使用標準的 X 字型且不需要額外的工具包(Toolkit)。
+
+安裝 Xpdf 套件：
+
+[source,bash]
+....
+# pkg install xpdf
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/graphics/xpdf
+# make install clean
+....
+
+完成安裝後，執行 `xpdf` 並使用滑鼠右鍵開啟選單。
+
+=== gv
+
+gv 是 PostScript(TM) 和 PDF 的閱覽器。 它建構於 ghostview 的基礎上，不過因為使用 Xaw3d 視窗元件工具包，所以外觀看起來比較漂亮。 gv 有許多可設定的功能，比如說紙張方向、紙張大小、縮放比例、和反鋸齒(Anti-aliasing)等。 而且幾乎所有的使用都可以從鍵盤或滑鼠來完成。
+
+安裝 gv 套件：
+
+[source,bash]
+....
+# pkg install gv
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/print/gv
+# make install clean
+....
+
+=== Geeqie
+
+Geeqie 是由已經停止維護的 GQView 專案所衍伸出來的分支，並致力開發新功能並整合已有的修補。Geeqie 是一套影像管理軟體，支援單鍵閱覽檔案、啟動外部編輯器、縮圖預覽等功能。 它也有幻燈片模式及一些基本的檔案操作的功能，能輕鬆的管理大量影像並找出重複的檔案。 Geeqie 也支援使用全螢幕閱覽以及國際化。
+
+安裝 Geeqie 套件：
+
+[source,bash]
+....
+# pkg install geeqie
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/graphics/geeqie
+# make install clean
+....
+
+=== ePDFView
+
+ePDFView 是一套小巧的 PDF 文件檢視程式，只使用了 Gtk+ 與 Poppler 程式庫。它目前還在開發當中，但已經可以開啟大部份 PDF 檔案 (甚至是加密過的)、儲存文件複本以及支援使用 CUPS 來列印。
+
+要以套件安裝 ePDFView：
+
+[source,bash]
+....
+# pkg install epdfview
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/graphics/epdfview
+# make install clean
+....
+
+=== Okular
+
+Okular 是一套通用的文件檢視程式，以 KDE 的 KPDF 為基礎。它可以開啟許多種文件格式，包含了 PDF, PostScript(TM), DjVu, CHM, XPS 以及 ePub。
+
+要以套件安裝 Okular：
+
+[source,bash]
+....
+# pkg install okular
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/graphics/okular
+# make install clean
+....
+
+[[desktop-finance]]
+== 財務
+
+如果有任何理由你想要在你的 FreeBSD 桌面環境上管理你的個人財務， 這裡有一些功能強大、使用簡單的應用程式可供安裝。 這些財務管理軟體之中有些是相容於流行的 Quicken 或 Excel 文件。
+
+這節涵蓋了下面這些軟體：
+
+[.informaltable]
+[cols="1,1,1,1", frame="none", options="header"]
+|===
+| 應用程式名稱
+| 所需資源
+| 自 Port 安裝時間
+| 主要相依套件
+
+|GnuCash
+|少
+|多
+|GNOME
+
+|Gnumeric
+|少
+|多
+|GNOME
+
+|KMyMoney
+|少
+|多
+|KDE
+|===
+
+=== GnuCash
+
+GnuCash 是 GNOME 團隊努力成果中的一部分， GNOME 團隊主要提供親切而強大的桌面應用程式給終端使用者。使用 GnuCash 可以持續追蹤收入與花費、銀行帳戶以及股票證券等。 它的特性是介面直覺但功能仍非常專業。
+
+GnuCash 提供了智慧的計數器、多階層帳戶系統以及快速鍵及自動完成功能。 它也能分開單一的報表至數個詳細的部份。 GnuCash 也能夠匯入及合併 Quicken QIF 檔案。 它也能處理大部分國際的日期及通用貨幣之格式。
+
+安裝 GnuCash 套件：
+
+[source,bash]
+....
+# pkg install gnucash
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/finance/gnucash
+# make install clean
+....
+
+=== Gnumeric
+
+Gnumeric 是 GNOME 社群所開發的試算表程式。 它的特點是擁有能夠根據儲存格格式 「猜出」使用者的輸入來自動補齊的系統。 它也能夠匯入許多熱門的檔案格式，像是 Excel, Lotus 1-2-3 以及 Quattro Pro。 它有大量內建的函數而且能夠使用常用的儲存格格式，像是：數字、貨幣、日期、時間及其他格式等。
+
+安裝 Gnumeric 套件：
+
+[source,bash]
+....
+# pkg install gnumeric
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/math/gnumeric
+# make install clean
+....
+
+=== KMyMoney
+
+KMyMoney 是一套個人財務應用程式，由 KDE 社群所開發。KMyMoney 的目標是提供可在商業個人財務管理應用程式中找到的重要功能，它也強調簡單易用及其功能間採用合適的複式記帳。KMyMoney 可從標準 Quicken QIF 檔案匯入資料、追蹤投資、處理多種貨幣並提供財務報表。
+
+要以套件安裝 KMyMoney：
+
+[source,bash]
+....
+# pkg install kmymoney-kde4
+....
+
+若沒有可用的套件版本，可使用 Port 套件集安裝：
+
+[source,bash]
+....
+# cd /usr/ports/finance/kmymoney-kde4
+# make install clean
+....