import esbuild from 'esbuild'
|
import remarkParse from 'remark-parse'
|
import remarkRehype from 'remark-rehype'
|
import { Processor, unified } from "unified"
|
import { Root as MDRoot } from 'remark-parse/lib'
|
import { Root as HTMLRoot } from 'hast'
|
import { ProcessedContent } from '../plugins/vfile'
|
import { PerfTimer } from '../perf'
|
import { read } from 'to-vfile'
|
import { slugify } from '../path'
|
import path from 'path'
|
import os from 'os'
|
import workerpool, { Promise as WorkerPromise } from 'workerpool'
|
import { QuartzTransformerPluginInstance } from '../plugins/types'
|
import { QuartzLogger } from '../log'
|
import chalk from 'chalk'
|
|
export type QuartzProcessor = Processor<MDRoot, HTMLRoot, void>
|
export function createProcessor(transformers: QuartzTransformerPluginInstance[]): QuartzProcessor {
|
// base Markdown -> MD AST
|
let processor = unified().use(remarkParse)
|
|
// MD AST -> MD AST transforms
|
for (const plugin of transformers) {
|
processor = processor.use(plugin.markdownPlugins())
|
}
|
|
// MD AST -> HTML AST
|
processor = processor.use(remarkRehype, { allowDangerousHtml: true })
|
|
|
// HTML AST -> HTML AST transforms
|
for (const plugin of transformers) {
|
processor = processor.use(plugin.htmlPlugins())
|
}
|
|
return processor
|
}
|
|
function* chunks<T>(arr: T[], n: number) {
|
for (let i = 0; i < arr.length; i += n) {
|
yield arr.slice(i, i + n)
|
}
|
}
|
|
async function transpileWorkerScript() {
|
// transpile worker script
|
const cacheFile = "./.quartz-cache/transpiled-worker.mjs"
|
const fp = "./quartz/worker.ts"
|
return esbuild.build({
|
entryPoints: [fp],
|
outfile: path.join("quartz", cacheFile),
|
bundle: true,
|
keepNames: true,
|
platform: "node",
|
format: "esm",
|
packages: "external",
|
plugins: [
|
{
|
name: 'css-and-scripts-as-text',
|
setup(build) {
|
build.onLoad({ filter: /\.scss$/ }, (_) => ({
|
contents: '',
|
loader: 'text'
|
}))
|
build.onLoad({ filter: /\.inline\.(ts|js)$/ }, (_) => ({
|
contents: '',
|
loader: 'text'
|
}))
|
}
|
}
|
]
|
})
|
}
|
|
export function createFileParser(baseDir: string, fps: string[], verbose: boolean) {
|
return async (processor: QuartzProcessor) => {
|
const res: ProcessedContent[] = []
|
for (const fp of fps) {
|
try {
|
const file = await read(fp)
|
|
// base data properties that plugins may use
|
file.data.slug = slugify(path.relative(baseDir, file.path))
|
file.data.filePath = fp
|
|
const ast = processor.parse(file)
|
const newAst = await processor.run(ast, file)
|
res.push([newAst, file])
|
|
if (verbose) {
|
console.log(`[process] ${fp} -> ${file.data.slug}`)
|
}
|
} catch (err) {
|
console.log(chalk.red(`\nFailed to process \`${fp}\`: `) + err)
|
process.exit(1)
|
}
|
}
|
|
return res
|
}
|
}
|
|
export async function parseMarkdown(transformers: QuartzTransformerPluginInstance[], baseDir: string, fps: string[], verbose: boolean): Promise<ProcessedContent[]> {
|
const perf = new PerfTimer()
|
const log = new QuartzLogger(verbose)
|
|
const CHUNK_SIZE = 128
|
let concurrency = fps.length < CHUNK_SIZE ? 1 : os.availableParallelism()
|
let res: ProcessedContent[] = []
|
|
log.start(`Parsing input files using ${concurrency} threads`)
|
if (concurrency === 1) {
|
// single-thread
|
const processor = createProcessor(transformers)
|
const parse = createFileParser(baseDir, fps, verbose)
|
res = await parse(processor)
|
} else {
|
await transpileWorkerScript()
|
const pool = workerpool.pool(
|
'./quartz/bootstrap-worker.mjs',
|
{
|
minWorkers: 'max',
|
maxWorkers: concurrency,
|
workerType: 'thread'
|
}
|
)
|
|
const childPromises: WorkerPromise<ProcessedContent[]>[] = []
|
for (const chunk of chunks(fps, CHUNK_SIZE)) {
|
childPromises.push(pool.exec('parseFiles', [baseDir, chunk, verbose]))
|
}
|
|
const results: ProcessedContent[][] = await WorkerPromise.all(childPromises)
|
res = results.flat()
|
await pool.terminate()
|
}
|
|
log.success(`Parsed ${res.length} Markdown files in ${perf.timeSince()}`)
|
return res
|
}
|
