2008-12-29 65 views
19

看來CHM幫助文件不再是選擇的幫助文件格式。幫助文件格式的未來方向

的WinHelp
- 過時

HTML幫助(CHM)
- 默認情況下不
支持Vista的 - 沒有網絡共享

幫助2(HXS)
很好地工作 - 我明白這是用於VS2005 +顯示幫助

基於網絡
- 可能很難以管理多個版本

什麼幫助文件格式,你會用在一個新的(C#)應用程序,從一個代碼庫提供多個版本?

我們想用CHM幫助但它不似乎是,微軟希望我們能夠在移動。

有誰採用HXS對自己的幫助文件的方向是什麼?

留言反饋理解基於lassevk評論


更新;

看起來好像HXS幫助不打算用於普通幫助項目。


回答

4
this.Mode = Modes.Rant; 

有幾乎所有的幫助文件格式巨大的問題,因爲製造商(通常是微軟爲不少人的)似乎並不想做的工作不僅僅是略有足夠自己使用。

我不能告訴你在第三方集成時,新的HXS格式有多少次完全消除了我的Visual Studio幫助。你可以說這是第三方安裝工具的缺陷,但是在相當一段時間裏有沒有關於如何做到這一點的文檔,所以他們必須在反向工程之間進行選擇(並且有時會使它錯誤)完全整合。我仍然不知道集成是否可行,但是現在我只需切換Visual Studio即可使用聯機幫助。它只是起作用,而大多數情況下,內置的幫助總是落在那個只關閉Visual Studio直到重建了幫助文件的進度條上,除非它不是因爲這些文件現在已經損壞了,所以任何時候我點擊F1,除非我殺死DEXPLORE程序多次,Visual Studio纔會鎖定。

這是如何結束爲解決任何問題,我仍然不知道。

其次,工具需要存在。 CHM瀏覽器在Vista之前,而不是在Vista上,但是展示HXS所需的工具並沒有出現在Vista之前,但我認爲它們在Vista上。不錯,所以現在我可以選擇使用一種需要在用戶計算機上自定義安裝的格式,或者......另一種需要在其他用戶計算機上自定義安裝的格式。對。

this.Mode = Modes.JustTicked; 

我在哪裏工作,我們的船CHM文件,並基於文件的HTML版本,對於那些通過網絡共享部署他們的應用程序。至於Vista,我們還沒有看到太多,但是html版本也可以在那裏工作。

我寧願有一個閃亮的幫助文件雖然。

html版本的一個不錯的結果是我們可以鏈接到跟隨我們產品的web模塊中的相同文件中。這樣就只有客戶需要的一個版本。

我們正在考慮升級我們工作中使用的工具,以便在本週的日程安排中,在工作中保持良好和安靜,我將考慮HXS可以產生的各種類型的輸出。


編輯:嗯,咋一看,在幫助頁面的幫助和手冊中,我們使用的產品,有this to say about HXS

Visual Studio的幫助也被稱爲MS幫助2.0。最初,這種幫助格式旨在成爲HTML幫助的繼承者。但是,微軟將無限期推遲發佈,現在很明顯,它永遠不會作爲普通用戶應用程序的幫助格式發佈。

請注意,這是一種特殊的幫助格式,僅用於記錄用於集成到Visual Studio .NET中的第三方編程組件。它不適用於任何其他目的,不能用於應用程序的正常幫助項目!

我想HXS是完全不在桌子上的。


注意:基於Web的並不一定意味着你需要一個Web服務器,只需要一個網絡瀏覽器。無論是將其集成到您的應用程序中,還是使用Web瀏覽器組件,或者只是啓動用戶默認瀏覽器,這都是您必須做出的選擇,但大多數基於Web的幫助輸出並不需要任何幫助服務器設置。

+0

感謝...貌似HXS是完全關閉的限制。 – Helios 2008-12-29 01:26:48

+0

也許我們只需要等待Windows 7找出他們將要在那裏做什麼。然後,再次,在Windows 8 ...:D – 2008-12-29 07:09:58

4

對我來說,CHM依然是答案。我使用Codeplex上的Sandcastle Help File Builder tool構建CHM文件。

有關CHM可訪問性的擔憂。爲了解決這個問題,我很容易地製作了一個CHM到Web轉換器,其中包括一些IStorage黑客攻擊,文本搜索和替換以及XSL轉換。 This page是一個約8秒鐘自動生成的網站。 它在左側導航欄上有展開/摺疊樹狀視圖。基於框架(不是非常友好的URL),但它工作得很好。

2

我見過的唯一有用的幫助文檔是純HTML。大部分(如果不是全部)我看過的開源項目都有HTML幫助頁面(用於API和參考文檔)。任何使用專有格式或需要專有閱讀器的軟件都會面臨過時(CHM)或兼容性問題或膨脹問題(PDF)的風險。

由於某些原因,Microsoft在幫助文件方面表現不佳。Visual Studio/SQL Studio/Office的在線幫助非常糟糕,MSDN很混亂,CHM很笨重,而且Microsoft搜索從未返回您真正想要的結果。 (只是我的意見:)

1

Adobe RoboHelp可用於作者幫助內容具有內容/索引/搜索/詞彙表,並在HTML生成的瀏覽器中工作。支持35種語言。

我們有一個基於Flex的Web應用程序,用它來管理應用程序的幫助內容。 Flex應用程序及其幫助系統適用於Windows/MacOSX/Linux上的大多數瀏覽器。

10

究竟是什麼讓你覺得在Windows Vista上沒有默認的.chm查看器? (當然是有一個我的電腦上,以及對我的Win7盒)

您可能會混淆的.chm用的.hlp(微軟的確是在Vista下降的.hlp支持,那麼最終恢復了它在Windows更新)

底線:.chm文件似乎仍然支持所有的Windows版本,而唯一真正替代.chm文件,我知道的是html的