Update README about themes and add security hardening section
This commit is contained in:
parent
0fd25abfd2
commit
9b147ecc37
2 changed files with 21 additions and 39 deletions
29
README.md
29
README.md
|
@ -27,6 +27,14 @@ chown -R www-data:www-data /var/www/libreqr/css
|
||||||
chmod -R 600 /var/www/libreqr/css
|
chmod -R 600 /var/www/libreqr/css
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### Security hardening
|
||||||
|
|
||||||
|
Your HTTP server can reply the following headers:
|
||||||
|
```
|
||||||
|
Content-Security-Policy: default-src 'none'; img-src 'self' data:; style-src 'self'; frame-ancestors 'none'; form-action 'self';
|
||||||
|
Referrer-Policy: no-referrer
|
||||||
|
```
|
||||||
|
|
||||||
### YunoHost
|
### YunoHost
|
||||||
|
|
||||||
There is [a package](https://code.antopie.org/miraty/qr_ynh/) for [YunoHost](https://yunohost.org/).
|
There is [a package](https://code.antopie.org/miraty/qr_ynh/) for [YunoHost](https://yunohost.org/).
|
||||||
|
@ -41,26 +49,9 @@ sudo yunohost app install qr
|
||||||
|
|
||||||
## Themes
|
## Themes
|
||||||
|
|
||||||
### Change theme
|
Themes are located in `themes/*`, the default theme is in `themes/libreqr/`.
|
||||||
|
|
||||||
In config.inc.php, set $theme to the wanted theme.
|
You can customize your LibreQR instance look by changing the colors in `theme.php`, the logo in `logo.less` or the icons in `icons/<size>.png` (then list the sizes in `theme.php`).
|
||||||
|
|
||||||
By default, 3 themes are offered:
|
|
||||||
|
|
||||||
* dark, the default dark theme. Used here: <https://qr.antopie.org>
|
|
||||||
* light, the light theme.
|
|
||||||
* parinux, a blue theme, made for [Bastet](https://bastet.parinux.org), the [Parinux](https://parinux.org)'s CHATON. Used here: <https://codeqr.parinux.org>
|
|
||||||
|
|
||||||
### Make a theme
|
|
||||||
|
|
||||||
* Copy themes/dark to themes/[new theme's name]
|
|
||||||
* Fill theme.php according to CSS colors you want
|
|
||||||
* Change the source.png image according to your theme
|
|
||||||
* To automatically generate favicons with the rights sizes, use `php themes/resize.php [theme's name]`
|
|
||||||
|
|
||||||
This last step will need [ImageMagick](https://imagemagick.org) and [pngquant](https://pngquant.org) to be installed.
|
|
||||||
|
|
||||||
```apt install imagemagick pngquant```
|
|
||||||
|
|
||||||
## Contribute
|
## Contribute
|
||||||
|
|
||||||
|
|
31
README_fr.md
31
README_fr.md
|
@ -27,6 +27,14 @@ chown -R www-data:www-data /var/www/libreqr/css
|
||||||
chmod -R 600 /var/www/libreqr/css
|
chmod -R 600 /var/www/libreqr/css
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### Durcir la sécurité
|
||||||
|
|
||||||
|
Votre serveur HTTP peut répondre avec les entêtes suivantes :
|
||||||
|
```
|
||||||
|
Content-Security-Policy: default-src 'none'; img-src 'self' data:; style-src 'self'; frame-ancestors 'none'; form-action 'self';
|
||||||
|
Referrer-Policy: no-referrer
|
||||||
|
```
|
||||||
|
|
||||||
### YunoHost
|
### YunoHost
|
||||||
|
|
||||||
Il y a [un paquet](https://code.antopie.org/miraty/qr_ynh/) pour [YunoHost](https://yunohost.org/).
|
Il y a [un paquet](https://code.antopie.org/miraty/qr_ynh/) pour [YunoHost](https://yunohost.org/).
|
||||||
|
@ -39,28 +47,11 @@ Vous pouvez l'installer depuis l'interface Web d'administration ou avec cette co
|
||||||
sudo yunohost app install qr
|
sudo yunohost app install qr
|
||||||
```
|
```
|
||||||
|
|
||||||
## Thèmes
|
## Themes
|
||||||
|
|
||||||
### Changer de thème
|
Les thèmes sont situés dans `themes/`, le thème par défaut est dans `themes/libreqr`.
|
||||||
|
|
||||||
Dans config.inc.php, donnez à $theme le nom du thème voulu.
|
Vous pouvez personnaliser l'apparence de votre instance LibreQR en changeant les couleurs dans `theme.php`, le logo dans `logo.less` ou les icônes dans `icons/<size>.png` (ensuite indiquer leur taille dans `theme.php`).
|
||||||
|
|
||||||
Par défaut, trois thèmes sont proposés :
|
|
||||||
|
|
||||||
* dark, le thème par défaut, sombre. Il est utilisé ici : <https://qr.antopie.org>
|
|
||||||
* light, thème clair
|
|
||||||
* parinux, un thème bleu, créé pour [Bastet](https://bastet.parinux.org), le CHATON de [Parinux](https://parinux.org). Il est utilisé ici : <https://codeqr.parinux.org>
|
|
||||||
|
|
||||||
### Créer un thème
|
|
||||||
|
|
||||||
* Copiez themes/dark vers themes/[nom de votre thème]
|
|
||||||
* Complétez theme.php en fonction des couleurs CSS voulues dans l'interface
|
|
||||||
* Modifiez l'image source.png en fonction de votre thème
|
|
||||||
* Pour générer automatiquement les icônes aux tailles correctes, utilisez `php themes/resize.php [nom du thème]`
|
|
||||||
|
|
||||||
Cette dernière étape nécessite d'avoir installé [ImageMagick](https://imagemagick.org) et [pngquant](https://pngquant.org).
|
|
||||||
|
|
||||||
```apt install imagemagick pngquant```
|
|
||||||
|
|
||||||
## Contribuer
|
## Contribuer
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue