發行適用於 HTML 說明的文件 (僅限 Windows)
您可以使用 Arbortext Editor 將 XML 文件轉換為 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 輸出中設定圖形寬度和長度屬性時,必須以像素為單位進行指定。Web 瀏覽器無法轉譯不是以像素為單位指定的圖形寬度和長度屬性。
具有 TeX 輸入的方程式在 HTML 輸出中會顯示為空白方塊。
|
發行 HTML 說明形式的文件:
1. 若要發行 CJK 語言的 HTML 說明,您必須先將 Windows 地區設定和預設語言設定為所需語言。如需關於變更地區設定和語言的資訊,請參照您的 Windows 作業系統文件。
2. 選擇 > > 。會開啟針對 HTML 說明發行對話方塊。
3. 在另存新檔欄位中指定您想要儲存 HTML 說明檔案的路徑和檔案名稱。按一下瀏覽以找到現有檔案。
4. 如果您想要文件在發行之後顯示在「HTML 說明檢視器」中,請選取檢視說明檔案選項。
|
如果您選取檢視說明檔案選項,且您的文件檔案名稱包含與符號 (& 符號),Arbortext Editor 將會回應它無法啟動 HTML 說明檢視器。選取是以在禁用檢視器的情況下發行,或選取否以取消發行程序。
|
5. 從樣式表清單中選取適當的樣式表。支援 web 發行的樣式表也適用於 HTML 說明。按一下瀏覽以查找未出現在清單中的現有樣式表。
6. 如果您要發行與
DITAVAL 檔案相關聯的 DITA 文件,請在
DITAVAL 檔案清單中選擇該檔案。按一下
瀏覽以找出未出現在清單中的現有 DITAVAL 檔案。
7. 如果文件包含變更追蹤,您可以在任何變更追蹤狀態下發行文件。依預設,除了從 DITA 圖 中發行以外,都會選取「編輯」視窗中的變更追蹤檢視。
如果您要發行 DITA 圖,依預設會選取應用的變更。當從 DITA 圖 發行時,所選取的變更追蹤檢視只會應用至從 DITA 圖 參照的主題。DITA 圖 本身以及其他參照的圖,將始終使用應用的變更發行,無論所選取的變更追蹤檢視為何 (即使圖有變更追蹤標示)。
選項有:
◦ 反白變更 - 顯示所有提議的變更 (以修訂標記反白)。
◦ 應用的變更 — 顯示併入文件內所有提議的變更 (不附加修訂標記)。
◦ 原始 - 顯示提議變更未併入文件時的原始文件。
8. 如果您選擇佇列交易,當您從工具選單的排入佇列的交易清單中擷取結果時,會提示您輸入另存新檔檔案名稱以及是否檢視說明檔案。選擇佇列交易會從對話方塊中清除另存新檔與檢視說明檔案的值。如果您在這些欄位中輸入值,當您清除佇列交易核取方塊時,這些值會再顯示一次。
9. 選擇是否輸入交易名稱。 當您從工具選單的排入佇列的交易清單中擷取結果時,將會顯示交易名稱。
10. 如果您要
套用設定於您的文件,請按一下
設定設定檔以存取
設定設定檔對話方塊。按一下
確定或
取消以退出
設定設定檔對話方塊。唯有當所選文件類型的
設定檔已經過配置時,
設定設定檔按鈕才能使用。
11. 如果您要建立發行規則,請按一下建立規則來開啟建立新發行規則,您可以在其中建立新發行規則或規則集,以發行 HTML 說明。
12. 在針對 HTML 說明發行對話方塊中按一下確定。
發行至 HTML 說明時,請注意下列項目:
• Arbortext Editor 在發行處理期間會取代某些字元實體,因為它們顯示得不正確。取代字元實體在 Arbortext-path\composer\htmlHelpNavEntSub.xml 中定義。此檔案僅控制 HTML 說明導覽窗格的實體取代;它不支援 HTML 說明內容窗格的實體取代。
• Microsoft 的 HTML 說明編譯器 (hhc.exe) 無法在路徑中包含以句點開頭的資料夾名稱的目錄中建立 .chm 檔案。如果您的 APTCACHE 環境變數指定擁有此類資料夾的目錄,則嘗試建立 .chm 檔案時,說明編譯器將失敗。因應措施是使用 APTCACHE 環境變數指定不包含以句點開頭的資料夾名稱的目錄。
HTML 說明 Workshop 有時在 Microsoft Windows 的目前版本中自行配置時會發生問題。安裝之後,您應該會在 Arbortext Styler 中看到選單選項 > > 。如果禁用該選項,則表示 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 說明發行選項現已提供。