Ancien dépôt du générateur de sites d'Antopie , désormais séparé entre mkht.php et antopie https://antopie.org
This repository has been archived on 2023-05-26. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Miraty 0301cdcf60 Merge pull request 'README: "Générateur de site d'Antopie" becomes mkht.php' (#5) from readme into master
Reviewed-on: #5
2021-10-09 19:30:45 +02:00
antopie Move source documents to src/ 2021-10-07 20:21:30 +02:00
bibli Remove pages.inc.php metadata 2021-09-21 19:19:05 +02:00
.gitignore Move source documents to src/ 2021-10-07 20:21:30 +02:00
LICENSE Grosse màj 2019-03-22 21:39:49 +01:00
LICENSE.html Various changes 2021-09-18 19:08:26 +02:00
LICENSE.md Grosse màj 2019-03-22 21:39:49 +01:00
README.md Add license informations 2021-10-07 14:14:38 +02:00
compil.php Move source documents to src/ 2021-10-07 20:21:30 +02:00
style.less Move source documents to src/ 2021-10-07 20:21:30 +02:00

README.md

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.

Usage

Place your pages tree in /src/*/*.(gmi|md).

Optionnal files:

  • /config.ini
  • /style.less
  • /logo.png
  • /head.inc.html
  • /footer.inc.html

mkht.php <site path> <destination >

destination is optionnal and can be:

  • dns if you want local links without exensions
  • onion if you want links ending with .onion when available

Input

Pages in /srccan use Gemini (if using gmi extension), Markdown, HTML and PHP.

Output

  • /*/*.gmi (if using .gmi extension in /src)
  • /*/*.md
  • /*/*.html
  • /*/*.gz

Note that format translation is only done in the following order: Gemini > Markdown > HTML, which means that the last of these formats you will use will be the first that will be readable by hypertext browsers. (PHP is executed before.)

External dependencies

  • PHP
  • gzip
  • find

Internal libraries used

Name Description Source
less.php Less compiler in PHP https://github.com/wikimedia/less.php
parsedown Markdown compiler in PHP https://parsedown.org

License

AGPLv3+

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.