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.

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.