L'ancien dépot du générateur de sites d'Antopie https://antopie.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.

54 lines
2.0 KiB

2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
  1. 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.
  2. # Usage
  3. Place your pages tree in `/src/*/*.(gmi|md)`.
  4. Optionnal files:
  5. * `/config.ini`
  6. * `/style.less`
  7. * `/logo.png`
  8. * `/head.inc.html`
  9. * `/footer.inc.html`
  10. `mkht.php <site path> <destination >`
  11. `destination` is optionnal and can be:
  12. * `dns` if you want local links without exensions
  13. * `onion` if you want links ending with .onion when available
  14. # Input
  15. Pages in `/src`can use Gemini (if using `gmi` extension), Markdown, HTML and PHP.
  16. # Output
  17. * `/*/*.gmi` (if using `.gmi` extension in /src)
  18. * `/*/*.md`
  19. * `/*/*.html`
  20. * `/*/*.gz`
  21. Note that format translation is only done in the following order:
  22. 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.)
  23. # External dependencies
  24. * PHP
  25. * gzip
  26. * find
  27. # Internal libraries used
  28. | Name | Description | Source |
  29. | --------- | ------------------------ | ------------------------------------------ |
  30. | less.php | Less compiler in PHP | https://github.com/wikimedia/less.php |
  31. | parsedown | Markdown compiler in PHP | https://parsedown.org |
  32. # License
  33. [AGPLv3+](LICENSE)
  34. 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.
  35. 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.
  36. 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/>.