index.js

var fs = require('fs');
var path = require('path');
var slash = require('slash');
var { spawn } = require('child_process');
var del = require('del');
var preconfigs = require('./preconfig.json');

let getPath = p => {
    return slash(path.isAbsolute(p) ? p : path.join(process.cwd(), p));
}

let getEnvironmentVariables = conigPath => {
    return fs.existsSync(conigPath) ? JSON.parse(fs.readFileSync(conigPath)) : {};
}


exports.buildDocfx = (options = {
    projectDir: '',
    environment: '',
    siteDir: ''
}) => {

    if (!options.projectDir) {
        throw new Error("The directory of the docfx project must be specified.");
    }

    const globalPreconfigs = preconfigs;
    let docfxJsonPath = path.normalize(path.join(getPath(options.projectDir), 'docfx.json'));
    let docfxPreconfigPath = path.normalize(path.join(getPath(options.projectDir), 'environment.json'));
    let docfxGlobalConfigPath = path.normalize(path.join(getPath(options.projectDir), 'global.json'));
    let globalConfigs = getEnvironmentVariables(docfxGlobalConfigPath);
    let environmentConfigs = getEnvironmentVariables(docfxPreconfigPath);
    let applyWarnAsErr = ``;
    environmentConfigs.environment = options.environment || 'development';

    globalPreconfigs['variables'] = environmentConfigs[environmentConfigs.environment];

    if (fs.existsSync(getPath(options.siteDir))) {
        del.sync(getPath(options.siteDir));
    }

    fs.mkdirSync(`${getPath(options.siteDir)}`);

    fs.writeFileSync(
        getPath(`${options.siteDir}/${globalPreconfigs._configFileName}`),
        JSON.stringify(globalPreconfigs)
    );

    console.log(`Starting docfx build for: ${getPath(options.projectDir)}`);

    if (globalConfigs._useWarningsAsErrors) {
        applyWarnAsErr = `--warningsAsErrors`;
    }

    return spawn("dotnet", ["docfx", "build", applyWarnAsErr, `${path.normalize(getPath(docfxJsonPath))}`], { stdio: 'inherit' }).on('exit', (err) => {
        if (err === 4294967295) {
            console.log(`\x1b[31m`, `------------------------------------------------------------------------------------`);
            console.log(`--------------------------- Bookmark/Hyperlink Errors -----------------------------`);
            console.log(`-----------------------------------------------------------------------------------`);
            console.log();
            console.error(`              Build failed with bookmark warnings marked in yellow above!        `);
            console.error(`These warnings indicate the specific topic and link that points to the code line.`);
            console.log();
            console.log(`-----------------------------------------------------------------------------------`);
            console.log(`--------------------------- Error Code ` + err + ` ---------------------------------`);
            console.log(`-----------------------------------------------------------------------------------`, `\x1b[0m`);
            console.log();
        } else {
            console.log('Exiting code with Error: ' + err);
        }
    }).on('close', (err) => {
        if (err) {
            console.error(err);
        } 
    });
}