Giter VIP home page Giter VIP logo

vike-docs-template's Introduction

vike-docs-template

Docs

A simple template to easily deploy MDX files.

Getting started

  • Clone the repository or create a repository from the template.
  • pnpm i
  • pnpm dev

Notes

  • Uses mdx-butler
  • Author mdx files in a docs folder or with any file pattern.
  • File and frontmatter based routing
  • A Perfect lighthouse score.
  • Support for MDX syntax in descriptions, table of contents, headings and more.
  • 100% static output, resulting in an easy and blazingly fast Deployment to GitHub Pages, Cloudflare Pages, Netlify, AWS and many other hosting providers.
  • Full support for custom components and snippets. Import anything in your documents, all files will be bundled in parallel with mdx-bundler and esbuild.
  • Unopinionated styling. Easily add Global CSS, a custom tailwind config or other styling solutions.
  • Fully Functional responsive layout and neutral color styling out of the box.
  • No bloat - just the basics with a focus on only adding light-weight dependencies.
  • Easy to add analytics, search or other third party implementations.
  • Uses vike + preact for a small client bundle size (~45kb zipped).
  • Unpic to handle Images.
  • prettier and eslint configuration for automatic linting and formatting of files, including MDX documents and Code blocks.

Performance

Lighthouse results

Security Notice

Caution

MDX is javascript. If not carefully done, evaluating user content can expose to XSS attacks.

Always be careful if you are not evaluating your own content.

vike-docs-template's People

Contributors

nicozweifel avatar

Stargazers

Tim Schupp avatar  avatar Chris Van Pelt avatar Jean-philippe Martel avatar Aurélien Lourot avatar  avatar

Watchers

 avatar

vike-docs-template's Issues

Unify and rework/improve `navItems`/`navTree` in `navGenerator`

Unify and rework/improve navGenerator to return combined object and adjust navItems/navTree to use/return maps/indexes.

  • use a map or index access instead of find and filter in nested anonymous functions (createNavNode) that take an object reference.
  • combine navItems and navTree into one object in navGenerator and pageProps that supports traversing of the tree and index access of lowercase paths.
  • use/update navGenerator.test.ts

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.