mirror of
https://github.com/facebook/docusaurus.git
synced 2025-05-08 06:37:18 +02:00
643addb729
* feat(v2): enable JSX in markdown * reformat docs * chore(v2): nits * remove dummy test * include .mdx extension * add syntax highlighting with prismjs
73 lines
2.5 KiB
JavaScript
73 lines
2.5 KiB
JavaScript
/**
|
|
* Copyright (c) 2017-present, Facebook, Inc.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
|
|
const fm = require('front-matter');
|
|
const {getOptions} = require('loader-utils');
|
|
const path = require('path');
|
|
const {resolve} = require('url');
|
|
|
|
module.exports = function(fileString) {
|
|
const options = getOptions(this);
|
|
const {versionedDir, docsDir, translatedDir, sourceToMetadata} = options;
|
|
|
|
// Extract content of markdown (without frontmatter).
|
|
const {body} = fm(fileString);
|
|
|
|
// Determine the source dir. e.g: /docs, /website/versioned_docs/version-1.0.0
|
|
let sourceDir;
|
|
const thisSource = this.resourcePath;
|
|
if (thisSource.startsWith(translatedDir)) {
|
|
const {language, version} = sourceToMetadata[thisSource] || {};
|
|
if (language && version && version !== 'next') {
|
|
sourceDir = path.join(translatedDir, language, `version-${version}`);
|
|
} else if (language && (!version || version === 'next')) {
|
|
sourceDir = path.join(translatedDir, language);
|
|
}
|
|
} else if (thisSource.startsWith(versionedDir)) {
|
|
const {version} = sourceToMetadata[thisSource] || {};
|
|
if (version) {
|
|
sourceDir = path.join(versionedDir, `version-${version}`);
|
|
}
|
|
} else if (thisSource.startsWith(docsDir)) {
|
|
sourceDir = docsDir;
|
|
}
|
|
|
|
// Replace internal markdown linking (except in fenced blocks).
|
|
let content = body;
|
|
if (sourceDir) {
|
|
let fencedBlock = false;
|
|
const lines = body.split('\n').map(line => {
|
|
if (line.trim().startsWith('```')) {
|
|
fencedBlock = !fencedBlock;
|
|
}
|
|
if (fencedBlock) return line;
|
|
|
|
let modifiedLine = line;
|
|
// Replace inline-style links or reference-style links e.g:
|
|
// This is [Document 1](doc1.md) -> we replace this doc1.md with correct link
|
|
// [doc1]: doc1.md -> we replace this doc1.md with correct link
|
|
const mdRegex = /(?:(?:\]\()|(?:\]:\s?))(?!https)([^'")\]\s>]+\.md)/g;
|
|
let mdMatch = mdRegex.exec(modifiedLine);
|
|
while (mdMatch !== null) {
|
|
// Replace it to correct html link.
|
|
const mdLink = mdMatch[1];
|
|
const targetSource = `${sourceDir}/${mdLink}`;
|
|
const {permalink} =
|
|
sourceToMetadata[resolve(thisSource, mdLink)] ||
|
|
sourceToMetadata[targetSource] ||
|
|
{};
|
|
if (permalink) {
|
|
modifiedLine = modifiedLine.replace(mdLink, permalink);
|
|
}
|
|
mdMatch = mdRegex.exec(modifiedLine);
|
|
}
|
|
return modifiedLine;
|
|
});
|
|
content = lines.join('\n');
|
|
}
|
|
return content;
|
|
};
|