New readme (WIP)
This commit is contained in:
parent
af34f93f38
commit
7c9304ae93
51
README.md
51
README.md
|
@ -1,31 +1,46 @@
|
||||||
# Présentation
|
mkht.php is a PHP script for building Gemini, Markdown and HTML/CSS sites from source documents in Gemini, Markdown, HTML, PHP, CSS and Less.
|
||||||
|
|
||||||
Ceci est le code source du générateur de sites statiques qui créé le [site web d'Antopie](https://antopie.org).
|
# Usage
|
||||||
|
|
||||||
# Utilisation
|
Place your pages tree in `/src/*/*.(gmi|md)`.
|
||||||
|
|
||||||
`compil.php <chemin du site> <destination> <nom du site>`
|
Optionnal files:
|
||||||
|
`/config.ini`
|
||||||
|
`/style.less`
|
||||||
|
`/logo.png`
|
||||||
|
`/head.inc.html`
|
||||||
|
`/footer.inc.html`
|
||||||
|
|
||||||
Avec `destination` :
|
`mkht.php <site path> <destination >`
|
||||||
* Pour déployer en DNS en liant vers `page`, utiliser `dns`.
|
|
||||||
* Pour déployer en Onion en liant vert `page`, utiliser `onion`.
|
|
||||||
* Pour déployer en DNS en liant vert `page.html`, utiliser `local`.
|
|
||||||
|
|
||||||
Exemple pour le site d'Antopie : `compil.php antopie local Antopie`
|
`destination` is optionnal and can be:
|
||||||
|
* `dns` if you want local links without exensions
|
||||||
|
* `onion` if you want links ending with .onion when available
|
||||||
|
|
||||||
# Bibliothèques utilisées
|
# Input
|
||||||
|
|
||||||
Le dossier `bibli` contient les dépendances incluses dans le générateur de sites :
|
Pages in `/src`can use Gemini (if using `gmi` extension), Markdown, HTML and PHP.
|
||||||
|
|
||||||
| Nom | Description | Source |
|
# Output
|
||||||
|
|
||||||
|
`/*/*.gmi` (if using `.gmi` extension in /src)
|
||||||
|
`/*/*.md`
|
||||||
|
`/*/*.html`
|
||||||
|
`/*/*.gz`
|
||||||
|
|
||||||
|
# External dependencies
|
||||||
|
|
||||||
|
* PHP
|
||||||
|
* gzip
|
||||||
|
* find
|
||||||
|
|
||||||
|
# Internal libraries used
|
||||||
|
|
||||||
|
| Name | Description | Source |
|
||||||
| --------- | --------------------------- | ------------------------------------------ |
|
| --------- | --------------------------- | ------------------------------------------ |
|
||||||
| less.php | Compilateur Less en PHP | https://github.com/wikimedia/less.php |
|
| less.php | Compilateur Less en PHP | https://github.com/wikimedia/less.php |
|
||||||
| parsedown | Compilateur Markdown en PHP | https://parsedown.org |
|
| parsedown | Compilateur Markdown en PHP | https://parsedown.org |
|
||||||
|
|
||||||
# Licence
|
# License
|
||||||
|
|
||||||
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.
|
AGPLv3+
|
||||||
|
|
||||||
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/
|
|
Reference in New Issue