Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP: adding search to docs #37

Merged
merged 1 commit into from
Oct 14, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/cloud/faq.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
title = "FAQ and Known Limitations"
template = "cloud_main"
date = "2022-10-05T00:00:00Z"
enable_shortcodes=true
enable_shortcodes = true

---

Expand Down
1 change: 1 addition & 0 deletions content/spin/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ template = "spin_main"
date = "2022-03-14T00:22:56Z"
[extra]
url = "https://github.com/fermyon/spin/blob/main/docs/content/quickstart.md"
keywords = "quickstart"
---

> This is an early preview of the Spin project. It is still experimental code,
Expand Down
101 changes: 101 additions & 0 deletions md_parser.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
import glob from 'glob'
import fs from 'fs'
import fm from 'front-matter'
import { unified } from 'unified'
import remarkParse from 'remark-parse'
import args from 'args-parser'

// Elements that have child elements
const blockElements = ["paragraph", "blockquote", "list", "listItem", "link"]
// Elements who's value is just text
const inlineElements = ["inlineCode", "text", "code"]

function parseMdFile(file, path) {
let data = fs.readFileSync(file,
{ encoding: 'utf8', flag: 'r' });
let fmIndex = data.indexOf("---")

// Make the extra section parsable as frontmatter
if (data.slice(0, fmIndex).includes("[extra]")) {
data = data.replace("[extra]", "extra_Section: \"OK\"")
fmIndex += 12
}

// Make it valid frontmatter as per jekyll standards
let fmReplace = data.slice(0, fmIndex)
fmReplace = fmReplace.replaceAll("=", ":")
data = fmReplace + data.slice(fmIndex, -1)
data = "---\n\n" + data

// Parse markdown into json tree
let content = fm(data)
let myResult = unified()
.use(remarkParse)
.parse(content.body);

// Create default document index for the page
let documentIndex = { project: file.split("/")[2], title: content.attributes["title"], subheading: "", content: "", keywords: content.attributes["keywords"], url: "/" + file.replace(path, "") }
let searchIndex = []

// For each heading create a new search index
myResult.children.map(k => {
if (!(k.type == "heading")) {
// If inline element just append content
if (inlineElements.includes(k.type)) {
documentIndex.content = documentIndex.content.concat(k.value)
} else {
if (blockElements.includes(k.type)) {
k.children.map(inlineElement => {
documentIndex.content = documentIndex.content.concat(inlineElement.value)
})
}
}
} else {
// If new heading create a new index
searchIndex.push(documentIndex)

let subtitle = k.children.map(k => {
if (k.children) {
return k.children[0].value
}
return k.value
})
subtitle = subtitle.join(" ")

documentIndex = {
project: file.split("/")[2],
title: content.attributes["title"], subheading: subtitle, content: "", keywords: content.attributes["keywords"],
url: "/" + file.replace(path, "") + "#" + subtitle.toLowerCase().replace(/[`~!@#$%^&*()_|+\-=?;:'",.<>\{\}\[\]\\\/]/g, '')
.replace(/ +/g, '-')
}
}
})
// If there are unpushed document index push it
if (documentIndex.content) {
searchIndex.push(documentIndex)
}
return searchIndex
}

function main() {
const argparse = args(process.argv)
if (!argparse.dir || !argparse.out) {
console.error("--dir and --out must be specified")
return
}

let consolidatedSearchIndex = []

glob(argparse.dir + '/**/*.md', (err, files) => {
if (err) {
console.log('Error', err)
} else {
files.forEach(file => {
consolidatedSearchIndex = consolidatedSearchIndex.concat(parseMdFile(file, argparse.dir))
})
}
fs.writeFileSync(argparse.out, JSON.stringify(consolidatedSearchIndex));
})
}

main()
Loading