/
typedoc.ts
203 lines (197 loc) · 6.89 KB
/
typedoc.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
import { Options } from "..";
import { ParameterType, ParameterHint } from "../declaration";
export function addTypeDocOptions(options: Pick<Options, "addDeclaration">) {
options.addDeclaration({
name: "options",
help:
"Specify a json option file that should be loaded. If not specified TypeDoc will look for 'typedoc.json' in the current directory",
hint: ParameterHint.File,
defaultValue: process.cwd(),
});
options.addDeclaration({
name: "tsconfig",
help:
"Specify a typescript config file that should be loaded. If not specified TypeDoc will look for 'tsconfig.json' in the current directory.",
hint: ParameterHint.File,
defaultValue: process.cwd(),
});
options.addDeclaration({
name: "entryPoints",
help:
"The entry points of your library, which files should be documented as available to consumers.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "exclude",
help: "Define patterns for excluded files when specifying paths.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "externalPattern",
help:
"Define patterns for files that should be considered being external.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "excludeExternals",
help:
"Prevent externally resolved TypeScript files from being documented.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "excludeNotDocumented",
help:
"Prevent symbols that are not explicitly documented from appearing in the results.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "excludePrivate",
help: "Ignores private variables and methods",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "excludeProtected",
help: "Ignores protected variables and methods",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "disableSources",
help:
"Disables setting the source of a reflection when documenting it.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "includes",
help:
"Specifies the location to look for included documents (use [[include:FILENAME]] in comments).",
hint: ParameterHint.Directory,
});
options.addDeclaration({
name: "media",
help:
"Specifies the location with media files that should be copied to the output directory.",
hint: ParameterHint.Directory,
});
options.addDeclaration({
name: "out",
help: "Specifies the location the documentation should be written to.",
hint: ParameterHint.Directory,
});
options.addDeclaration({
name: "json",
help:
"Specifies the location and file name a json file describing the project is written to.",
hint: ParameterHint.File,
});
options.addDeclaration({
name: "theme",
help:
"Specify the path to the theme that should be used or 'default' or 'minimal' to use built-in themes.",
type: ParameterType.String,
defaultValue: "default",
});
options.addDeclaration({
name: "name",
help:
"Set the name of the project that will be used in the header of the template.",
});
options.addDeclaration({
name: "includeVersion",
help: "Add the package version to the project name.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "excludeTags",
help: "Remove the listed tags from doc comments.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "readme",
help:
"Path to the readme file that should be displayed on the index page. Pass `none` to disable the index page and start the documentation on the globals page.",
});
options.addDeclaration({
name: "defaultCategory",
help:
"Specifies the default category for reflections without a category.",
defaultValue: "Other",
});
options.addDeclaration({
name: "categoryOrder",
help:
"Specifies the order in which categories appear. * indicates the relative order for categories not in the list.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "categorizeByGroup",
help:
"Specifies whether categorization will be done at the group level.",
type: ParameterType.Boolean,
defaultValue: true,
});
options.addDeclaration({
name: "gitRevision",
help:
"Use specified revision instead of the last revision for linking to GitHub source files.",
});
options.addDeclaration({
name: "gitRemote",
help: "Use the specified remote for linking to GitHub source files.",
defaultValue: "origin",
});
options.addDeclaration({
name: "gaID",
help:
"Set the Google Analytics tracking ID and activate tracking code.",
});
options.addDeclaration({
name: "gaSite",
help: "Set the site name for Google Analytics. Defaults to `auto`.",
defaultValue: "auto",
});
options.addDeclaration({
name: "hideGenerator",
help: "Do not print the TypeDoc link at the end of the page.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "toc",
help:
"Define the contents of the top level table of contents as a comma-separated list of global symbols.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "disableOutputCheck",
help:
"Should TypeDoc disable the testing and cleaning of the output directory?",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "help",
help: "Print this message.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "version",
help: "Print TypeDoc's version.",
type: ParameterType.Boolean,
});
options.addDeclaration({
name: "plugin",
help:
"Specify the npm plugins that should be loaded. Omit to load all installed plugins, set to 'none' to load no plugins.",
type: ParameterType.Array,
});
options.addDeclaration({
name: "logger",
help: "Specify the logger that should be used, 'none' or 'console'",
defaultValue: "console",
type: ParameterType.Mixed,
});
options.addDeclaration({
name: "listInvalidSymbolLinks",
help:
"Emits a list of broken symbol [[navigation]] links after documentation generation",
type: ParameterType.Boolean,
});
}