Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bytesnake/ztl
Render notes from Markdown, LaTeX and BibTeX to terminal and Mastodon
https://github.com/bytesnake/ztl
Last synced: 10 days ago
JSON representation
Render notes from Markdown, LaTeX and BibTeX to terminal and Mastodon
- Host: GitHub
- URL: https://github.com/bytesnake/ztl
- Owner: bytesnake
- License: mit
- Created: 2024-09-22T12:59:48.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-16T17:44:49.000Z (2 months ago)
- Last Synced: 2024-10-18T15:30:19.087Z (2 months ago)
- Language: Rust
- Homepage:
- Size: 24.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ZTL - Zettel Tools by Lorenz
Ztl provides a unified way to render notes from Markdown, LaTeX and BibTeX. Generated cache provides spanning information for editors like ViM and HTML artifacts to publish notes to Mastodon and for live preview with SIXEL enabled terminals.
The repository provides a terminal tool written in Rust to generate note cache and a Neovim plugin for navigation.
## Features
- render note source from Markdown with [comrak](https://github.com/kivikakk/comrak), LaTeX with [TeX4ht](https://tug.org/tex4ht/) and BibTeX to standalone HTML and MathML
- abstract files from individual notes, provides linking capabilities between any file format
- generate unified representation with TOML files to cache folder at `.ztl/cache/` for downstream plugins
- use span and note information for note navigation and publishing to MastodonSupported subcommands of `ztl` are
```bash
Usage: ztl [OPTIONS] [COMMAND]Commands:
watch Watch files and rebuild
publish Publish notes to Mastodon instance
build Build all notes from scratch
help Print this message or the help of the given subcommand(s)Options:
-d, --debug... Enable debugging
-h, --help Print help
-V, --version Print version
```## Example with LaTeX
![Peek 2024-10-16 19-43](https://github.com/user-attachments/assets/ba966a55-9b75-40e9-9249-68ac221ebd0b)
### WIP
- [x] support for Markdown and LaTeX rendering
- [x] generate cache for navigation plugins in editor
- [x] publish set of notes to Mastodon
- [ ] write more complete documentation and installation guide