我有两个文件,文件A和文件B。文件A使用B文件中的一个类。我的目标是在文件A的TypeDoc输出中引用B文件中使用的类的TypeDoc输出。
我知道,您可以使用TypeDoc引用包含在同一个文件中的符号,并带有双括号,比如[[Foo]],但是对于这样的外部类型,这是行不通的。
/** Trying to reference [[FileB.InnerClass]] like this doesn't work. */
// This here is what I want to include
export type InnerClass = FileB.InnerClass;
//
我有一个TypeScript项目,我正在使用TypeDoc为它生成文档。在我的项目中,我使用了一个拥有自己现有文档的外部库。在我的项目的TypeDoc输出中,我希望将读者链接到外部库的文档,而不必手动插入URL。
我最接近的解决方案是在代码注释中用双括号括起我想要链接的内容,如下所示:
/** I want to link to something called [[Foo]] */
但这似乎不适用于外部库中的类型。
这有可能实现吗?
在Typedoc中,可以使用以下方法链接到另一个类:
[[ClassName]]
{@link ClassName}
这个类甚至可以属于另一个模块。
但是,我想不出如何链接到
另一个模块
从另一个模块导出的函数
因此,假设您有2个d.ts文件:
Foo.d.ts
/**
* I want to link to:
* the [[Bar]] module //does not work
* the {@link Bar} module //does not work
* the [[Bar.foobar]] function //does not work
目标是从TypeScript代码中获取JSDoc文档。来自TypeDoc (TypeScript文档解决方案)的文档的质量是不可接受的,因为文档是针对JS用户的,不应该被特定于TypeScript实现(接口等)的细节所淹没。
目前,转换为ES6并从JS文件生成文档在很大程度上做到了这一点。没有赋值的属性除外。就像看起来的那样,
class A {
/**
* @private
* @var _a
*/
private _a;
/**
* @public
* @var a
*/
public a = t
type S=string|undefined;
declare global {
export interface String {
/**
* returns string between borders
* @param borderA - left border
* @param borderB - right border
* @param aIsFirst - true if borderA is first, false if is last
* @param
如何在类型记录中记录Union类型,以便typedoc能够提取/显示相关信息?下面是一个JSDoc引用,但是有TSDoc引用吗?
示例
/**
* Search parameters
* These comments are not picked up, I generate blank page
*/
export type SearchParams = string | string[][] | Record<string, string>;
/**
* Query parameters
* These comments are not picked up, I g
我正在尝试为TypeDoc运行gulp任务,但是我得到的每个ts文件都有这个错误
Experimental support for decorators is a feature that is subject to change in a future release. Specify '--experimentalDecorators' to remove this warning
我的gulp文件:
var gulp = require('gulp');
var typedoc = require("gulp-typedoc");
gu
为.jsx和.tsx文件中的React钩子生成文档的最佳方式是什么? 我尝试了TypeDoc,但是我没有从函数方法中得到任何注释。 const MainFunction = () => {
/**
* How to get generate this comment?
*
* @param a first number
* @param b second number
*
* @returns sum of and b
*/
const sumNumbers = (a, b) => {
return a + b;
我在用咕噜和打字机做应用程序。
我需要使用TypeDoc编写文档,但有一个方案有问题。
我必须从文档中排除一些文件,这些文件是外部文件库。我不能将这些文件放入exclude部分,因为这些文件与另一个文件有关。如果我试图排除它(通过将这些文件放入exclude部分),我就出现了一个错误--类似于cannot find to xxx into yyy.ts --其中xxx是我排除的元素,yyy是与xxx相关的文件。这些相关的文件在这个文档中是必要的,所以我也不能排除这些文件。
我阅读了TypeDoc关于的文档。所以我想,如果我把这个布尔值设置为true,那么我就可以定义externalPatter
我正在尝试使用typedoc生成文档。我的打字本文件中有以下几行。
var validator: any = require('validator');
import * as _ from 'lodash';
var mqtt: any = require('mqtt');
var fs = require('fs');
var path = require('path');
var tls = require('tls');
import * as collections from 't