80 lines
2.9 KiB
Markdown
80 lines
2.9 KiB
Markdown
#  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.
|
||
|
||
`wget https://code.antopie.org/miraty/libreqr/archive/1.3.0.zip`
|
||
|
||
L'extension GD est requise.
|
||
|
||
`apt install php7.3-gd`
|
||
|
||
LibreQR a besoin des permissions d'écriture dans le dossier `css/`.
|
||
|
||
```
|
||
chown -R www-data:www-data /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
|
||
|
||
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
|
||
|
||
Les thèmes sont situés dans `themes/`, le thème par défaut est dans `themes/libreqr`.
|
||
|
||
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`).
|
||
|
||
## 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 :
|
||
|
||
* [CodeItNow Barcode & QrCode Generator](https://github.com/codeitnowin/barcode-generator) pour générer les codes QR
|
||
* [less.php](https://github.com/wikimedia/less.php) pour compiler le [Less](http://lesscss.org)
|
||
|
||
## Licence
|
||
|
||
[AGPLv3+](https://code.antopie.org/miraty/libreqr/src/branch/main/LICENSE)
|
||
|
||
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 l’espoir qu’il sera utile, mais SANS AUCUNE GARANTIE ; sans même une garantie implicite de COMMERCIALISATION ou d’ADÉ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/>
|