Zhicheng Wang
29 lines
984 B
JavaScript
29 lines
984 B
JavaScript
/**
|
|
* Split the description (of selected docs) into:
|
|
* * `shortDescription`: the first paragraph
|
|
* * `description`: the rest of the paragraphs
|
|
*/
|
|
module.exports = function splitDescription() {
|
|
return {
|
|
$runAfter: ['tags-extracted', 'migrateLegacyJSDocTags'],
|
|
$runBefore: ['processing-docs'],
|
|
docTypes: [],
|
|
$process(docs) {
|
|
docs.forEach(doc => {
|
|
if (this.docTypes.indexOf(doc.docType) !== -1 && doc.description !== undefined) {
|
|
const description = doc.description.trim();
|
|
const endOfParagraph = description.search(/\n\s*\n+(?!.*[\u4e00-\u9fa5])/); // 从第一个非汉字行开始拆分
|
|
if (endOfParagraph === -1) {
|
|
doc.shortDescription = description;
|
|
doc.description = '';
|
|
} else {
|
|
doc.shortDescription = description.substr(0, endOfParagraph).trim();
|
|
doc.description = description.substr(endOfParagraph).trim();
|
|
}
|
|
}
|
|
});
|
|
}
|
|
};
|
|
};
|
|
|