golemcloud / docs

Golem Cloud Documentation
https://learn.golem.cloud
8 stars 7 forks source link

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.