mirror of
https://github.com/streetwriters/notesnook.git
synced 2026-09-02 20:21:19 +02:00
69 lines
2.1 KiB
JavaScript
69 lines
2.1 KiB
JavaScript
|
/**
|
||
|
|
* Preserves a page's current text for an older version, before you change it.
|
||
|
|
*
|
||
|
|
* npm run fork -- 3.3 organizing-notes/archive-notes
|
||
|
|
* npm run fork -- 3.3 app-lock.md
|
||
|
|
*
|
||
|
|
* Run this *before* editing the page at the root. It copies today's text into
|
||
|
|
* `contents/_versions/3.3/<page>`, so v3.3 keeps describing the old behaviour
|
||
|
|
* while the root moves on. Pages you never fork stay shared — there is exactly
|
||
|
|
* one copy of them in the repo.
|
||
|
|
*
|
||
|
|
* For a page that did not exist in an older version, add its path to
|
||
|
|
* `contents/_versions/<version>/_excluded.txt` instead.
|
||
|
|
*/
|
||
|
|
import { copyFileSync, existsSync, mkdirSync, readFileSync } from "fs";
|
||
|
|
import { dirname, join, relative } from "path";
|
||
|
|
import { fileURLToPath, pathToFileURL } from "url";
|
||
|
|
|
||
|
|
const HELP = dirname(dirname(fileURLToPath(import.meta.url)));
|
||
|
|
const CONTENTS = join(HELP, "contents");
|
||
|
|
|
||
|
|
const [version, rawPage] = process.argv.slice(2);
|
||
|
|
if (!version || !rawPage) {
|
||
|
|
console.error(
|
||
|
|
"Usage: npm run fork -- <version> <page>\n" +
|
||
|
|
" e.g. npm run fork -- 3.3 organizing-notes/archive-notes"
|
||
|
|
);
|
||
|
|
process.exit(1);
|
||
|
|
}
|
||
|
|
|
||
|
|
const { ARCHIVED } = await import(
|
||
|
|
pathToFileURL(join(HELP, ".vitepress", "versions.mjs")).href
|
||
|
|
);
|
||
|
|
if (!ARCHIVED.includes(version)) {
|
||
|
|
console.error(
|
||
|
|
`v${version} is not an archived version. Archived: ${
|
||
|
|
ARCHIVED.length ? ARCHIVED.join(", ") : "(none yet)"
|
||
|
|
}`
|
||
|
|
);
|
||
|
|
process.exit(1);
|
||
|
|
}
|
||
|
|
|
||
|
|
const page = rawPage.replace(/^\/+/, "").replace(/\.md$/, "") + ".md";
|
||
|
|
const source = join(CONTENTS, page);
|
||
|
|
if (!existsSync(source)) {
|
||
|
|
console.error(`No such page: contents/${page}`);
|
||
|
|
process.exit(1);
|
||
|
|
}
|
||
|
|
|
||
|
|
const dest = join(CONTENTS, "_versions", version, page);
|
||
|
|
if (existsSync(dest)) {
|
||
|
|
console.error(
|
||
|
|
`contents/${relative(CONTENTS, dest)} already exists — v${version} already has its own copy of this page.`
|
||
|
|
);
|
||
|
|
process.exit(1);
|
||
|
|
}
|
||
|
|
|
||
|
|
mkdirSync(dirname(dest), { recursive: true });
|
||
|
|
copyFileSync(source, dest);
|
||
|
|
|
||
|
|
console.log(
|
||
|
|
[
|
||
|
|
`Forked contents/${page} → contents/${relative(CONTENTS, dest)}`,
|
||
|
|
"",
|
||
|
|
`v${version} now keeps this text. Edit contents/${page} freely — your changes`,
|
||
|
|
"apply to the latest docs only."
|
||
|
|
].join("\n")
|
||
|
|
);
|