`
mlzboy
  • 浏览: 726778 次
  • 性别: Icon_minigender_1
  • 来自: 北京
文章分类
社区版块
存档分类
最新评论

GhstDoc2.1.1使用手册

阅读更多

 

目录

GhstDoc2.1.1使用手册    1

目录    2

修改历史纪录    3

1、GhostDoc1.2.1简介    4

2、安装(for VS2005)    4

3、配置    8

2.1、初步设置    8

2.2、GhostDoc的配置    11

2.3、热键的设置    12

4、使用GhostDoc为代码生成注释    15

4、代码注释规范    20

1、GhostDoc1.2.1简介

GhostDoc 是一个基于Visual Studio的 XML 文档注释生成器,相比 NDoc 而言它更可以帮助你自动生成大量令人厌烦的相似的描述。

2、安装(for VS2005)

在安装之前请确保关闭Visual Studio2005,双击GhostDoc2.1.1.msi进行安装

 

 

点击"Next":

 

 

选 "I Agree" 点击"Next":

 

 

选择要安装的路径,点击"Next":

 

 

点击"Next"开始安装:

 

 

安装完成之后,出现如下图的窗口,点击"Close"完成安装:

 

 

3、配置

2.1、初步设置

打开Visual Studio 2005,出现如图对话框,如下图:

 

 

在此可以设置热键,点击"Assign",如果还不知道要把热键设成什么,或者要设的热键不在下拉菜单中,点击"Skip",之后再设。这里点击"Skip",如下图:

 

 

如果是第一次安装GhostDoc,点击"Create";如果要载入已有的结构,点击"Import"(此处点击"Create")。出现如下窗口:

 

点击"Finish"完成,进入Visual Studio 2005界面,如下图:

 

 

在"工具"的下拉菜单里就会出现一个"GhostDoc"的选项,如下图:

 

右键菜单中就会出现"Document this"命令,如下图:

 

 

2.2、GhostDoc的配置

在Visual Studio2005的菜单栏中选择"工具|GhostDoc|Configure GhostDoc",弹出对话框如下图:

其中包含的属性页:

1. Rules 修改,删除,添加文本生成规则

2. Acronyms 指定将哪些单词视为首字母缩写词

3. "of the"Reordering 指定触发重新排序行为的单词

4. "No the"Words 指定哪些词前不使用"the"

5. Options 配置GhostDoc的其他选项

2.3、热键的设置

打开Visual Studio 2005的"工具|选项",如下图:

 

 

在弹出的对话框的左边框中选择"环境|键盘",如下图:

 

在右侧键盘定义区的"显示命令包含(C):"下的输入栏里输入"ghost",如下图:

 

 

在"新快捷键用于(N):"中选择"文本编辑器",并在其后的"按快捷键(P):"中按所要设置的快捷键(这里设成Ctrl+Shift+D),如下图:

 

点击"分配",再点击"确定"完成,如下图:

 

 

4、使用GhostDoc为代码生成注释

GhostDoc为Visual Studio中的代码编辑器安装了一个新的命令。在编辑文件时,只需将光标置于要添加文档的方法或属性的内部,然后使用热键(初始化时默认是Ctrl+Shift+D)或右键菜单中的"Document this"菜单项调用命令,GhostDoc就会插入一段XML格式的注释。

这里用GhostDoc自带的一个Demo代码作介绍(双击与安装文件同一目录下的GhostDoc2.1.1DemoProject.msi,安装过程与"1 安装" 一样,安装完成后就会在"开始|所有程序|Weigelt|GhostDoc for VS 2005"目录下会出现一个"Open Demo C# Project" 选项,如下图:

打开"Open Demo C# Project",如下图:

 

 

将光标置于要添加文档的方法或属性的内部(注意,必须是内部),比如要注释Demo中的FullFileName方法,需将光标置于FullFileName方法的"{……}"中或方法名上,如下图:

 

 

然后使用热键(初始化时默认是Ctrl+Shift+D,如果初始化没设,可参考下文的设置)或右键菜单中的"Document this"菜单项调用命令,GhostDoc就会插入一段XML格式的注释,如下图:

 

 

当然,在方法或属性前面键入"///"也可以达到类似的效果,如下图给JustTesting方法注释:

 

然而后者只能够创建一段空的注释构造,而GhostDoc却能生成大部分实用的注释,如下图比较:

 

 

需要注意的是:GhostDoc生成注释的质量很大程度上取决与标识符命名的质量;而且GhostDoc也不能一次性为整个代码文件生成注释,只能每次为一个成员生成注释—如此设计是因为不管怎么样都需要你去检查它生成的每一段注释。

4、代码注释规范

GhostDoc事实上并不懂英语,那为何它生成的文档却常常令人相当满意?其中的基本原理颇为简单,GhostDoc假定你的代码遵从微软类库开发人员设计规范:

1、你的代码使用Pascal或Camel命名法为由多个单词组成的标识符命名

2、你的方法名通常以动词开头

3、你在标识符中不使用缩写

如果你能够遵从这些规则(比如,使用ClearCache()而不是Clrcch()),同时使用一些自解释的标识符名称,那么GhostDoc就能派上用场了,它把标识符分割为几个单词,将它们组合来生成注释,也许并不完美,却给你一个良好文档的开始。

文本的生成使用可定制的规则和模板,除了内置的规则,还可以定义新的自定义规则来扩展或替换既有的规则(为你的自定义规则提供更高的优先级或禁用内置规则)。

上面提到过,GhostDoc并不懂英语,但它会尝试使用某种机制来提高生成注释的质量:

1、动词的处理机制(GhostDoc假定方法名的首个单词为动词):Add->Adds,Do->Does,Specify->Specifies;

2、"Of the"排序组织机制:ColumnWidth –> Width of the column.

3、 一些特殊形容词的特殊合并机制:例如,MaximumColumnWidth->Maximum

width of the column而不是Width of the maximum column

4、 对首字母缩写组成的常量的自动检测,并通过一个列表来处理其它的一些首字母缩写术语

5、 使用一个单词列表,以决定何时不使用"the":AddItem ->Adds the item, BuildFromScratch ->Builds from scratch

下面是应用GhostDoc的一些例子:

是不是惊人的准确啊!!!

分享到:
评论

相关推荐

    CodeIgniter 2.1.1中文手册

    中文手册的发布使得国内开发者可以更加便捷地理解和使用CodeIgniter,避免了语言障碍带来的困扰。 在CodeIgniter 2.1.1中文手册中,你可以找到关于以下核心概念和功能的详细解释: 1. **安装与设置**:手册首先...

    先临三维扫描仪v2.1.1用户手册.pdf

    先临三维扫描仪v2.1.1用户手册.pdf

    JQuery2.1.1含jquery-2.1.1-vsdoc.js

    微软提供的jquery-2.1.1.intellisense.js文件需要jquery-2.1.1.min.js或jquery-2.1.1.js的配合才能使VS进行智能提示,这使得jquery-2.1.1-vsdoc.js文件在asp.net mvc开发中使用了ScriptBundle功能后变得尤为重要。...

    phantomjs-2.1.1-windows

    phantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-windowsphantomjs-2.1.1-...

    apache-hive-2.1.1-bin.tar

    apache-hive-2.1.1-bin.tar apache-hive-2.1.1-bin.tar apache-hive-2.1.1-bin.tarapache-hive-2.1.1-bin.tar apache-hive-2.1.1-bin.tar apache-hive-2.1.1-bin.tarapache-hive-2.1.1-bin.tar apache-hive-2.1.1-...

    Axhub Charts Pro V2.1.1.rplib

    Axhub Charts Pro V2.1.1.rplib Axhub Charts Pro V2.1.1.rplib Axhub Charts Pro V2.1.1.rplib Axhub Charts Pro V2.1.1.rplib Axhub Charts Pro V2.1.1.rplib Axhub Charts Pro V2.1.1.rplib Axhub Charts Pro V...

    hive2.1.1-cdh6.3.2

    Hive是Apache Hadoop生态系统中的一个数据仓库工具,它允许用户使用SQL(称为HQL,Hive Query Language)对存储在HDFS上的大型数据集进行分析。Hive 2.1.1是Hive的一个重要版本,而CDH6.3.2是Cloudera发行的商业版...

    开发工具 commons-dbcp2-2.1.1

    开发工具 commons-dbcp2-2.1.1开发工具 commons-dbcp2-2.1.1开发工具 commons-dbcp2-2.1.1开发工具 commons-dbcp2-2.1.1开发工具 commons-dbcp2-2.1.1开发工具 commons-dbcp2-2.1.1开发工具 commons-dbcp2-2.1.1开发...

    hive2.1.1 + hadoop2.6.0jdbc驱动

    标题 "hive2.1.1 + hadoop2.6.0 jdbc驱动" 指的是一个包含特定版本的Hive和Hadoop组件的集合,这些组件特别针对通过JDBC进行数据库连接进行了优化。Hive是Apache软件基金会开发的一个数据仓库工具,它允许用户使用...

    HCL_V2.1.1.zip

    原因可能在于这个版本可能存在与HCL V2.1.1不兼容的问题,或者为了确保最佳性能和稳定性,开发者推荐使用特定的VirtualBox版本。因此,我们应当使用压缩包中提供的VirtualBox-5.2.22-126460-Win.exe来进行安装。 在...

    SuperSlide v2.1.1 所有案例

    * SuperSlide v2.1.1 * 轻松解决网站大部分特效展示问题 * 详尽信息请看官网:http://www.SuperSlide2.com/ * * Copyright 2011-2013, 大话主席 * * 请尊重原创,保留头部版权 * 在保留版权的前提下可应用...

    numpy-2.1.1.tar.gz

    该资源为numpy-2.1.1.tar.gz,欢迎下载使用哦!

    phantomjs-2.1.1 下载

    而对于Linux用户,他们将使用"phantomjs-2.1.1-linux-x86_64.tar.bz2",这是一个针对64位Linux系统的tar.bz2压缩包,用户需要先解压,然后将可执行文件添加到PATH环境变量中以便全局调用。 标签中包含"phantomjs"和...

    nacos-2.1.1.zip

    文件包含: nacos-server-2.1.1.tar.gz nacos-server-2.1.1.zip nacos-server-2.1.1Source code(zip) nacos-server-2.1.1Source code(tar.gz)

    windows 下 nacos2.1.1压缩包

    在Windows环境下安装和使用Nacos2.1.1版本,你需要了解以下几个关键知识点: 1. **下载与解压**:首先,你需要从官方或可靠的源下载Nacos2.1.1的Windows版本压缩包。下载完成后,将其解压到本地文件夹,通常包含`...

    免费远程桌面软件RDC2.1.1

    “免费远程桌面软件RDC2.1.1”表明这是一个无需付费的解决方案,用户可以免费下载和使用,这对于个人用户和小型企业来说特别有吸引力,因为它们可能没有足够的预算购买和维护昂贵的远程访问软件。 描述中提到,这款...

    ubuntu使用安装包安装tinyos-2.1.1

    TinyOS-2.1.1是TinyOS的一个较早版本,但仍然在很多教学和研究中广泛使用。下面我们将详细介绍如何在Ubuntu 12.04上通过安装包来安装TinyOS-2.1.1。 首先,确保你的Ubuntu系统已经更新到最新状态。打开终端并输入...

    unlocker-master v2.1.1

    使用Unlocker Master v2.1.1的过程一般包括以下步骤: 1. **下载与安装**:首先,用户需要从可靠的源获取Unlocker Master v2.1.1的压缩包文件,并解压到本地目录。 2. **环境准备**:确保已经安装了VMware ...

    spark-2.1.1.zip

    在部署和使用 Spark 2.1.1 时,用户可以利用其丰富的生态系统,如结合 Hadoop、Hive、Cassandra 等存储系统,以及与 Jupyter Notebook 集成进行交互式数据分析。同时,Spark 提供了 PySpark、SparkR 等多种编程接口...

    nacos-2.1.1安装包.zip

    在本文中,我们将深入探讨Nacos 2.1.1版本的安装、配置以及它在软件开发中的重要性。 首先,Nacos的核心功能包括服务发现和服务配置。服务发现允许微服务架构中的各个组件找到彼此,而服务配置则提供了动态管理和...

Global site tag (gtag.js) - Google Analytics