向Cocoa應用程序添加幫助

Question

我想爲我的Cocoa應用程序添加一個簡單的單頁HTML頁面幫助。你能告訴我怎麼做嗎？我假設我只需要在Xcode的Cocoa項目中放入一個糟糕的.html文件（也許是一個.css文件？）？

Answer 1

創建在幫助查看器中打開的Apple幫助文檔非常簡單，但您必須完全按照文檔中的說明進行操作。

幫助文件是HTML，但您需要在頁面中放置幾個​​特殊標記並以特定方式命名這些文件。

全部解釋於the documentation。

Answer 2

如果您只想要一個HTML頁面而不是正確的幫助文件，則可以將HTML文檔和CSS文件添加到您的項目中。這些將在您編譯項目時複製到應用程序包內的應用程序Resources目錄中。要加載文檔，您需要獲取它的地址。這其實很簡單：

NSString *helpFilePath = [[NSBundle mainBundle] pathForResource:@"YourHelpDocumentHere" ofType:@"html"]; 
NSURL *helpFileURL = [NSURL fileURLWithPath:helpFilePath]; 

生成的URL將是一個WebView可以在你的應用程序中顯示文件的URL，或者您也可以使用NSWorkspace將其傳遞給操作系統，它會在用戶打開默認網頁瀏覽器。

Answer 3

今天我一直在面對同樣的問題。我沒有找到最新的howto，所以這裏是我自己的。幫助很好地使用這個Step by Step to create Apple Help in your Cocoa Xcode Application。