mirror of
https://github.com/silverstripe/doc.silverstripe.org
synced 2024-09-07 18:21:32 +02:00
166 lines
4.5 KiB
JavaScript
166 lines
4.5 KiB
JavaScript
const path = require('path');
|
|
const fs = require('fs');
|
|
const { createFilePath } = require(`gatsby-source-filesystem`);
|
|
const fileToTitle = require('./src/utils/fileToTitle');
|
|
|
|
const createSlug = ({path, version, thirdparty}) => {
|
|
const rest = path.split('/');
|
|
const parts = [
|
|
'en',
|
|
version,
|
|
// thirdparty modules are explicitly pathed
|
|
thirdparty,
|
|
...rest,
|
|
].filter(p => p);
|
|
|
|
const slug = parts
|
|
.map(part => part.replace(/^\d+_/, ''))
|
|
.join('/')
|
|
.toLowerCase();
|
|
|
|
return `/${slug}/`;
|
|
};
|
|
|
|
const parseName = name => name.split('--');
|
|
|
|
exports.onCreateNode = async ({ node, getNode, getNodesByType, actions, createNodeId, createContentDigest }) => {
|
|
if (node.internal.type !== 'MarkdownRemark') {
|
|
return;
|
|
}
|
|
const { createNode } = actions;
|
|
const fileNode = getNode(node.parent);
|
|
const [category, version, thirdparty] = parseName(fileNode.sourceInstanceName);
|
|
|
|
// The gatsby-sgatsbource-filesystem plugins are registered to collect from the same path
|
|
// that the git source writes to, so we get the watch task (hot reload on content changes)
|
|
// But we don't want duplicate document pages for each source plugin, so
|
|
// we bail out if we already have the file. However, we need to ensure
|
|
// the file is injected into the template as a dependency, so when the content changes,
|
|
// the pages get refreshed on the fly.
|
|
if (category === 'watcher') {
|
|
const existing = getNodesByType('SilverstripeDocument')
|
|
.find(n => n.fileAbsolutePath === node.fileAbsolutePath);
|
|
|
|
if (existing) {
|
|
// Pair the document with its watched file so we can inject it into the template
|
|
// as a dependency.
|
|
existing.watchFile___NODE = node.id;
|
|
}
|
|
return;
|
|
}
|
|
const basePath = category === 'user' ? 'docs/en/userguide' : (thirdparty ? 'docs/en' : 'en');
|
|
const filePath = createFilePath({
|
|
node,
|
|
getNode,
|
|
basePath,
|
|
});
|
|
let fileTitle = path.basename(node.fileAbsolutePath, '.md');
|
|
const isIndex = fileTitle === 'index';
|
|
if (isIndex) {
|
|
fileTitle = path.basename(path.dirname(node.fileAbsolutePath));
|
|
}
|
|
const docTitle = fileToTitle(fileTitle);
|
|
const slug = createSlug({
|
|
path: filePath,
|
|
version,
|
|
thirdparty,
|
|
});
|
|
|
|
const parentSlug = `${path.resolve(slug, '../')}/`;
|
|
const unhideSelf = false;
|
|
|
|
// Most of these don't exist in userhelp, so force them into the schema by un-nulling them.
|
|
const frontmatter = {
|
|
introduction: ``,
|
|
icon: `file-alt`,
|
|
iconBrand: ``,
|
|
hideChildren: false,
|
|
...node.frontmatter,
|
|
};
|
|
|
|
const docData = {
|
|
isIndex,
|
|
filePath,
|
|
fileTitle,
|
|
slug,
|
|
parentSlug,
|
|
unhideSelf,
|
|
category,
|
|
...frontmatter,
|
|
};
|
|
|
|
if (!docData.title || docData.title === '') {
|
|
docData.title = docTitle;
|
|
}
|
|
|
|
const docInternal = {
|
|
type: `SilverstripeDocument`,
|
|
contentDigest: createContentDigest({
|
|
...docData,
|
|
rawMarkdownBody: node.rawMarkdownBody,
|
|
}),
|
|
};
|
|
const nodeData = {
|
|
...node,
|
|
id: createNodeId(`SilverstripeDocument${node.id}`),
|
|
...docData,
|
|
parent: node.id,
|
|
internal: docInternal,
|
|
}
|
|
createNode(nodeData);
|
|
};
|
|
|
|
|
|
exports.createPages = async ({ actions, graphql, getNodesByType }) => {
|
|
const { createPage, createRedirect } = actions;
|
|
|
|
const docTemplate = path.resolve(`src/templates/docs-template.tsx`);
|
|
const result = await graphql(`
|
|
{
|
|
allSilverstripeDocument {
|
|
nodes {
|
|
id
|
|
slug
|
|
}
|
|
}
|
|
}`);
|
|
|
|
|
|
if (result.errors) {
|
|
throw new Error(result.errors);
|
|
}
|
|
result.data.allSilverstripeDocument.nodes
|
|
.forEach(node => {
|
|
createPage({
|
|
path: node.slug,
|
|
component: docTemplate,
|
|
context: {
|
|
id: node.id,
|
|
slug: node.slug,
|
|
}
|
|
});
|
|
})
|
|
|
|
|
|
console.log(`Creating legacy redirects...`);
|
|
const redirects = new Map();
|
|
const v5docs = getNodesByType('SilverstripeDocument').filter(n => n.slug.match(/^\/en\/5\//));
|
|
const v4docs = getNodesByType('SilverstripeDocument').filter(n => n.slug.match(/^\/en\/4\//));
|
|
const v3docs = getNodesByType('SilverstripeDocument').filter(n => n.slug.match(/^\/en\/3\//));
|
|
|
|
[...v5docs, ...v4docs, ...v3docs].forEach(n => {
|
|
const legacy = n.slug.replace(/^\/en\/[0-9]\//, '/en/');
|
|
if (legacy === '/en/') {
|
|
return;
|
|
}
|
|
if (!redirects.has(legacy)) {
|
|
redirects.set(legacy, n.slug);
|
|
}
|
|
});
|
|
redirects.forEach((toPath, fromPath) => {
|
|
createRedirect({ fromPath, toPath, isPermanent: true });
|
|
});
|
|
|
|
|
|
|
|
}; |