doc/pages/02.administer/60.extend/15.theming/theming.fr.md
OniriCorpe 7a01793062
Improve markdown formatting of pages, a lot of them are improperly formatted (#2429)
* Revert "Revert "markdown format""

* fix formating

* fix readme

* add .markdownlint.json

* add markdownlint-rules-grav-pages

* add markdownlint-rules-grav-pages files

* add license for Markdown Lint Rules for Grav Pages

* fix [figure] mess

* fix [figure] mess 2

* fix [figure] mess 3

* maj .gitignore

* various fixes

* fix markdownlint-rules-grav-pages

* second formater pass

* various manual fixes

* add .markdownlintignore

* markdownlintignore: auto-generated pages

* disable proper-names for html_elements

* another bunch of various markdown fixes

* Update pages/02.administer/10.install/20.dns_config/dns_config.es.md

Co-authored-by: tituspijean <titus+yunohost@pijean.ovh>

---------

Co-authored-by: Alexandre Aubin <4533074+alexAubin@users.noreply.github.com>
Co-authored-by: tituspijean <titus+yunohost@pijean.ovh>
2024-03-23 08:59:52 +01:00

2.9 KiB

title template taxonomy routes
Personnaliser l'apparence du portail utilisateur docs
category
docs
default
/theming

Utiliser un thème

Vous pouvez changer le thème du portail utilisateur depuis l'interface administrateur, dans l'onglet Outils > Paramètres de YunoHost > Other > Thème du portail.

Vous pouvez lister les thèmes disponibles avec :

ls /usr/share/ssowat/portal/assets/themes/

Ensuite, vous pouvez utiliser nano /etc/ssowat/conf.json.persistent pour activer le thème que vous choisissez comme ceci :

{
    "theme" : "light",
    ...autres lignes.....
}

!!! Vous devrez peut-être forcer le rafraîchissement du cache de votre navigateur pour que le thème se propage complètement. Vous pouvez le faire avec Ctrl+Maj+R sur Firefox.

Ajouter le thème de quelqu'un d'autre

Vous pouvez ajouter des thèmes créés par d'autres personnes en téléchargeant et en extrayant les fichiers correspondants dans un nouveau dossier nom_du_theme dans /usr/share/ssowat/portal/assets/themes/.

! Attention : l'ajout de thèmes provenant d'inconnus sur Internet est un risque de sécurité. Cela équivaut à exécuter du code écrit par quelqu'un d'autre sur votre machine, et peut donc être utilisé à des fins malveillantes comme voler des mots de passe !

Quelques thèmes sont listés sur GitHub.

Créer votre propre thème

Vous pouvez créer votre propre thème en copiant le thème existant de votre choix. Par exemple à partir du thème light :

cp -r /usr/share/ssowat/portal/assets/themes/{light,votre_theme}

Ensuite, éditez les fichiers CSS et JS dans /usr/share/ssowat/portal/assets/themes/votre_theme selon ce que vous voulez faire :

  • custom_portal.css peut être utilisé pour ajouter des règles CSS personnalisées au portail utilisateur ;
  • custom_overlay.css peut être utilisé pour personnaliser le petit bouton YunoHost, présent sur les apps qui l'intègrent ;
  • custom_portal.js peut être utilisé pour ajouter du code JS personnalisé à exécuter à la fois sur le portail utilisateur ou lors de l'injection du petit bouton YunoHost ("overlay").

Vous pouvez également ajouter vos propres images et ressources qui peuvent ensuite être utilisées par les fichiers CSS et JS.

!!! Partagez vos thèmes personnalisés avec la communauté ! https://github.com/yunohost-themes

Vous pouvez créer votre propre thème simplement pour changer le "branding" du portail utilisateur YunoHost et remplacer le logo YunoHost par votre propre logo !

Pour ce faire, téléversez votre logo dans /usr/share/ssowat/portal/assets/themes/votre_theme/, et ajoutez les règles CSS suivantes :

/* Dans custom_portal.css */
#ynh-logo {
  background-image : url("./votre_logo.png");
}

/* Dans custom_overlay.css */
#ynh-overlay-switch {
  background-image : url("./votre_logo.png");
}