Port to Vitepress

.gitignore

@@ -1,5 +1,6 @@
 .uuid
 .vscode
+package-lock.json
 *.stats.html
 /bin/
 /dist/
@@ -9,3 +10,6 @@
 /test/test-results.xml
 /test/screenshots/test-results.xml
 /.nyc_output/
+/.vitepress
+/docs/.vitepress/cache/
+/docs/public/latexjs/

docs/.vitepress/config.mts

@@ -0,0 +1,65 @@
+import { defineConfig } from 'vitepress'
+import { fileURLToPath } from 'url'
+import path from 'path'
+import string from 'vite-plugin-string'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  title: 'LaTeX.js',
+  description: 'A LaTeX parser written in JavaScript.',
+
+  outDir: '../website', 
+
+  head: [
+    ['link', { 
+      rel: 'icon', 
+      href: 'data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAAIAAAACAAAAAgAAAAIAAAACAAAAAQAAAAAAAAABAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAABAAAAAAAAAAAAAAAAAAAAAAAAAABJScL/SUnC/0lJwv8AAAAAAAAAAElJwv9JScL/SUnC/wAAAAAAAAABAAAAAwAAAAEAAAAAAAAAAAAAAABJScL/SUnC/wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAElJwv9JScL/AAAAAgAAAAUAAAADAAAAAAAAAAAAAAAASUnC/0lJwv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABJScL/SUnC/wAAAAIAAAAIAAAABAAAAAAAAAAAAAAAAElJwv9JScL/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASUnC/0lJwv8AAAACAAAACgAAAAYAAAAAAAAAAAAAAABJScL/SUnC/wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAElJwv9JScL/AAAAAgAAAAsAAAAIAAAAAAAAAAAAAAAASUnC/0lJwv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABJScL/SUnC/wAAAAMAAAAJAAAACAAAAABJScL/SUnC/0lJwv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAElJwv9JScL/SUnC/wAAAAgAAAAAAAAAAAAAAABJScL/SUnC/wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAElJwv9JScL/AAAAAQAAAAQAAAAHAAAAAAAAAAAAAAAASUnC/0lJwv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABJScL/SUnC/wAAAAIAAAAEAAAABQAAAAAAAAAAAAAAAElJwv9JScL/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASUnC/0lJwv8AAAABAAAABAAAAAMAAAAAAAAAAAAAAABJScL/SUnC/wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAElJwv9JScL/AAAAAAAAAAMAAAACAAAAAAAAAAAAAAAASUnC/0lJwv8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABJScL/SUnC/wAAAAEAAAACAAAAAAAAAAEAAAAAAAAAAAAAAABJScL/SUnC/0lJwv8AAAAAAAAAAElJwv9JScL/SUnC/wAAAAAAAAABAAAAAAAAAAAAAAAYAAAAFwAAABYAAAATAAAAEQAAAA0AAAALAAAACQAAAAcAAAADAAAAAwAAAAMAAAABAAAAAAAAAAAAAAAA8BMAAP/5AADxiAAA5+AAAOfgAADn4AAA5+AAAOfgAACP8AAA5+AAAOfgAADn4AAA5+QAAOfhAABxiwAAAAcAAA==' 
+    }],
+    ['link', { rel: 'stylesheet', href: '/css/error.css' }],
+    ['link', { rel: 'stylesheet', href: '/css/logos.css' }]
+  ],
+
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    logo: '/img/latexjs.png',
+
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Guide', link: '/usage' },
+      { text: 'Playground', link: '/playground' },
+      { text: 'ChangeLog', link: 'https://github.com/michael-brade/LaTeX.js/releases' },
+      { text: 'GitHub', link: 'https://github.com/michael-brade/LaTeX.js' },
+    ],
+
+    sidebar: [
+      { text: 'Home', link: '/' },
+      { text: 'Usage', link: '/usage' },
+      { text: 'API', link: '/api' },
+      { text: 'Extending', link: '/extending' },
+      { text: 'Limitations', link: '/limitations' }
+    ],
+  },
+
+  // Enable markdown line breaks
+  markdown: {
+    breaks: true
+  },
+
+  // Vite-specific configuration
+  vite: {
+    plugins: [
+      // Plugin to import .tex files as strings
+      string({
+        include: '**/*.tex',
+      })
+    ],
+    resolve: {
+      alias: {
+        // Alias to find theme components
+        '@theme/components': path.resolve(__dirname, './theme/components')
+      }
+    }
+  }
+})

docs/.vitepress/theme/Layout.vue

@@ -0,0 +1,37 @@
+<template>
+  <DefaultTheme.Layout>
+    <template #navbar-brand>
+      <a href="/" class="navbar-brand-link">
+        <img
+          vPreload
+          class="logo"
+          src="/img/latexjs.png"
+          alt="LaTeX.js Logo"
+        />
+        <LaTeX />.js
+      </a>
+    </template>
+  </DefaultTheme.Layout>
+</template>
+
+<script setup>
+import DefaultTheme from 'vitepress/theme'
+import LaTeX from './components/LaTeX.vue'
+</script>
+
+<style scoped>
+/* Style to match old home-link */
+.navbar-brand-link {
+  display: flex;
+  align-items: center;
+  font-family: 'Liberation Serif', serif;
+  font-size: 1.5rem;
+  font-weight: 500;
+}
+.logo {
+  height: 2rem;
+  padding-bottom: 0.2rem;
+  vertical-align: middle;
+  margin-right: 0.8rem;
+}
+</style>

docs/.vitepress/theme/components/LaTeX.vue

@@ -0,0 +1,24 @@
+<template>
+  <span class="latex">L<span>a</span>T<span>e</span>X</span>
+</template>
+
+<style scoped>
+/* LaTeX logo */
+.latex span {
+  text-transform: uppercase;
+}
+
+.latex span:first-child {
+  font-size: 0.8em;
+  vertical-align: 0.2em;
+  margin-left: -0.4em;
+  margin-right: -0.1em;
+}
+
+.latex span:last-child {
+  margin-left: -0.2em;
+  margin-right: -0.1em;
+  position: relative;
+  top: 0.45ex;
+}
+</style>