114 lines
4.0 KiB
Markdown
114 lines
4.0 KiB
Markdown
|
<p align="center">
|
||
|
<a href="https://getdoks.org/">
|
||
|
<img alt="Doks" src="https://doks.netlify.app/doks.svg" width="60">
|
||
|
</a>
|
||
|
</p>
|
||
|
|
||
|
<h1 align="center">
|
||
|
Doks
|
||
|
</h1>
|
||
|
|
||
|
<h3 align="center">
|
||
|
Modern documentation theme
|
||
|
</h3>
|
||
|
|
||
|
<p align="center">
|
||
|
Doks is a Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready — by default.
|
||
|
</p>
|
||
|
|
||
|
<p align="center">
|
||
|
<a href="https://github.com/h-enk/doks/blob/master/LICENSE">
|
||
|
<img src="https://img.shields.io/github/license/h-enk/doks?style=flat-square" alt="GitHub">
|
||
|
</a>
|
||
|
<a href="https://github.com/h-enk/doks/releases">
|
||
|
<img src="https://img.shields.io/github/v/release/h-enk/doks?include_prereleases&style=flat-square"alt="GitHub release (latest SemVer including pre-releases)">
|
||
|
</a>
|
||
|
<a href="https://github.com/h-enk/doks/actions?query=workflow%3A%22Hyas+CI%22">
|
||
|
<img src="https://img.shields.io/github/workflow/status/h-enk/doks/Hyas%20CI/master?style=flat-square" alt="GitHub Workflow Status (branch)">
|
||
|
</a>
|
||
|
<a href="https://app.netlify.com/sites/doks/deploys">
|
||
|
<img src="https://img.shields.io/netlify/895a161c-86be-48a2-8c57-a8c5d68cd1a4?style=flat-square" alt="Netlify">
|
||
|
</a>
|
||
|
</p>
|
||
|
|
||
|
![Doks — Modern Documentation Theme](https://raw.githubusercontent.com/h-enk/doks/master/images/tn.png)
|
||
|
|
||
|
## Demo
|
||
|
|
||
|
- [doks.netlify.app](https://doks.netlify.app/)
|
||
|
|
||
|
## Quick start
|
||
|
|
||
|
Get your Doks site in 1 min.
|
||
|
|
||
|
[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/h-enk/doks)
|
||
|
|
||
|
## 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. Or use any other front-end framework if you prefer.
|
||
|
|
||
|
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 for dependency management and customized build scripts. Installing npm is pretty simple. Download and install [Node.js](https://nodejs.org/) (it includes npm) for your platform. I recommend installing the current release.
|
||
|
|
||
|
## Get started
|
||
|
|
||
|
Have your local Doks site in three steps:
|
||
|
|
||
|
### 1. Create new Doks project
|
||
|
|
||
|
```bash
|
||
|
git clone https://github.com/h-enk/doks.git my-doks-site
|
||
|
```
|
||
|
|
||
|
### 2. Install npm packages
|
||
|
|
||
|
```bash
|
||
|
npm install
|
||
|
```
|
||
|
|
||
|
### 3. Start local 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)
|
||
|
|
||
|
## Blog
|
||
|
<!--START_SECTION:feed-->
|
||
|
* [Say hello to Doks 👋](https://getdoks.org/blog/say-hello-to-doks/)
|
||
|
<!--END_SECTION:feed-->
|