zine

Zine - a simple and opinionated tool to build your own magazine.

https://zineland.github.io

• Mobile-first.
• Intuitive and elegant magazine design.
• Best reading experiences.
• Theme customizable, extend friendly.
• RSS Feed supported.
• Open Graph Protocol supported.
• Article topic supported.
• I18n and l10n supported.
• Build into a static website, hosting anywhere.

Installation

cargo install zine

or brew install zineland/tap/zine

or brew tap zineland/tap, then brew install zine

Get Started

Run zine new your-zine-site, you'll get following directory:

$ tree your-zine-site
your-zine-site
├── content             # The content directory your issues located
│   └── issue-1         # The first issue directory
│       ├── 1-first.md  # The first markdown article in this issue
│       └── zine.toml   # The issue Zine config file
└── zine.toml           # The root Zine config file of this project
2 directories, 3 files

Run zine serve to preview your zine site on your local computer:

$ cd your-zine-site
$ zine serve
███████╗██╗███╗   ██╗███████╗ ╚══███╔╝██║████╗  ██║██╔════╝   ███╔╝ ██║██╔██╗ ██║█████╗  ███╔╝  ██║██║╚██╗██║██╔══╝ ███████╗██║██║ ╚████║███████╗ ╚══════╝╚═╝╚═╝  ╚═══╝╚══════╝
listening on http://127.0.0.1:3000

Run zine build to build your zine site into a static website:

$ cd your-zine-site
$ zine build Build success! The build directory is build.

Some cool magazines powered by Zine

• https://zineland.github.io The zine documentation is built by zine itself.
• https://rustmagazine.org The Rust Magazine.
• https://2d2d.io
• https://o11y.cn
• https://thewhitepaper.github.io

Docmentations

• Getting started
• Customization
• Code blocks
• Advanced

TODO

• [x] Support RSS Feed
• [x] Support render OGP meta
• [x] Support l10n
• [x] Support sitemap.xml
• [x] Support code syntax highlight
• [x] Support table of content
• [x] Support i18n
• [x] zine serve support live reload
• [x] Support article topic

License

This project is licensed under the Apache-2.0 license.