c#类文档的可打印形式
本文关键字:打印 文档 | 更新日期: 2023-09-27 18:17:06
我们的c#源代码使用通常的Sandcastle/XML符号进行了全面的记录。我们使用SHFB将其编译成msdn风格的文档网站。
我们现在需要*1将文档编译成可打印的形式。理想情况下,我们想要一个PDF文档,但具体格式不如其可打印性重要。重要的是,但不是至关重要的是,文档看起来相对专业,可以打上公司标志等。
是否有一种无痛的方法来做到这一点?我不认为单独打印文档网站的每一页是一个实际的选择。原则上,可以将中间XML文档文件转换为可用的格式,但是对于该任务,是否已经存在可行且可维护的解决方案?
有没有一种几乎无痛的方法来做到这一点?
不,不要这样做。这对于类级文档来说毫无意义——没有人会去读它。高的超链接不起作用,必须更改为页面引用。
我们的c#源代码使用通常的Sandcastle/XML表示法进行了全面的记录。
不,它不是。它是用普通的XML文档表示法记录的。这不是沙堡发明的
现在,如果你真的必须这样做:
http://www.innovasys.com/products/dx2011/csdocumentation.aspx?cpid=gawdxcs& gclid = COiJq5To8qwCFQGHDgod900o0g
几乎是你能得到的最好的。他们的专长就是这个(多目标的东西)。它们还处理额外的页面等,这是需要的——纯类引用,没有索引,只是打印,用超链接代替页面引用,基本上是没有任何意义的树破坏。
显然,Help和Manual可以直接导入Sandcastle项目,然后以各种格式输出它们(包括可打印的)。
我自己还没试过。我很想听听大家的经验。
Ndoc有一个Latex文档插件。NDoc支持Sandcastle支持的所有文档标签,因此应该能够将文档编译成Latex文件。然后可以使用它来创建,例如,用于打印的Postscript文档。