qrcode.chapril.org/README_fr.md

80 lines
2.9 KiB
Markdown
Raw Normal View History

2020-10-31 16:51:50 +01:00
# ![](themes/dark/icons/32.png) LibreQR
[Read this in english](README.md)
Une interface Web en PHP pour générer des codes QR.
## Démo
Une instance de LibreQR est disponible sur <https://qr.antopie.org>.
## Installation
### Générique
Placez simplement ce code source dans un serveur Web avec PHP.
2021-01-01 16:44:36 +01:00
`wget https://code.antopie.org/miraty/libreqr/archive/1.3.0.zip`
2020-10-31 16:51:50 +01:00
L'extension GD est requise.
`apt install php7.3-gd`
LibreQR a besoin des permissions d'écriture dans le dossier `css/`.
2020-10-31 16:51:50 +01:00
```
chown -R www-data:www-data /var/www/libreqr/css
chmod -R 600 /var/www/libreqr/css
2020-10-31 16:51:50 +01:00
```
#### 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
```
2020-10-31 16:51:50 +01:00
### YunoHost
Il y a [un paquet](https://code.antopie.org/miraty/qr_ynh/) pour [YunoHost](https://yunohost.org/).
Pour des raisons historiques, LibreQR est techniquement nommée `qr` dans YunoHost.
Vous pouvez l'installer depuis l'interface Web d'administration ou avec cette commande :
```
sudo yunohost app install qr
```
## Themes
2020-10-31 16:51:50 +01:00
Les thèmes sont situés dans `themes/`, le thème par défaut est dans `themes/libreqr`.
2020-10-31 16:51:50 +01:00
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`).
2020-10-31 16:51:50 +01:00
## Contribuer
Si vous souhaitez rapporter un bug, vous pouvez ouvrir un ticket sur <https://code.antopie.org/miraty/libreqr/issues> après vous être créé un compte (méthode préférée) ou me contacter d'une autre manière.
## Contact
Si vous voulez me contacter, par exemple pour signaler un bug ou me poser une question sur l'installation ou l'utilisation de LibreQR, vous trouverez des moyens de me contacter sur <https://miraty.antopie.org>.
## Bibliothèques tierces
Ce code source inclus :
2021-11-01 18:08:42 +01:00
* [CodeItNow Barcode & QrCode Generator](https://github.com/codeitnowin/barcode-generator) pour générer les codes QR
2021-02-15 21:29:38 +01:00
* [less.php](https://github.com/wikimedia/less.php) pour compiler le [Less](http://lesscss.org)
2020-10-31 16:51:50 +01:00
## Licence
2021-07-11 14:00:35 +02:00
[AGPLv3+](https://code.antopie.org/miraty/libreqr/src/branch/main/LICENSE)
2020-10-31 16:51:50 +01:00
LibreQR est un logiciel libre ; vous pouvez le diffuser et le modifier suivant les termes de la GNU Affero General Public License telle que publiée par la Free Software Foundation ; soit la version 3 de cette licence, soit (à votre convenance) une version ultérieure.
LibreQR est diffusé dans lespoir quil sera utile, mais SANS AUCUNE GARANTIE ; sans même une garantie implicite de COMMERCIALISATION ou dADÉQUATION À UN USAGE PARTICULIER. Voyez la GNU Affero General Public License pour plus de détails.
Vous devriez avoir reçu une copie de la GNU Affero General Public License avec ce code. Sinon, consultez <https://www.gnu.org/licenses/>