This repository has been archived by the owner on Sep 28, 2023. It is now read-only.
-
-
Notifications
You must be signed in to change notification settings - Fork 34
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
119 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,119 @@ | ||
# Doks child theme | ||
<p align="center"> | ||
<a href="https://getdoks.org/"> | ||
<img alt="Doks" src="https://doks.netlify.app/logo-doks.svg" width="60"> | ||
</a> | ||
</p> | ||
|
||
<h1 align="center"> | ||
Doks | ||
</h1> | ||
|
||
<h3 align="center"> | ||
Doks child 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-child-theme/blob/master/LICENSE"> | ||
<img src="https://img.shields.io/github/license/h-enk/doks-child-theme?style=flat-square" alt="GitHub"> | ||
</a> | ||
<a href="https://github.com/h-enk/doks-child-theme/releases"> | ||
<img src="https://img.shields.io/github/v/release/h-enk/doks-child-theme?include_prereleases&style=flat-square"alt="GitHub release (latest SemVer including pre-releases)"> | ||
</a> | ||
<a href="https://github.com/h-enk/doks-child-theme/actions/workflows/codeql-analysis.yml"> | ||
<img src="https://img.shields.io/github/workflow/status/h-enk/doks-child-theme/CodeQL/master?style=flat-square" alt="GitHub Workflow Status (branch)"> | ||
</a> | ||
<a href="https://app.netlify.com/sites/hyas-child-theme/deploys"> | ||
<img src="https://img.shields.io/netlify/75395a37-8537-4410-a8c3-d56bf27ec963?style=flat-square" alt="Netlify"> | ||
</a> | ||
</p> | ||
|
||
![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) |