Refactor docs, make a new website.

* Docs have been migrated from docbook to yaml + jinja2 + pandoc
* Created a new (basic) website for docs based on React + Tailwinds

web/utils/mdx-utils.ts

@@ -0,0 +1,96 @@
+import fs from 'fs'
+import path from 'path'
+import matter from 'gray-matter'
+import { serialize } from 'next-mdx-remote/serialize'
+import rehypePrism from '@mapbox/rehype-prism'
+import remarkGfm from 'remark-gfm'
+
+// DOCUMENTS_PATH is useful when you want to get the path to a specific file
+export const DOCUMENTS_PATH = path.join(process.cwd(), 'documents')
+
+// documentFilePaths is the list of all mdx files inside the DOCUMENTS_PATH directory
+export const documentFilePaths = fs
+  .readdirSync(DOCUMENTS_PATH)
+  // Only include md(x) files
+  .filter((path) => /\.mdx?$/.test(path))
+
+export interface Document {
+  content: string
+  data: any
+  filePath: string
+}
+
+export const getDocuments = (): Document[] => {
+  let documents = documentFilePaths.map((filePath) => {
+    const source = fs.readFileSync(path.join(DOCUMENTS_PATH, filePath), 'utf-8')
+    const { content, data } = matter(source)
+
+    return {
+      content,
+      data,
+      filePath,
+    }
+  })
+
+  return documents
+}
+
+export const getDocumentBySlug = async (slug: string) => {
+  const documentFilePath = path.join(DOCUMENTS_PATH, `${slug}.mdx`)
+  const source = fs.readFileSync(documentFilePath, 'utf-8')
+
+  const { content, data } = matter(source)
+
+  const mdxSource = await serialize(content, {
+    // Optionally pass remark/rehype plugins
+    mdxOptions: {
+      remarkPlugins: [remarkGfm],
+      rehypePlugins: [rehypePrism],
+    },
+    scope: data,
+  })
+
+  return { mdxSource, data, documentFilePath }
+}
+
+export const getNextDocumentBySlug = (slug: string) => {
+  const documents = getDocuments()
+  const currentFileName = `${slug}.mdx`
+  const currentDocument = documents.find(
+    (document) => document.filePath === currentFileName
+  )
+  if (!currentDocument) return null
+  const currentDocumentIndex = documents.indexOf(currentDocument)
+
+  const document = documents[currentDocumentIndex - 1]
+  // no prev document found
+  if (!document) return null
+
+  const nextDocumentSlug = document?.filePath.replace(/\.mdx?$/, '')
+
+  return {
+    title: document.data.title,
+    slug: nextDocumentSlug,
+  }
+}
+
+export const getPreviousDocumentBySlug = (slug: string) => {
+  const documents = getDocuments()
+  const currentFileName = `${slug}.mdx`
+  const currentDocument = documents.find(
+    (document) => document.filePath === currentFileName
+  )
+  if (!currentDocument) return null
+  const currentDocumentIndex = documents.indexOf(currentDocument)
+
+  const document = documents[currentDocumentIndex + 1]
+  // no prev document found
+  if (!document) return null
+
+  const previousDocumentSlug = document?.filePath.replace(/\.mdx?$/, '')
+
+  return {
+    title: document.data.title,
+    slug: previousDocumentSlug,
+  }
+}