Pete Bacon Darwin 9491318c26 build(docs-infra): move docs-watch settings to a base package (#40479)
This new `base-authoring-package` captures all the settings, which
turns of potentially fatal checks, in one place. This new package is
then used as a base for all the docs-watch related packages, rather
than dotting the settings in a variety of different packages. This also
has the benefit that the standard configuration for doc-gen is fatal
on failed checks by default.

PR Close #40479
2021-01-20 16:12:15 -08:00

44 lines
1.5 KiB
JavaScript

/**
* @license
* Copyright Google LLC All Rights Reserved.
*
* Use of this source code is governed by an MIT-style license that can be
* found in the LICENSE file at https://angular.io/license
*/
const {resolve} = require('canonical-path');
const Package = require('dgeni').Package;
const {readFileSync} = require('fs');
const contentPackage = require('../angular-content-package');
const {CONTENTS_PATH} = require('../config');
const baseAuthoringPackage = require('./base-authoring-package');
const {codeExampleMatcher} = require('./utils');
/* eslint no-console: "off" */
function createPackage(tutorialName) {
const tutorialFilePath = `${CONTENTS_PATH}/tutorial/${tutorialName}.md`;
const tutorialFile = readFileSync(tutorialFilePath, 'utf8');
const examples = [];
tutorialFile.replace(codeExampleMatcher, (_, path) => examples.push('examples/' + path));
if (examples.length) {
console.log('The following example files are referenced in this tutorial:');
console.log(examples.map(example => ' - ' + example).join('\n'));
}
return new Package('author-tutorial', [baseAuthoringPackage, contentPackage]).config(function(readFilesProcessor) {
readFilesProcessor.sourceFiles = [
{basePath: CONTENTS_PATH, include: tutorialFilePath, fileReader: 'contentFileReader'}, {
basePath: CONTENTS_PATH,
include: examples.map(example => resolve(CONTENTS_PATH, example)),
fileReader: 'exampleFileReader'
}
];
});
}
module.exports = {createPackage};