說明 > 列印與發行 > 針對 Web 與 HTML 發行 (Web/無線正在發行選項) > 發行適用於 HTML 說明的文件 (僅限 Windows)
  
發行適用於 HTML 說明的文件 (僅限 Windows)
先決條件:Arbortext Publishing EngineArbortext StylerWeb/Wireless Composer 選項,以及 HTML 說明 Workshop
您可以使用 Arbortext Editor 將 XML 文件轉換為 HTML 說明。檔案 > 發行 > 針對 HTML 說明選項會將文件分為獨立的 HTML 主題,然後再將它們合併為一個 .chm 檔案。依預設,Arbortext Editor 配置為以 Arbortext XML DocBook (axdocbook.dtd) 文件類型為基礎建立文件的 HTML 說明。若要根據其他 DTD 將文件發行為 HTML 說明,您可以與諮詢服務部門聯絡。
針對 HTML 說明選項將在發行選單中顯示,但在您安裝 Microsoft 的 HTML 說明 Workshop 之前,將無法使用該選項。 您可以從 Microsoft 的網站 http://www.microsoft.com 下載最新版本。請在 MSDN 物件庫中搜尋此下載,因為它可能不會被列為標準的下載選擇,此外,請務必安裝完整的 Workshop,而不是僅安裝檢視器。
您必須先啟動並關閉一次 HTML Help Workshop,才可以選擇檔案 > 發行 > 針對 HTML 說明
* 
如果文件包含圖形,則當您要在 HTML 輸出中設定圖形寬度和長度屬性時,必須以像素為單位進行指定。Web 瀏覽器無法轉譯不是以像素為單位指定的圖形寬度和長度屬性。
具有 TeX 輸入的方程式在 HTML 輸出中會顯示為空白方塊。
發行 HTML 說明形式的文件:
1. 若要發行 CJK 語言的 HTML 說明,您必須先將 Windows 地區設定和預設語言設定為所需語言。如需關於變更地區設定和語言的資訊,請參照您的 Windows 作業系統文件。
2. 選擇檔案 > 發行 > 針對 HTML 說明。會開啟針對 HTML 說明發行對話方塊。
3. 另存新檔欄位中指定您想要儲存 HTML 說明檔案的路徑和檔案名稱。按一下瀏覽以找到現有檔案。
4. 如果您想要文件在發行之後顯示在「HTML 說明檢視器」中,請選取檢視說明檔案選項。
* 
如果您選取檢視說明檔案選項,且您的文件檔案名稱包含與符號 (& 符號),Arbortext Editor 將會回應它無法啟動 HTML 說明檢視器。選取以在禁用檢視器的情況下發行,或選取以取消發行程序。
5. 樣式表清單中選取適當的樣式表。支援 web 發行的樣式表也適用於 HTML 說明。按一下瀏覽以查找未出現在清單中的現有樣式表。
如果您使用 Arbortext Publishing Engine 來發行文件,則清單會顯示 Arbortext Publishing Engine 伺服器中可用的樣式表。標記法 (pe) 會出現在樣式表名稱中。已略過本機樣式表,您無法將其中一個樣式表隨文件一併傳送至伺服器。
6. 如果您要發行與 DITAVAL 檔案相關聯的 DITA 文件,請在 DITAVAL 檔案清單中選擇該檔案。按一下瀏覽以找出未出現在清單中的現有 DITAVAL 檔案。
7. 如果文件包含變更追蹤,您可以在任何變更追蹤狀態下發行文件。依預設,除了從 DITA 圖 中發行以外,都會選取「編輯」視窗中的變更追蹤檢視。
如果您要發行 DITA 圖,依預設會選取應用的變更。當從 DITA 圖 發行時,所選取的變更追蹤檢視只會應用至從 DITA 圖 參照的主題。DITA 圖 本身以及其他參照的圖,將始終使用應用的變更發行,無論所選取的變更追蹤檢視為何 (即使圖有變更追蹤標示)。
選項有:
反白變更 - 顯示所有提議的變更 (以修訂標記反白)。
應用的變更 — 顯示併入文件內所有提議的變更 (不附加修訂標記)。
原始 - 顯示提議變更未併入文件時的原始文件。
8. 如果您選擇佇列交易,當您從工具選單的排入佇列的交易清單中擷取結果時,會提示您輸入另存新檔檔案名稱以及是否檢視說明檔案。選擇佇列交易會從對話方塊中清除另存新檔檢視說明檔案的值。如果您在這些欄位中輸入值,當您清除佇列交易核取方塊時,這些值會再顯示一次。
佇列交易行為是由一組 Arbortext Publishing Engine所控制。
9. 選擇是否輸入交易名稱。 當您從工具選單的排入佇列的交易清單中擷取結果時,將會顯示交易名稱。
您可以輸入預設要使用的交易名稱,或透過在排入佇列的交易名稱對話方塊中輸入值針對特定輸出類型輸入交易名稱。
10. 如果您要套用設定於您的文件,請按一下設定設定檔以存取設定設定檔對話方塊。按一下確定取消以退出設定設定檔對話方塊。唯有當所選文件類型的設定檔已經過配置時,設定設定檔按鈕才能使用。
11. 如果您要建立發行規則,請按一下建立規則來開啟建立新發行規則,您可以在其中建立新發行規則或規則集,以發行 HTML 說明。
12. 針對 HTML 說明發行對話方塊中按一下確定
發行至 HTML 說明時,請注意下列項目:
如果您使用 Arbortext Publishing Engine 來發行文件,則必須在 Arbortext Publishing Engine 伺服器上安裝 HTML 說明 Workshop。如果在傳回發行的 HTML 說明檔案時核取了檢視說明檔案Arbortext Editor 會將其顯示在本機 HTML 說明檢視器中。
Arbortext Editor 在發行處理期間會取代某些字元實體,因為它們顯示得不正確。取代字元實體在 Arbortext-path\composer\htmlHelpNavEntSub.xml 中定義。此檔案僅控制 HTML 說明導覽窗格的實體取代;它不支援 HTML 說明內容窗格的實體取代。
Arbortext Styler 支援三種可在 HTML 輸出中包含 CSS 資訊的方法。請參照 CSS files in HTML output 以瞭解更多資訊。
Microsoft 的 HTML 說明編譯器 (hhc.exe) 無法在路徑中包含以句點開頭的資料夾名稱的目錄中建立 .chm 檔案。如果您的 APTCACHE 環境變數指定擁有此類資料夾的目錄,則嘗試建立 .chm 檔案時,說明編譯器將失敗。因應措施是使用 APTCACHE 環境變數指定不包含以句點開頭的資料夾名稱的目錄。
HTML 說明 Workshop 有時在 Microsoft Windows 的目前版本中自行配置時會發生問題。安裝之後,您應該會在 Arbortext Styler 中看到選單選項「檔案」 > 「發行」 > 「針對 HTML 說明」。如果禁用該選項,則表示 Arbortext Styler 無法識別要用於 HTML 說明檔案的程式。
欲修復此問題,您可以將 *.hhp 檔案與 HTML 說明 Workshop 強制關聯:
1. 建立名為 "dummy.hhp" 的空白檔案。
2. 在 Windows 檔案總管中,連按兩下此檔案。您會收到 Windows 有關您要使用哪個程式開啟它的提示。選取 More programs 選項,然後導覽至 C:\Program Files (x86)\HTML Help Workshop,然後選取 hhw.exe。請確定已選取 Always use this program 選項。
3. 如果 Arbortext Styler 已開啟,請將其關閉並重新開啟。HTML 說明發行選項現已提供。