angular-cn/aio/tools/transforms/angular-api-package/processors/splitDescription.js

/**
 * 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'],
    $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();
          }
        }
      });
    }
  };
};