portails/README.md

60 lines
1.6 KiB
Markdown
Raw Normal View History

2020-04-16 16:30:17 +02:00
# Doks
[![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.org/github/h-enk/doks)
[![Netlify](https://img.shields.io/netlify/33fb6ec8-d314-4695-bbb6-2b3c1b665cbf?style=flat-square)](https://doks.netlify.app/)
2020-04-17 11:15:31 +02:00
Doks is a Hugo starter helping you build modern documentation websites.
2020-04-16 16:30:17 +02:00
2020-04-17 11:15:31 +02:00
## Features
2020-04-16 16:30:17 +02:00
- Lightweight code base
2020-04-17 11:15:31 +02:00
- 100 scores Google Lighthouse
- A+ scores [Mozilla Observatory](https://observatory.mozilla.org/)
2020-04-16 16:30:17 +02:00
- [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
## Requirements
Make sure all dependencies have been installed:
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-16 16:42:30 +02:00
## Get started
2020-04-15 15:48:16 +02:00
2020-04-16 16:30:17 +02:00
Create a new Doks project:
2020-04-15 15:48:16 +02:00
```bash
2020-04-16 16:30:17 +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-16 16:30:17 +02:00
# @ my-doks-site/
2020-04-15 15:48:16 +02:00
$ yarn install
```
Build development theme with live reloading and injection:
```bash
2020-04-16 16:30:17 +02:00
# @ my-doks-site/
2020-04-15 15:48:16 +02:00
$ yarn start
```
### 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
## Documentation
2020-04-17 11:15:31 +02:00
- [Hugo](https://gohugo.io/documentation/)
2020-04-16 16:30:17 +02:00
- [Hyas](https://gethyas.com/)
2020-04-17 11:15:31 +02:00
- [Doks](https://getdoks.org/)