docusaurus/lib/version.js
2017-08-03 10:25:01 -07:00

116 lines
3.1 KiB
JavaScript

#!/usr/bin/env node
/**
* Copyright (c) 2017-present, Facebook, Inc.
* All rights reserved.
*
* This source code is licensed under the BSD-style license found in the
* LICENSE file in the root directory of this source tree. An additional grant
* of patent rights can be found in the PATENTS file in the same directory.
*/
const CWD = process.cwd();
const glob = require("glob");
const fs = require("fs-extra");
const path = require("path");
const mkdirp = require("mkdirp");
const semver = require("semver");
const readMetadata = require("./server/readMetadata.js");
const versionFallback = require("./server/versionFallback.js");
const ENABLE_TRANSLATION = fs.existsSync(CWD + "/languages.js");
let version;
const program = require("commander");
program
.arguments("<version>")
.action(ver => {
version = ver;
})
.parse(process.argv);
if (typeof version === "undefined") {
console.error(
"No version number specified!\nPass the version you wish to create as an argument.\nEx: 1.0.0"
);
process.exit(1);
}
if (!(version = semver.valid(version))) {
console.error(
"Invalid version!\nSpecify a valid version following the specifications at http://semver.org/."
);
process.exit(1);
}
function makeHeader(metadata) {
let header = "---\n";
Object.keys(metadata).forEach(key => {
header += key + ": " + metadata[key] + "\n";
});
header += "---\n";
return header;
}
let versionFolder = CWD + "/versioned_docs/version-" + version;
if (ENABLE_TRANSLATION) {
versionFolder = CWD + "/versioned_docs/en/version-" + version;
}
mkdirp.sync(versionFolder);
let files = glob.sync(CWD + "/../docs/*");
files.forEach(file => {
const ext = path.extname(file);
if (ext !== ".md" && ext !== ".markdown") {
return;
}
const res = readMetadata.extractMetadata(fs.readFileSync(file, "utf8"));
let metadata = res.metadata;
let rawContent = res.rawContent;
if (!metadata.id) {
return;
}
if (!versionFallback.diffLatestDoc(file, metadata.id)) {
return;
}
metadata.original_id = metadata.id;
metadata.id = "version-" + version + "-" + metadata.id;
let targetFile =
CWD + "/versioned_docs/version-" + version + "/" + path.basename(file);
if (ENABLE_TRANSLATION) {
targetFile = CWD + "/versioned_docs/en/version-" + version + "/" + path.basename(file);
}
fs.writeFileSync(targetFile, makeHeader(metadata) + rawContent, "utf8");
});
if (versionFallback.diffLatestSidebar()) {
mkdirp(CWD + "/versioned_sidebars");
const sidebar = JSON.parse(fs.readFileSync(CWD + "/sidebar.json", "utf8"));
const versioned = {};
Object.keys(sidebar).forEach(sb => {
const version_sb = "version-" + version + "-" + sb;
versioned[version_sb] = {};
const categories = sidebar[sb];
Object.keys(categories).forEach(category => {
versioned[version_sb][category] = [];
const ids = categories[category];
ids.forEach((id, index) => {
versioned[version_sb][category].push("version-" + version + "-" + id);
});
});
});
fs.writeFileSync(
CWD + "/versioned_sidebars/version-" + version + "-sidebar.json",
JSON.stringify(versioned, null, 2),
"utf8"
);
}