标签: documentation

隐藏从Sandcastle生成的文档中继承自Object的方法?

如何从Sandcastle生成的文档中隐藏从Object类继承的方法(如Equals,Finalize,GetHashCode,GetType等...).我有一个名为LicenseManager的类,它有一个方法,而Object继承的方法会阻塞显示.

我正在使用最新版本的Sandcastle + Sandcastle帮助文件生成器.

http://cl.ly/3Y2p1C0m1a3f160z0y2v

c# documentation sandcastle

1
推荐指数
1
解决办法
1385
查看次数

如何使用JSDoc记录函数

JSDoc似乎没有接受我的大部分功能.这是一个例子:

/**
 * Function one.
 */
(function one() {
    /**
     * Function two.
     */
    function two() {
        /**
         * Function three.
         */
        function three() {
        }
    }
})();

var four = {
    /**
     * Function five/six.
     */
    five: function six() {
    },
    /**
     * Function seven/eight.
     */
    seven: function eight() {
    },
};

nine.ten = {
    /**
     * Function eleven/twelve.
     */
    eleven: function twelve() {
        /**
         * Function thirteen/fourteen.
         */
        var thirteen = function fourteen() {
        };
    },
    /**
     * …
Run Code Online (Sandbox Code Playgroud)

javascript documentation standards documentation-generation jsdoc

1
推荐指数
1
解决办法
1376
查看次数

拼写检查应忽略 MS Word 2010 中的下划线变量名称

有没有一种好方法可以让 MS Word 2010 拼写检查忽略技术文档中的变量名称(例如:像带有下划线的单词)?

我不应该加载数据字典来完成此操作,或将这些单词添加到 MS Word 中的字典中。

我尝试创建一个样式“代码”,但它将字体更改为全部粗体或非粗体,这不是我想要的。

documentation spell-checking ms-word

1
推荐指数
1
解决办法
1868
查看次数

如何运行grunt docular-server?

如果我执行命令 grunt docular-server

我收到错误消息:

ERROR: Could not start node server [TypeError: Object #<Object> has no method 'server']

那么docular-server没有运行.

我安装了grunt来编写我的代码文档,如下所示:

 `npm install -g grunt-cli`
 `npm install grunt grunt-docular`
Run Code Online (Sandbox Code Playgroud)

Gruntfile.js看起来像这样:

module.exports = function(grunt) {

// Project configuration.
grunt.initConfig({

pkg: grunt.file.readJSON('package.json'),

docular: {
groups: [],
showDocularDocs: true,
showAngularDocs: true
}

});

// Load the plugin that provides the "docular" tasks.
grunt.loadNpmTasks('grunt-docular');

// Default task(s).
grunt.registerTask('default', ['docular']);

};
Run Code Online (Sandbox Code Playgroud)

这个例子来自官方网站:

http://grunt-docular.com/documentation/docular/docularinstall/installdocular

documentation documentation-generation node.js gruntjs

1
推荐指数
1
解决办法
1302
查看次数

XML/XSD - 添加说明

使用XSD,我可以确保XML文件有效,但是还有一种方法,使用XSD将信息附加到元素和属性,以便打开XML和XSD文件的软件能够显示该描述到用户点击正在描述的元素时?

xml documentation xsd editor

1
推荐指数
1
解决办法
3050
查看次数

将函数的帮助存储在MATLAB中的变量中

我想创建一个html文件来打印包含一个文件夹中所有功能的讲义.有没有办法以编程方式访问每个函数的帮助,以准备字符串输入?

getfunchelp()在这样的程序中,我正在思考虚构的事情:

Functions=dir('*.m');

fid = fopen('FunctionSummary.htm','a');
fprintf(fid, ['<HTML><HEAD><TITLE> Function Summary </TITLE>\n']);

for ii=1:length(Functions)

   FunctionName=Functions(ii).name;
   FunctionHelp=getfunchelp(FunctionName); % <= This one over here

   fprintf(fid, ['<H2>',FunctionName,'</H2>']);
   fprintf(fid, ['\n<BR><i>',FunctionHelp,'</i> ']); 
    %... 

end

 fclose(fid);
Run Code Online (Sandbox Code Playgroud)

或者有更好的方法吗?(如果publish()不打印其余的功能代码,可以更容易实现吗?)

documentation matlab printf

1
推荐指数
1
解决办法
33
查看次数

如何为所有用户定义的julia函数构建索引页面?

说我有A.jl,B.jl,C.jl,D.jl.在每个.jl中,有100个函数.当我尝试调用特定函数时,我需要搜索.jl以确定函数是如何定义的?是否有一种简单的方法可以将所有函数定义生成到HTML索引页面中.如果我可以单击该链接并查看该函数的实际源代码,它会更好.像Doxygen那样为C/C++生成文档,但Doxygen不支持Julia.谢谢.

documentation markdown doxygen julia

1
推荐指数
1
解决办法
128
查看次数

在 Kotlin 中记录类属性

自从我从 Java 切换到 Kotlin 后,我不得不重写我的文档。Kotlin 有自己的文档格式,或者就我所见,它扩展了普通的 javadoc。我检查了官方文档,其中指出有一个property标签可以让您记录类属性。

如果我有一个看起来像这样的 kdoc:

/**
 * Tablemodel for the Players of a server, only holds two properties:
 *
 *  * Name
 *  * Score
 *
 * @author marcel
 * @since Jan 10, 2018
 * @property playerName Ingame name of the player
 * @property playerScore Ingame score of the player
 */
Run Code Online (Sandbox Code Playgroud)

这两个属性都不是 IntelliJ 中呈现的 kdoc 的一部分。

如果我移动author和上面的两个属性since,它们也不会显示。我不太明白为什么。IntelliJ 是否缺乏适当的 kdoc 支持?

java documentation javadoc kotlin

1
推荐指数
1
解决办法
770
查看次数

ESDoc:忽略特定文件

尝试记录JavaScript文件时发生错误。为了解决这个问题,该策略将遵循不同的方向。我们的目标是忽略问题的原因,因为代码做了我们想要的。

对于这个项目,我们使用ESDoc来生成JavaScript文档。但是,如前所述,ESDoc解析器行为不承认我们的文件之一。通过解决ESDoc功能,我们发现没有简单的解决方案可以忽略特定目录中的某些文件。foo.js

所以我们的问题是:

有什么方法可以告诉ESDoc忽略特定文件目录吗?

我们研究了这个问题,但一无所获。请不要在解决方案上误解我们的要求,我们确实忽略了可用功能。

感谢您的时间。

javascript documentation esdoc

1
推荐指数
1
解决办法
660
查看次数

LISP打印功能文档字符串

我只是试图打印LISP函数的文档字符串。的LISP文件是关于文档类型相当暧昧,所以我不确定如何做到这一点。这是我到目前为止的内容:

(defun pr(x) "This is a docstring!" (+ x 1))
(documentation #'pr t)
Run Code Online (Sandbox Code Playgroud)

我还没有找到有关如何执行此操作的简明答案。哪里错了?

lisp documentation common-lisp

1
推荐指数
1
解决办法
69
查看次数