在HTML创建帮助文件

Question

我面临着创造一个大的项目帮助文件的有趣的任务。我已经丢弃CHM文件，由于限制和目前正在处理中基于HTML文件，但我仍然犹豫不决的格式....

有3个区域我重点是：

部分的可重用性（许多页面可以指的是一个文本） 由于部分路段将被用于超过在帮助文件一次，我需要创建一个主控部分，然后在每个子链接到主章节。此所以避免做修改时改变字幕的多个地方。

Searchfunctionality 我想能够搜索到该文件中自由文本。

印刷适性。 用户可以选择要打印的区段或wholde文档。

我是第一次靠在具有插件的wiki导出到分配静态页面维基的方法，但我还没有找到解决办法......

这是你在这件事情你们有什么建议？ am我使得帮助文档到复杂？

提前感谢！

Answer 1

<强>可重用性

我看到两种方法。您可以创建要重用部分个人网页，然后简单地在适当情况下链接到他们。这是在HTML微不足道的。

可以可选地创建HTML的与该信息用于该部分的一个片段或片段，然后使用服务器端包含（或类似技术）无论它的需要直列包括它。通过这种方式，内容会显示已写每一个人页面上，但是当你需要进行编辑，它仍然只在一个地方。

搜索

如果该网站是公众，让谷歌索引它，只是提供了一个谷歌搜索框。你不是有可能取得更好的成绩比。

<强>印刷适性

“打印样式表”，在CSS是很容易放在一起，并能消除所有的图形元素，使该网站在网络上的吸引力，保留所有的内容在纸张上使用。

打印整个文档一次性将需要编程的一些小一点的所有内容一起组合成单页打印的目的。就个人而言，我更愿意甚至提供该服务，从浪费纸张劝阻的人。

当然，我们可以提供深入了解如何实现这些事情的所有方式，但因为它听起来像你后，此刻的一般建议，那是我的。

Answer 2

我相信维基百科是完美的文档，特别是当不止一个人（或即将）参与该项目。 wiki页面或命名空间之间的链接很容易实现。重命名页面将会改变所有超链接的其他文件。我会避免内容重复尽可能但是，如果这是你在暗示什么。

我使用 DokuWiki的支持页出口。你可以转储整个维基成纯文本，XHTML或XHTML体（为自己的模板内的推杆，或将追加到打印一个文件，等等）。

希望帮助！