vuepress-plugin-typedoc
Version:
A VuePress plugin to build API documentation with TypeDoc.
79 lines (78 loc) • 3.13 kB
JavaScript
;
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
desc = { enumerable: true, get: function() { return m[k]; } };
}
Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
o["default"] = v;
});
var __importStar = (this && this.__importStar) || function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
__setModuleDefault(result, mod);
return result;
};
const path = __importStar(require("path"));
const typedoc_1 = require("typedoc");
const typedoc_plugin_markdown_1 = require("typedoc-plugin-markdown");
const options_1 = require("../shared/options");
const render_1 = require("../shared/render");
const theme_1 = require("../shared/theme");
const sidebar_1 = require("./sidebar");
let app;
let project;
module.exports = async (opts, ctx) => {
const typedocOptions = (0, options_1.getTypedocOptions)(opts);
const outputDirectory = ctx.sourceDir + '/' + typedocOptions.out;
if (typedocOptions.cleanOutputDir) {
(0, render_1.removeDir)(outputDirectory);
}
app = await typedoc_1.Application.bootstrapWithPlugins();
(0, typedoc_plugin_markdown_1.load)(app);
(0, options_1.addOptions)(app);
app.renderer.render = render_1.render;
app.renderer.defineTheme('vuepress', theme_1.VuepressTheme);
project = await app.convert();
if (!project) {
return;
}
if (typedocOptions.watch) {
app.convertAndWatch(async (project) => {
app.generateDocs(project, outputDirectory);
});
}
else {
app.generateDocs(project, outputDirectory);
}
return {
name: 'vuepress-plugin-typedoc',
async enhanceAppFiles() {
const sidebarOptions = (0, options_1.getSidebarOptions)(opts);
if (!sidebarOptions.autoConfiguration) {
return;
}
const theme = app.renderer.theme;
const navigation = theme.getNavigation(project);
const sidebarJson = JSON.stringify({
[`/${path.relative(process.cwd(), typedocOptions.out)}/`]: (0, sidebar_1.getSidebarJson)(navigation, sidebarOptions, typedocOptions.out),
});
return {
name: 'typedoc-sidebar',
content: `export default ({ siteData, options }) => {
siteData.themeConfig.sidebarDepth = 0;
siteData.themeConfig.sidebar = Object.assign({},siteData.themeConfig.sidebar,${sidebarJson});
}`,
};
},
};
};