The documentation is built on Gridsome, a static site generator with a Vue frontend.
- Node 12+
npm i
This will install all dependencies needed to run the project.
npm start
This will start a dev-server on http://localhost:8080. All markdown and HTML changes made will automatically hot reload to the browser, however config changes in the gridsome.config.js
needs a server restart. Simply stop the server and restart it with npm start
.
The underlying datastructure for the markdown files are accessible through Explore GraphQL at http://localhost:8080/__explore. These are the data documents that are used for generating the built pages, and can be accessed and create more meta for the documentation.
All content is found in the content
-folder, and its path is created hierarchically according to the folder structure. We're also welcoming to edits, so all markdown pages have an automatic "edit this page" link added to them, which leads directly to github for creating pull requests.
All menu entries is found in gridsome.config.js
, and can be customized as you want. For options, check out the docc documentation for sidebars.
npm run build
This will generate a dist
-folder with the fully statically built site. This can be deployed and hosted to whatever CDN of your choosing.
The documentation is built on Gridsome.
Docc documentation (the template this theme is based on) can be found here.
As we now basically have a vue application, we can now create dynamic content which uses our APIs directly from our documentation. Features such as listing actual data from the logged in user is possible, and we shall see how much we'll expand upon this.