README.md 2.7 KB
Newer Older
Henk Verlinde's avatar
Henk Verlinde committed
1
# Doks
Henk Verlinde's avatar
Henk Verlinde committed
2

Henk Verlinde's avatar
Henk Verlinde committed
3
4
5
6
[![GitHub release](https://img.shields.io/github/release/h-enk/doks.svg?style=flat-square)](https://github.com/h-enk/doks/releases)
[![Build Status](https://img.shields.io/travis/h-enk/doks.svg?style=flat-square)](https://travis-ci.com/h-enk/doks)
[![Netlify](https://img.shields.io/netlify/895a161c-86be-48a2-8c57-a8c5d68cd1a4?style=flat-square)](https://doks.netlify.com/)

Henk Verlinde's avatar
Henk Verlinde committed
7
Doks is a Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready — by default.
Henk Verlinde's avatar
Henk Verlinde committed
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

## Why Doks?

Six 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=8b7aec005ae7b9e128ad5c4e2f125fea) 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.

## Requirements

Make sure all dependencies have been installed:

- [Hugo](https://gohugo.io/) >= 0.75.0/extended
- [Node.js](https://nodejs.org/) >= 14.15.0 (needed to install npm packages and run scripts

## Get started

Create a new Doks project:

```bash
git clone https://github.com/h-enk/doks.git my-doks-site
```

Install dependencies:

```bash
# @ my-doks-site/
Henk Verlinde's avatar
Henk Verlinde committed
44
$ npm install
Henk Verlinde's avatar
Henk Verlinde committed
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
```

Build development theme with live reloading and injection:

```bash
# @ my-doks-site/
$ npm run start
```

### Other commands

- `npm run lint:styles` - Check Sass for errors
- `npm run lint:scripts` - Check JavaScript for errors
- `npm run clean` - Delete temporary directories
- `npm run build` - Build production theme

## 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)

## Example site

👉 [doks.netlify.app](https://doks.netlify.app/)

## Documentation

- [Netlify](https://docs.netlify.com/)
- [Hugo](https://gohugo.io/documentation/)
- [Doks](https://getdoks.org/)

## Communities

- [Netlify Community](https://community.netlify.com/)
Henk Verlinde's avatar
Henk Verlinde committed
80
- [Hugo Forums](https://discourse.gohugo.io/)