Il est possible de lire la documentation dans [le dossier portails](https://git.resilien.fr/ResiLien/portails/src/branch/main/portails)
Go to file
Henk Verlinde 2052627f14
Update README.md
2021-05-22 09:49:31 +02:00
.github fix: drop npm workflow 2021-03-26 11:15:55 +01:00
archetypes config: update sitemap changefreq 2020-12-02 13:49:08 +01:00
assets Replace highlightBlock with highlightElement 2021-04-18 19:59:49 +09:00
config content: update for doks v0.2.3 2021-04-02 20:01:29 +02:00
content content: update for doks v0.2.3 2021-04-02 20:01:29 +02:00
data chore(release): 0.2.3 2021-04-02 20:03:28 +02:00
images images: resize thumbnail 2020-12-29 16:05:08 +01:00
layouts Merge pull request #235 from OCram85/featureAlert 2021-04-20 09:27:33 +02:00
static feat: add katex math typesetting 2021-03-16 15:14:45 +01:00
.editorconfig Initial commit 2020-04-15 15:48:16 +02:00
.eslintignore feat: add katex math typesetting 2021-03-16 15:14:45 +01:00
.eslintrc.json feat: added options lazySizes, clipBoard, instantPage, flexSearch, and darkMode 2021-03-01 16:34:43 +01:00
.gitignore feat: update netlify.toml for netlify-cli use 2021-03-17 15:32:42 +01:00
.markdownlint.json feat: add flexsearch 2020-11-04 08:26:58 +01:00
.markdownlintignore docs: update readme 2021-01-08 10:33:36 +01:00
.npmrc feat: add hugo extended as a dependency 2021-01-12 11:31:13 +01:00
.stylelintignore feat: add flexsearch 2020-11-04 08:26:58 +01:00
.stylelintrc.json Initial commit 2020-04-15 15:48:16 +02:00
.versionrc.json feat: add hugo extended as a dependency 2021-01-12 11:31:13 +01:00
CHANGELOG.md chore(release): 0.2.3 2021-04-02 20:03:28 +02:00
CODE_OF_CONDUCT.md docs: update code of conduct 2020-12-09 09:32:04 +01:00
LICENSE legal: update copyright notice 2021-02-19 14:37:52 +01:00
README.md Update README.md 2021-05-22 09:49:31 +02:00
babel.config.js feat: add flexsearch 2020-11-04 08:26:58 +01:00
netlify.toml feat: update for netlify dev support 2021-04-02 19:45:05 +02:00
package-lock.json deps: bump versions to latest 2021-05-11 08:10:10 +02:00
package.json deps: bump versions to latest 2021-05-11 08:10:10 +02:00
theme.toml feat: add hugothemes reqs 2020-12-04 18:01:10 +01:00

README.md

Doks

Doks

Modern documentation theme

Doks is a Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready — by default.

GitHub GitHub release (latest SemVer including pre-releases) GitHub Workflow Status (branch) Netlify

Doks — Modern Documentation Theme

Demo

Why Doks?

Nine reasons why you should use Doks:

  1. Security aware. Get A+ scores on Mozilla Observatory out of the box. Easily change the default Security Headers to suit your needs.

  2. Fast by default. Get 100 scores on Google Lighthouse 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 resources, build tooling, plugins, and build scripts:

  • Download and install Node.js (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

git clone https://github.com/h-enk/doks-child-theme.git my-doks-site && cd my-doks-site

Doks starter theme

git clone https://github.com/h-enk/doks.git my-doks-site && cd my-doks-site

2. Install dependencies

npm install

3. Start development server

npm run start

Other commands

Doks comes with commands for common tasks.

Documentation

Communities