Doks is a full-featured documentation theme built on top of the Hyas framework. This guide will help you get started with a new project. See the manual setup instructions to add Doks to an existing Hyas project.
Create a new project
Create a new Hyas + Doks project by running the following command in your terminal:
This will create a new project directory with all the necessary files and configurations for your site.
See it in action
Try Doks in your browser: open the template on Gitpod.
Start the development server
When working locally, Hugo’s development server lets you preview your work and automatically refreshes your browser when you make changes.
Inside your project directory, run the following command to start the development server:
This will log a message to your terminal with the URL of your local preview. Open this URL to start browsing your site.
Doks is ready for you to add new content, or bring your existing files!
Doks supports authoring content in Markdown and HTML with no configuration required. You can add support for Emacs Org-Mode, AsciiDoc, RST, and Pandoc by installing additional parsers.
Add new pages to your site by creating
.html files in
content/docs/. Use sub-folders to organize your files and to create multiple path segments.
For example, the following command will generate a page at
All Doks pages share a customizable common set of frontmatter properties to control how the page appears — for documentation pages:
--- title: "Example Guide" description: "" summary: "" date: 2023-09-07T16:04:48+02:00 lastmod: 2023-09-07T16:04:48+02:00 draft: true menu: docs: parent: "" identifier: "example-6a1a6be4373e933280d78ea53de6158e" weight: 999 toc: true seo: title: "" # custom title (optional) description: "" # custom description (recommended) canonical: "" # custom canonical URL (optional) noindex: false # false (default) or true ---
- Configure: Learn about common options in “Customizing Doks”.
- Navigate: Set up your sidebar with the “Sidebar Navigation” guide.
- Shortcodes: Discover built-in callouts, tabs, and more in the “Shortcodes” guide.
- Deploy: Publish your work with the “Deploy your site” guide in the Hyas docs.
Doks is a Hyas theme, and is updated like any
@hyas/* theme (or integration):
See the Doks changelog for a full list of the changes made in each release.
Use the project configuration and individual page frontmatter configuration reference pages to ensure that your Doks site is configured and functioning properly. See the guides in the sidebar for help adding content and customizing your Doks site.
If your answer cannot be found in these docs, please visit the full Hyas Docs for complete Hyas documentation. Your question may be answered by understanding how Hyas works in general, underneath this Doks theme.