2020-04-15 15:48:16 +02:00
|
|
|
---
|
|
|
|
title: "Introduction"
|
2020-04-17 11:15:31 +02:00
|
|
|
description: "Introduction Doks."
|
|
|
|
lead: "Doks is a Hugo starter helping you build modern documentation websites."
|
|
|
|
date: 2020-04-17T08:48:57+00:00
|
2020-04-15 15:48:16 +02:00
|
|
|
draft: false
|
2020-04-16 14:42:09 +02:00
|
|
|
images: [image-doks.png]
|
2020-04-15 15:48:16 +02:00
|
|
|
menu:
|
|
|
|
docs:
|
|
|
|
parent: "prologue"
|
|
|
|
weight: 010
|
|
|
|
toc: true
|
|
|
|
---
|
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
## Features
|
|
|
|
- Lightweight code base
|
|
|
|
- 100 scores Google Lighthouse
|
|
|
|
- A+ scores [Mozilla Observatory](https://observatory.mozilla.org/)
|
|
|
|
- [Algolia DocSearch](https://docsearch.algolia.com/) support
|
|
|
|
- Dark/Light toggle
|
|
|
|
- Blog ready
|
|
|
|
- Easily make it your own
|
|
|
|
- All in [Hyas](https://github.com/h-enk/hyas)
|
2020-04-15 15:48:16 +02:00
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
See a working example at [doks.netlify.app](https://doks.netlify.app/)
|
2020-04-15 15:48:16 +02:00
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
## Requirements
|
2020-04-15 15:48:16 +02:00
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
Make sure all dependencies have been installed:
|
2020-04-15 15:48:16 +02:00
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
- [Hugo](https://gohugo.io/) >= 0.69.0/extended
|
|
|
|
- [Node.js](https://nodejs.org/) >= 13.11.0
|
|
|
|
- [Yarn](https://yarnpkg.com/) >= 1.22.4 (recommended)
|
2020-04-15 15:48:16 +02:00
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
## Get started
|
2020-04-15 15:48:16 +02:00
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
Create a new Doks project:
|
2020-04-15 15:48:16 +02:00
|
|
|
|
|
|
|
```bash
|
2020-04-17 11:15:31 +02:00
|
|
|
$ git clone git@github.com:h-enk/doks.git my-doks-site
|
2020-04-15 15:48:16 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
Install dependencies:
|
|
|
|
|
|
|
|
```bash
|
2020-04-17 11:15:31 +02:00
|
|
|
# @ my-doks-site/
|
|
|
|
$ yarn install
|
2020-04-15 15:48:16 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
Build development theme with live reloading and injection:
|
|
|
|
|
|
|
|
```bash
|
2020-04-17 11:15:31 +02:00
|
|
|
# @ my-doks-site/
|
|
|
|
$ yarn start
|
2020-04-15 15:48:16 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
### Other commands
|
|
|
|
- `yarn lint:styles` - Check Sass for errors
|
|
|
|
- `yarn lint:scripts` - Check JavaScript for errors
|
|
|
|
- `yarn clean` - Delete temporary directories
|
|
|
|
- `yarn build` - Build production theme
|
|
|
|
|
2020-04-17 11:15:31 +02:00
|
|
|
## Documentation
|
|
|
|
- [Hugo](https://gohugo.io/documentation/)
|
|
|
|
- [Hyas](https://gethyas.com/)
|
|
|
|
- [Doks](https://getdoks.org/)
|