Giter Site home page Giter Site logo

docs's Introduction

Getting Started

  1. Install Bun

  2. Install dependencies

    bun install

  3. Run the development server

    bun run dev

  4. Open http://localhost:3000 with your browser to see the result.

Developing Guide

This docs site is built with Nextra

Adding a new page

Each docs page is created from a .mdx file. To add a new page, create a new .mdx file in the pages directory. The file name will be the URL path.

For example, pages/docs/getting-started.mdx will be available at /docs/getting-started.

Changing page metadata

In order to change the page's title or placement on the left hand sidebar, you need to create a _meta.json file in the same directory as the .mdx file.

Read more about Nextra's _meta.json files.

Read more about Nextra's docs theme.

If we had a page /pages/docs/getting-started.mdx, we could add a _meta.json file to change the title and make it the first entry in the sidebar.

{
  "getting-started": {
    "title": "Getting Started - Overview"
  },
  "other-page": "Other Page"
}

Note how the key in the json object matches the file name. This is how Nextra knows which page to apply the metadata to.

If the value is a json object, you can set multiple parameters. If it's a string, it will just change the title.

docs's People

Contributors

adamgfraser avatar jczuchnowski avatar jorge-vasquez-2301 avatar nicoburniske avatar vigoo avatar

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.