Welcome to docs.page!
Get started with docs.page
Welcome to docs.page! The init command you just ran has created a basic file struture in your project to help you get started.
Configuration
In the root of your directory a new docs.json
file has been created. This file is used to configure your documentation site. You can customize the name, description, and sidebar, theme, logos and more using this file.
Here's a basic example of what the file looks like:
{
"name": "My Docs",
"description": "My documentation site",
"sidebar": [
{
"group": "Getting Started",
"pages": [
{
"title": "Getting to know docs.page",
"href": "/",
"icon": "rocket"
},
{
"title": "Next Steps",
"href": "/next-steps",
"icon": "arrow-right"
}
]
}
]
}
To learn more about the advanced configuration options, check out the docs.
Content
docs.page uses the docs
directory to store your documentation pages. Two pages have been created for you:
index.mdx
- The home page of your documentation site, resolves to the root URL.next-steps.mdx
- A page to help you get started with docs.page, resolves to/next-steps
.
Documentation can be written using the standard GitHub Flavored Markdown Spec and also supports the use of MDX, with the ability to render custom components for more advanced use cases.
Preview
To preview your documentation site, head over to https://docs.page/preview in your browser and open this directory.
Previewing your documentation site will allow you to see the changes you make in real-time before you publish to the world.