在线用户指南加PDF下载

Question

目前，我正在使用Microsoft 2003管理我的用户指南，并将其转换为可从网站下载的PDF文件，并由产品安装程序提供。

我想谈一谈实现以下目标的机制：

• 生成具有可点击TOC和首页的PDF文件
• 根据章节/节生成符合HTML5的输出，但没有HTML骨架
• 为用户指南生成JSON TOC (章节大纲)

我想将PDF文件与分布式产品一起打包。

我想创建一些简单的PHP脚本，这些脚本使用上下文敏感的TOC (显示本章的部分)生成HTML页面，并显示相关文档。

我在开发PHP脚本以实现这一点方面没有问题，但我想知道如何生成上面的输出。我最好使用现成的GUI输入文档。我很乐意编写XSLT2样式表来执行任何必要的转换。

让人们知道我想要什么：

• 当前PDF手册：http://rotorz.com/tilesystem/user-guide.pdf
• 使用自定义XSLT2样式表生成的API文档，这些文档包含了一个JSON，然后由PHP：http://rotorz.com/tilesystem/api组合到一组“不完整”的HTML文件中。

当您浏览我的API文档时，您会注意到左边的TOC是上下文敏感的。我希望我的用户指南以类似的方式工作。

有一个免费的替代王子：http://www.princexml.com/的传呼媒体CSS？

Answer 1

在花了相当长的时间阅读了很多变体之后，我发现了一个潜在的解决方案.

1. 使用PHP和http://aloha-editor.org为我的WYSIWYG编辑器创建一个非常简单的“静态”CMS。可能使用https://github.com/chillitom/CefSharp将编辑器直接嵌入到更相关的GUI中。
2. 使用带有自定义封面、页眉和页脚.html文件的"wkhtmltoxdoc“将.html页面转换为PDF。另外，自动生成TOC页面。
3. "wkhtmltoxdoc“还生成一个XML，它可以很容易地转换为JSON。

我仍然在试验"wkhtmltoxdoc“，但它似乎相当不错！当然，除非有更简单的解决办法.

添加：

看来我的TOC文件需要手工编写和自动生成的混合。如果一个简单的XSLT样式表可以通过抓取H1-6标记并为散列链接添加唯一标识符来自动填补空白，那么Eclipse TOC模式的内容就足够了。

因此，XSLT2样式表可以使用此TOC，然后将其转换为JSON，供PHP脚本使用。

我现有文档的模拟摘录：

<?xml version="1.0" encoding="UTF-8"?>
<toc>
    <topic label="Introduction" href="introduction.html"/>
    <topic label="Getting Started">
        <topic label="Installation" href="getting-started/installation.html"/>
        <topic label="User Interface" href="getting-started/ui/index.html">
            <topic label="Menu Commands" href="getting-started/ui/menu-commands.html"/>
            <topic label="Tile System Panel" href="getting-started/ui/tile-system-panel.html"/>
            <topic label="Brush Designer" href="getting-started/ui/brush-designer.html"/>
        </topic>
        <topic label="User Preferences" href="getting-started/user-preferences.html"/>
    </topic>
    <topic label="Creating a Tile System" href="creating-a-tile-system">
        <!-- ... -->
    </topic>
</toc>

参考Eclipse：toc.html