Sandcastle+SandcastleHelpFileBuilder生成说明文档

1  安装说明

  (1). 安装HTML Help Workshop

  (2). 安装Sandcastle

  (3). 安装SandcastleHelpFileBuilder

  (4). 安装SandcastleHelpFileBuilder的Visual Studio插件(可选, SHFBVisualStudioPackage.vsix)。

  (5). 添加环境变量:”SHFBROOT”,值为SandcastleHelpFileBuilder的安装路径,如” C:\Program Files (x86)\EWSoftware\Sandcastle Help File Builder\”。

2  使用说明

  1. 打开SandcastleHelpFileBuilder安装目录下的SandcastleBuilderGUI.exe
  2. “File”菜单——“New Project”
  3. 右击项目下的”Documentation Sources”——“Add Documentation Source…”,添加要生成文档的.dll和.xml文件。
  4. 设置项目的属性,如HelpTitle,HtmlHelpName等。
  5. 生成项目,“Documentation”菜单——“Buid Project”

  如果安装了SandcastleHelpFileBuilder的Visual Studio插件,可在Visual Studio中新建Sandcastle Help File Builder Ptoject。

  1. “文件”——“新建”——“项目”,
  2. 在已安装模板中选择”Documentation”,再选择” Sandcastle Help File Builder Ptoject”。
  3. 右击项目下的”Documentation Sources”——“Add Documentation Source”,添加要生成文档的.dll和.xml文件。
  4. 设置项目的属性,如HelpTitle,HtmlHelpName等。
  5. 使用Visual Studio插件它会在chm文件中生成Welcome和VersionHistory,如果不想要可以在ContentLayout.content中删除。
  6. 生成项目。

3 相关参考资料

http://www.cnblogs.com/ASPNET2008/archive/2010/07/09/1774459.html

Sandcastle+SandcastleHelpFileBuilder生成说明文档,布布扣,bubuko.com

时间: 2024-10-12 06:25:57

Sandcastle+SandcastleHelpFileBuilder生成说明文档的相关文章

Java 如何将程序中的注释提取出来生成说明文档

第一种方法: 可以使用JavaDoc工具.它可以从程序源码中将类.方法.成员变量等文档注释抽取出来形成一个与源代码配套的API帮助文档.但是在编写代码时要以一定的规范做注释才可以.通过JavaDoc实现工具就可以同时生成代码的开发文档了.JavaDoc工具位于 C:\Program Files\Java\jdk1.6.0_10\bin 路径下. 其中/**...*/这种注释用于支持JavaDoc工具,还有一些以@开头的标识信息也可以抽取出来,如下图. 这里使用源码中StringBuffer.ja

Sandcastle Help File Builder 说明文档

1. 概述 该应用可以根据我们编译的程序集或者VS工程自动生成相应的帮助文档. 2. 安装说明 从https://github.com/EWSoftware/SHFB/releases下载最新的安装包,解压到文件夹,运行SandcastleInstaller.exe进行安装. 3. 新建工程 安装完成后,打开应用程序,File->New Project,输入文件名,点击保存,出现如下界面: 4. 添加源文件 右键点击Project Explorer中的Documentation Sources结

原创SQlServer数据库生成简单的说明文档小工具(附源码)

这是一款简单的数据库文档生成工具,主要实现了SQlServer生成说明文档的小工具,目前不够完善,主要可以把数据库的表以及表的详细字段信息,导出到 Word中,可以方便开发人员了解数据库的信息或写技术说明文档. 技术上主要采用的 C#+Dapper+Npod ,开发工具为Vs2015,基于Net4.5框架. 实现思路: 1.首先获取数据库的字符串,测试链接是否成功, 2.通过脚本获取该服务器的数据库列表. 3.根据数据库找到该数据库的所有数据表 4.通过脚本找到该数据表所有的字段信息 5.使用N

为ASP.NET WEB API生成人性化说明文档

一.为什么要生成说明文档 我们大家都知道,自己写的API要供他人调用,就需要用文字的方式将调用方法和注意事项等写成一个文档以更好的展示我们设计时的想法和思路,便于调用者更加高效的使用我们的API. 当然,您可以不借助任何工具,自己手工写文档,然后做成chm或者html的形式交给客户,就是效率有点低,并且在API更改后有需要手工更改说明文档. 那有没有一种既方便,又能在API发生改变时,自动更新说明文档呢?答案是肯定的. 二.自动生成说明文档的具体实现 我们这里主要是将GlobalConfigur

JAVA 文档注释,类的说明,HTML说明文档的生成

有的时候,我们会写一些类,编译成.class文件,给别人使用,那么,别人不知道这个类有哪些方法,如何调用. 所以我们需要做一个类的说明文档. 可以采用在.java类里面进行注释,通过注释来生成类的说明文档的方法. 一..java中注释的写法: Test1.java /* 文档注释 */ /** 此类是对数组进行取最值,排序等操作的 @author 张三 @version 1.0 */ public class Test1{ /** 取Int数组里面的最大值 @param arr 传入一个int数

weiapi2.2 HelpPage自动生成接口说明文档和接口测试功能

在开发Webapi项目时每写完一个方法时,是不是需要添加相应的功能说明和测试案例呢?为了更简单方便的写说明接口文档和接口测试HelpPage提供了一个方便的途径. 她的大致原理是:在编译时会生成.dll程序集和.xml程序集说明文件,通过xml文件获取Controller名称.action名称.参数信息和备注信息等.这样接口说明文档就可以放到备注信息了,个人觉得确实粗暴简单 .那接口测试在哪呢?这里用到nuget第三方程序包:webapitestclient 先上效果图吧! 案例是用VS2013

powerdesigner逆向自动生成mysql说明文档、PDM

做EDI的项目的时候,用到相关工具powerdesigner,正好我们的一个项目对数据设计阶段时相关文档没有很好的保存下来,查找了一下powderdesigner相关文档,采用逆向工程,从mysql数据库生成pdm数据模型.再配合其它工具生成数据库说明文档 工具/原料 powderdesigner15.0 mysql5.1 pdmreader mysql-connector-odbc-5.1.5-win32.msi 方法/步骤 配置ODBC数据源,安装mysql-connector-odbc-5

ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了

引言 在使用asp.net core 进行api开发完成后,书写api说明文档对于程序员来说想必是件很痛苦的事情吧,但文档又必须写,而且文档的格式如果没有具体要求的话,最终完成的文档则完全取决于开发者的心情.或者详细点,或者简单点.那么有没有一种快速有效的方法来构建api说明文档呢?答案是肯定的, Swagger就是最受欢迎的REST APIs文档生成工具之一! 为什么使用Swagger作为REST APIs文档生成工具 Swagger 可以生成一个具有互动性的API控制台,开发者可以用来快速学

自动生成 WebApi 在线说明文档。

1.使用Swashbuckle实现 Swashbuckle 是.NET类库,可以将WebAPI所有开放的控制器方法生成对应SwaggerUI的JSON配置.再通过SwaggerUI 显示出来.类库中已经包含SwaggerUI .所以不需要额外安装. 2.快速开始.前提已有webapi项目 查看webapi项目属性,在[生成]选项卡中勾选X[ML文档文件].在编译过程中会生成一个注释文件 使用NuGet包将Swashbuckle库添加到在webapi项目中 引用后,在App_Start文件夹下会生