nishiki/hugo-theme-relearn
1
0
Fork 0
mirror of https://github.com/McShelby/hugo-theme-relearn.git synced 2025-02-12 14:53:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
hugo-theme-relearn/exampleSite/content/basics/configuration/_index.fr.md

72 lines
3.7 KiB
Markdown
Raw Normal View History

Translate in french
2017-08-20 22:29:35 +02:00
---
date: 2016-04-09T16:50:16+02:00
title: Configuration
weight: 20
---
chore: fix spelling mistake
2017-09-04 19:14:13 +02:00
## Paramètres globaux du site
Translate in french
2017-08-20 22:29:35 +02:00
En plus de la [configuration globale d'Hugo](https://gohugo.io/overview/configuration/), **Hugo-theme-learn** vous permet de définir les paramètres suivant dans votre fichier `config.toml` (ci-dessous sont affichées les valeurs par défaut).
Notez que certains de ces paramètres sont expliqués en détails dans d'autres sections de cette documentation.
```toml
[params]
# L'URL préfixe pour éditer la page courante. Ce paramètre affichera un bouton "Modifier cette page" on haut de de chacune des pages.
# Pratique pour donner les possibilité à vos utilisateurs de créer une merge request pour votre doc.
# Allez voir le fichier config.toml de cette documentation pour avoir un exemple.
editURL = ""
# Autheur du site, est utilisé dans les informations meta
author = ""
# Description du site, est utilisé dans les informations meta
description = ""
# Affiche une icône lorsque la page a été visitée
showVisitedLinks = false
# Désactive la fonction de recherche. Une valeur à true cache la barre de recherche.
disableSearch = false
Allow custom css files to be loaded by configuration Previously adding custom css files would require the end user to copy the header or footer partial into their overrides. They would then need to maintain that partial into the future. This config allows a user to provide a list of custom css files to load into the theme, meaning they do not need to clone the partial. ``` [params] custom_css = ["css/foo.css", "css/bar.css"] ``` Inspiration taken from https://discourse.gohugo.io/t/how-to-override-css-classes-with-hugo/3033/4
2020-03-09 15:50:24 +00:00
# Par défaut, le cache Javascript et CSS est automatiquement vidé lorsqu'une nouvelle version du site est générée.
Translate in french
2017-08-20 22:29:35 +02:00
# Utilisez ce paramètre lorsque vous voulez désactiver ce comportement (c'est parfois incompatible avec certains proxys)
disableAssetsBusting = false
# Utilisez ce paramètre pour désactiver le bouton copy-to-clipboard pour le code formatté sur une ligne.
disableInlineCopyToClipBoard = false
Allow custom css files to be loaded by configuration Previously adding custom css files would require the end user to copy the header or footer partial into their overrides. They would then need to maintain that partial into the future. This config allows a user to provide a list of custom css files to load into the theme, meaning they do not need to clone the partial. ``` [params] custom_css = ["css/foo.css", "css/bar.css"] ``` Inspiration taken from https://discourse.gohugo.io/t/how-to-override-css-classes-with-hugo/3033/4
2020-03-09 15:50:24 +00:00
# Un titre est défini par défaut lorsque vous utilisez un raccourci dans le menu. Utilisez ce paramètre pour le cacher.
Translate in french
2017-08-20 22:29:35 +02:00
disableShortcutsTitle = false
Customize mermaid module (#362) * enabled mermaid by default * implemented logic to use internal oder cdn mermaid * added english documentation * added french translation for the mermaid options * Removed useless test print * Hugo does not use upper case letters in params * fixed false sample link * improved mermaid pages * fixed always load mermaid if no frontmatter specified * fixed mermaid samples * removed obsolete css files * changed default version of mermaid cdn * renamed mermaidURL to customMermaidURL and removed css link * improved mermaid configuration description Co-authored-by: Arthur Ferdinand Lindner <Arthur-Ferdinand.Lindner@Telekom.de> Co-authored-by: Arthur Ferdinand Lindner <arthur.lindner@outlook.de>
2020-09-11 15:57:25 +02:00
# Si défini à true, empêche Hugo d'inclure le module "mermaid" s'il n'est pas nécessaire (réduira les temps de chargement et le trafic)
disableMermaid = false
# Spécifie l'emplacement distant du mermaid js
customMermaidURL = "https://unpkg.com/mermaid@8.8.0/dist/mermaid.min.js"
Translate in french
2017-08-20 22:29:35 +02:00
# Quand vous utilisez un site multi-langue, utilisez ce paramètre pour désactiver le bouton de changement de langue.
disableLanguageSwitchingButton = false
# Ordonne les sections dans menu par poids ("weight") ou titre ("title"). Défaut à "weight"
ordersectionsby = "weight"
# Utilisez ce paramètre pour modifier le schéma de couleur du site. Les valeurs par défaut sont "red", "blue", "green".
themeVariant = ""
Allow custom css files to be loaded by configuration Previously adding custom css files would require the end user to copy the header or footer partial into their overrides. They would then need to maintain that partial into the future. This config allows a user to provide a list of custom css files to load into the theme, meaning they do not need to clone the partial. ``` [params] custom_css = ["css/foo.css", "css/bar.css"] ``` Inspiration taken from https://discourse.gohugo.io/t/how-to-override-css-classes-with-hugo/3033/4
2020-03-09 15:50:24 +00:00
# Fournissez une liste de fichiers css personnalisés à charger par rapport depuis le dossier `static/` à la racine du site.
custom_css = ["css/foo.css", "css/bar.css"]
Translate in french
2017-08-20 22:29:35 +02:00
```
fix #61
2017-09-04 21:20:59 +02:00
## Activer la recherche {#activer-recherche}
Translate in french
2017-08-20 22:29:35 +02:00
Si ce n'est pas déjà présent, ajoutez les lignes suivantes dans le fichier `config.toml`.
```toml
[outputs]
home = [ "HTML", "RSS", "JSON"]
```
Fix: typo Correction du terme "améliorations"
2019-11-06 13:52:55 +00:00
Le thème *Learn* utilise les dernières améliorations d'Hugo pour générer un fichier d'index JSON, prêt à être consommé par le moteur de recherche lunr.js.
Translate in french
2017-08-20 22:29:35 +02:00
Allow custom css files to be loaded by configuration Previously adding custom css files would require the end user to copy the header or footer partial into their overrides. They would then need to maintain that partial into the future. This config allows a user to provide a list of custom css files to load into the theme, meaning they do not need to clone the partial. ``` [params] custom_css = ["css/foo.css", "css/bar.css"] ``` Inspiration taken from https://discourse.gohugo.io/t/how-to-override-css-classes-with-hugo/3033/4
2020-03-09 15:50:24 +00:00
> Hugo génère lunrjs index.json à la racine du dossier `public`.
Fix: typo Correction du terme "améliorations"
2019-11-06 13:52:55 +00:00
> Quand vous générez le site avec `hugo server`, Hugo génère le fichier en mémoire, il n'est donc pas disponible sur le disque.
Customize mermaid module (#362) * enabled mermaid by default * implemented logic to use internal oder cdn mermaid * added english documentation * added french translation for the mermaid options * Removed useless test print * Hugo does not use upper case letters in params * fixed false sample link * improved mermaid pages * fixed always load mermaid if no frontmatter specified * fixed mermaid samples * removed obsolete css files * changed default version of mermaid cdn * renamed mermaidURL to customMermaidURL and removed css link * improved mermaid configuration description Co-authored-by: Arthur Ferdinand Lindner <Arthur-Ferdinand.Lindner@Telekom.de> Co-authored-by: Arthur Ferdinand Lindner <arthur.lindner@outlook.de>
2020-09-11 15:57:25 +02:00
## Mermaid
Les paramètres de configuration du mermaid peuvent également être définis sur une page spécifique. Dans ce cas, le paramètre global sera écrasé par le paramètre local.
> Exemple:
>
> Mermaid est globalement handicapé. Par défaut, elle ne sera chargée par aucune page.
> À la page "Architecture", vous avez besoin d'un diagramme de classe. Vous pouvez régler les paramètres de mermaid localement pour ne charger que la sirène sur cette page (pas sur les autres).
Vous pouvez également désactiver mermaid pour des pages spécifiques tout en l'activant globalement.
Reference in a new issue Copy permalink