|
|
@ -1,42 +1,52 @@ |
|
|
|
# Présentation |
|
|
|
|
|
|
|
Ceci est le code source du [site web d'Antopie](https://antopie.org). |
|
|
|
C'est un générateur de sites statiques en PHP. |
|
|
|
Ceci est le code source du générateur de sites statiques qui créé le [site web d'Antopie](https://antopie.org). |
|
|
|
|
|
|
|
# Utilisation |
|
|
|
|
|
|
|
Placer les pages dans `pages/<adresse de la page>.md`. Le format est principalement du Markdown Extra mais il est aussi possible de rajouter de l'HTML et du PHP. Elles sont ensuite transformées par `compil.php` en pages HTML statiques. |
|
|
|
Placer les pages dans `<site>/md/<page>.md`. Le format est principalement du Markdown Extra mais il est aussi possible de rajouter de l'HTML et du PHP. Elles sont ensuite transformées par `compil.php` en pages HTML statiques, placées dans `<site>/<page>.html` |
|
|
|
|
|
|
|
`compil.php` prend 2 arguments : |
|
|
|
* `pw`, mot de passe définit dans mdp.php |
|
|
|
* `site`, nom du dossier du site |
|
|
|
* `as`, qui dépend de l'endroit où sera déployé le site |
|
|
|
|
|
|
|
Pour déployer en DNS en liant vers `page`, utiliser `as=dns`. |
|
|
|
Pour déployer en Onion en liant vert `page`, utiliser `as=onion`. |
|
|
|
Pour déployer en DNS en liant vert `page.html`, ignorer `as`. |
|
|
|
|
|
|
|
Exemple : http://tructructruc.onion/web/compil.php?as=onion&pw=change-moi |
|
|
|
Exemple : http://tructructruc.onion/web/compil.php?as=onion&pw=change-moi&site=antopie |
|
|
|
|
|
|
|
Les droits d'écriture sont requis sur l'ensemble du dossier par l'user qui exécute PHP. |
|
|
|
Les droits d'écriture sont requis sur <site>/css et temp/ par l'user qui exécute PHP. |
|
|
|
|
|
|
|
`compil.php` va chercher à utiliser [static-compress](https://github.com/neosmart/static-compress) dans `/usr/local/bin/static-compress` pour compresser les fichiers CSS et HTML créés. |
|
|
|
|
|
|
|
``` |
|
|
|
$ cargo install static-compress |
|
|
|
$ sudo mv ~/.cargo/bin/static-compress /usr/local/bin/ |
|
|
|
``` |
|
|
|
|
|
|
|
# Bibliothèques utilisées |
|
|
|
|
|
|
|
Le dossier bibli contient les dépendances incluses dans ce site. |
|
|
|
Le dossier `bibli` contient les dépendances incluses dans le générateur de sites : |
|
|
|
|
|
|
|
| Nom | Description | Source | |
|
|
|
| --------- | --------------------------- | ------------------------------------------ | |
|
|
|
| lesserphp | Compilateur Less en PHP | https://github.com/MarcusSchwarz/lesserphp | |
|
|
|
| parsedown | Compilateur Markdown en PHP | https://parsedown.org | |
|
|
|
|
|
|
|
Il y a aussi quelques dépendances spécifiques au site d'Antopie : |
|
|
|
|
|
|
|
| Nom | Description | Source | |
|
|
|
| --------------- | --------------------------------- | ------------------------------------------- | |
|
|
|
| ubuntu | La police Ubuntu | https://design.ubuntu.com/font | |
|
|
|
| fontello | Pack d'icônes | http://fontello.com | |
|
|
|
| lesserphp | Compilateur Less en PHP | https://github.com/MarcusSchwarz/lesserphp | |
|
|
|
| konami-js | Le code de Konami | https://snaptortoise.github.io/konami-js | |
|
|
|
| gomez css | Gomez du jeu vidéo Fez en CSS | https://github.com/maisano/gomez-css | |
|
|
|
| static-compress | Compression de fichiers statiques | https://github.com/neosmart/static-compress | |
|
|
|
| parsedown | Compilateur Markdown en PHP | https://parsedown.org | |
|
|
|
| Nom | Description | Source | |
|
|
|
| --------- | ------------------- | ---------------------------------------- | |
|
|
|
| fontello | Pack d'icônes | http://fontello.com | |
|
|
|
| konami-js | Le code de Konami | https://snaptortoise.github.io/konami-js | |
|
|
|
| gomez css | Gomez de Fez en CSS | https://github.com/maisano/gomez-css | |
|
|
|
|
|
|
|
# Licence |
|
|
|
|
|
|
|
Le site web d'Antopie 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. |
|
|
|
Le générateur de sites web d'Antopie 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. |
|
|
|
|
|
|
|
Le site web d'Antopie 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. |
|
|
|
Le générateur de sites web d'Antopie 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/ |