https://github.com/pivaldi/asymptote-exemples-builder
The Asymptote Exemples Builder
https://github.com/pivaldi/asymptote-exemples-builder
asymptote-language build-tool hexo-blog html-generator
Last synced: 7 days ago
JSON representation
The Asymptote Exemples Builder
- Host: GitHub
- URL: https://github.com/pivaldi/asymptote-exemples-builder
- Owner: pivaldi
- License: gpl-3.0
- Created: 2025-02-15T14:59:08.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-30T20:11:20.000Z (12 months ago)
- Last Synced: 2025-06-30T21:25:15.326Z (12 months ago)
- Topics: asymptote-language, build-tool, hexo-blog, html-generator
- Language: XSLT
- Homepage: https://blog.piprime.fr/asymptote/
- Size: 1.12 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# The Asymptote Exemples Builder
This project provides a set of `bash` commands to export the
[Asymptote Examples](https://github.com/pivaldi/asymptote-exemples)
to various format like `html`, `markdown` for
[The Hexo Blog Framework](https://hexo.io/docs/) and pdf (TODO).
## Dependencies
This project is only for `Gnu Linux` users and need these softwares
properly installed :
- [Asymptote](https://asymptote.sourceforge.io/)
- [Gnu Make](https://www.gnu.org/software/make/)
- The Python syntax highlighter [Pygments](https://pygments.org/)
- [xsltproc](http://xmlsoft.org/xslt/xsltproc.html)
- [ImageMagick](https://imagemagick.org/index.php)
- [pdftk](https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/)
- [pdfinfo](https://www.xpdfreader.com/pdfinfo-man.html) (`apt install poppler-utils` on Debian)
- [FFmpeg](https://www.ffmpeg.org/) (`apt install ffmpeg` on Debian)
## Usage
The first think to do is to launch the command `./configure` and answer to the questions.
Next, you can use the make commands :
- `make html` to generate in `./build/html/` all the `html` files needed to browse the
Asymptote Example Codes base.
The entry point is `./build/html/index.html`, to be opened with your favorite html browser.
- `make md-hexo` to generate the `markdown` files for Hexo with individual posts,
specific topics pages, specific categories pages and specific tags pages.
After-wise, you can synchronize the directories `build/md/hexo/page/` to your
Hexo `source/asymptote` directory and `build/md/hexo/post/` to your Hexo
`source/_posts` directory or something like that.
- `make help` gives you some helps for all commands available in the `Makefile`.
# If you appreciate this project
[☕ Buy Me a Coffee](https://buymeacoffee.com/pivaldi).