使用Doxygen輸出chmcmd產生假錯誤消息

Question

我使用chmcmd從Doxygen文件創建一個.chm文檔。 後者送給我（假的）錯誤信息，如

Error: Anchor [HTML page, generated from a file containing @page]#[a @section or @subsection with label, all in the same file] undefined; first use [HTML page, generated from a file containing @page]

在HTML文件中，我看不出紋路

<li><a class="el" href="User_Guide.html#USER_GUIDE_SETUP_AND_DATA_FLOWS">SETUP AND DATA FLOWS</a><ol type="a"> 

和

<h1><a class="anchor" id="USER_GUIDE_SETUP_AND_DATA_FLOWS"></a> 
SETUP AND DATA FLOWS</h1> 

這，在我看來，應該好的。錯誤信息是假的，因爲 .html文件和.chm文件都可以正常工作。它似乎是無害的，但會產生相當大的噪音，我恐怕會錯過一些真正的錯誤。

我可以做些什麼反對嗎？

Answer 1

這看起來不像chmcmd錯誤。 「@page」或「@section」對chmcmd沒有任何意義。 Chmcmd沒有產生任何幫助，只是編譯，所以從這個角度來看，消息也不合邏輯。

爲了以防萬一，我對源碼進行了確認，並沒有命中。

所以可能它不是chmcmd，但可能錯誤來自doxygen html-for-chm輸出模塊。

Answer 2

特殊字符使HTML幫助編譯器出現問題（請參閱附加鏈接）。我知道這不是你所描述的問題。我不使用ChmCmd，所以我不能重現你的錯誤信息。

但是，以下線程來自幫助&手冊論壇似乎給出了一些信息Linking to anchors in chm topics from C#。在您的錯誤信息

Follow-up by Tim Green: Note that if the topic in question is the first topic in the CHM that's a known bug in the CHM system and unavoidable. It just doesn't synchronize with the topic if its on its own and not in a chapter. That's always been an issue in CHM and Microsoft has never corrected it. The synchronization of the TOC with the topics in CHM is also beyond Help & Manual's control; it's entirely controlled by Microsoft's viewer.

所以，我認爲「......第一次使用...」是關係到這個線程意味着問題：請搜索。

從我們HelpwareGroup網站在一些進一步的信息：

CHM Compiler crashed during compilation

HTMLHelp CHM Frequently Asked Questions

BTW，C＃開發人員可能會發現，他們在CHM格式的文​​檔和電子書無法打開，因爲它們存儲他們的CHM文件存放在'C：\ E-books \ C＃\'等目錄中。哈希字符表示HTML中的錨點，因此CHM查看器無法正確解析路徑並檢索內容。要解決該問題，請從目錄名稱中刪除'＃'（散列）字符。還要避免在目錄名稱中使用'？'，'&'和'+'字符。