關於Xcode中的文檔偏好設置

對於一門新的技術和語言，咱們在整個學習和使用過程當中，獲取相關信息最主要和最權威的來源即是其官方放出的文檔。由於這是第一手的學習資料，文檔結構，內容組織方式，術語和規範都是基於如何讓他人以最快最省力的方式掌握來進行設計安排的，隨着技術和語言版本的不斷升級，其文檔也會隨之作出響應的調整更新，以保證信息的同步性和正確性。正確的運用官方文檔來學習和使用一門技術和語言，進而培養成我的的一種學習習慣，能夠保證咱們在學習的過程當中不至於迷失和困惑。

在IOS的開發過程當中，Xcode可謂是一款很是不錯的開發工具，我的比較喜歡的是其將開發者文檔與其IDE作了很好的綁定，而且在文檔中提供了許多Demo來幫助咱們學習和掌握其開發用到的知識點。關於文檔工具的使用方式不是文本的重點，由於每一個使用過Xcode的開發者基本上都會迅速的掌握文檔的使用和查詢方式。本篇簡單介紹一下Xcode中關於文檔偏好設置的一些內容。

1. 打開文檔偏好設置面板

點中Xcode，在頂部菜單欄中，選擇「Xcode」->"Preferences..."彈出偏好設置面板，在面板中選擇"Downloads"一欄，並切換至「Documention」中，該欄即是文檔偏好設置的面板。

2. 偏好面板的一些概念

Xcode中的文檔是以一種文檔集合方式來組織的。全部在內容和版本上相關的文檔都被打包成一個集合添加至Xcode中。這些集合最終出如今Orgnizer中的Documentation一欄的左側面板中，並以相同的列表 形式組織。例如「iOS 5.1 Kibrary」 ，「iOS6.0 Documentation Set」等等。咱們在勾選「Check for and install updates automatically」一項以後，Xcode能夠幫助自動檢測和更新文檔的內 容，開發者也能夠本身經過點擊「Check and Install Now」按鈕來手動更新文檔集合。

3. 安裝其它來源的文檔

默認狀況下Xcode會綁定相關SDK的文檔，但同時容許咱們以RSS方式安裝不一樣來源的文檔。咱們以github中的開源項目BlocksKit爲例簡要說明下。

進入BlocksKit的github頁面，其README.md描述中給出了項目文檔的RSS地址，右鍵「複製連接地址」。

返回Xcode的文檔偏好設置面板中，點擊「+」按鈕。

在彈出的input框中，將剛纔複製的地址粘貼到裏面，以後點擊「Add」按鈕。這時列表中會添加新的一項文檔集合項，點擊右側的「install」按鈕，以後會自動同步其文檔至本地。

安裝成功後，在organizer的Documentation中能夠查看到新增的文檔內容

返回文檔偏好設置面板將下面的面板向上拖追，展開文檔的說明信息，其中有一個「Installed Location:」地址，這即是該文檔集合的本地安裝路徑，點擊該地址。

如下是該目錄下的內容，毫無疑問，Xcode中的其它全部已安裝文檔也包含在這個目錄中。

4.刪除指定的文檔集 有添加文檔集合的操做，就會有對應的刪除操做。在文檔偏好設置面板中「+」的右側的「—」按鈕即用來完成次刪除操做。以刪除剛纔安裝的BlocksKit的文檔爲例。在面板中選中該文檔集合列表項目，點擊「—」按鈕。

注意的是，第一次刪除該RSS地址仍存在列表項中，狀態是待安裝，要完全清除，須要再次重複上一步操做。

5. 設置organizer文本最小字體大小

在文檔偏好設置面板的下面，有一個不起眼的「Never use font sizes smaller than:」設置選項，該選項來來設置organizer中文檔字體大小的最小值。勾選該 選項，在彈出的pop-up中選擇最小字體值，選擇完畢後，organizer中的文檔內容的字體大小會立刻發生變化，開發者能夠根據本身的須要調整適合本身的文字大小。