Doks is a Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready — by default.
![Doks — Modern Documentation Theme](https://raw.githubusercontent.com/h-enk/doks/master/images/tn.png) ## Demo - [doks-child-theme.netlify.app](https://doks-child-theme.netlify.app/) ## Why Doks? Nine reasons why you should use Doks: 1. __Security aware__. Get A+ scores on [Mozilla Observatory](https://observatory.mozilla.org/analyze/doks.netlify.app) out of the box. Easily change the default Security Headers to suit your needs. 2. __Fast by default__. Get 100 scores on [Google Lighthouse](https://googlechrome.github.io/lighthouse/viewer/?gist=7731347bb8ce999eff7428a8e763b637) by default. Doks removes unused css, prefetches links, and lazy loads images. 3. __SEO-ready__. Use sensible defaults for structured data, open graph, and Twitter cards. Or easily change the SEO settings to your liking. 4. __Development tools__. Code with confidence. Check styles, scripts, and markdown for errors and fix automatically or manually. 5. __Bootstrap framework__. Build robust, flexible, and intuitive websites with Bootstrap 5. Easily customize your Doks site with the source Sass files. 6. __Netlify-ready__. Deploy to Netlify with sensible defaults. Easily use Netlify Functions, Netlify Redirects, and Netlify Headers. 7. __Full text search__. Search your Doks site with FlexSearch. Easily customize index settings and search options to your liking. 8. __Page layouts__. Build pages with a landing page, blog, or documentation layout. Add custom sections and components to suit your needs. 9. __Dark mode__. Switch to a low-light UI with the click of a button. Change colors with variables to match your branding. ## Requirements Doks uses npm to centralize dependency management, making it [easy to update](https://getdoks.org/docs/help/how-to-update/) resources, build tooling, plugins, and build scripts: - Download and install [Node.js](https://nodejs.org/) (it includes npm) for your platform. ## Get started Start a new Doks project in three steps: ### 1. Create a new site Doks is available as a child theme, and a starter theme: - Use the Doks child theme, if you do __not__ plan to customize a lot, and/or need future Doks updates. - Use the Doks starter theme, if you plan to customize a lot, and/or do __not__ need future Doks updates. Not quite sure? Use the Doks child theme. #### Doks child theme ```bash git clone https://github.com/h-enk/doks-child-theme.git my-doks-site && cd my-doks-site ``` #### Doks starter theme ```bash git clone https://github.com/h-enk/doks.git my-doks-site && cd my-doks-site ``` ### 2. Install dependencies ```bash npm install ``` ### 3. Start development server ```bash npm run start ``` ## Other commands Doks comes with [commands](https://getdoks.org/docs/prologue/commands/) for common tasks. ## Documentation - [Netlify](https://docs.netlify.com/) - [Hugo](https://gohugo.io/documentation/) - [Doks](https://getdoks.org/) ## Communities - [Netlify Community](https://community.netlify.com/) - [Hugo Forums](https://discourse.gohugo.io/) - [Doks Discussions](https://github.com/h-enk/doks/discussions)