Zine
Quickstart
Warning
Zine is alpha software.
Using Zine today means participating in its development.
1. Get Zine
Download Zine for your platform.
If instead you prefer compiling from source, you will need Zig.
2. Init a new Zine site
shell
$ mkdir example.com
$ cd example.com
$ zine init
Running zine init
will create all the files required to get a Zine site up and running.
The Zine sample site will contain a couple basic pages and two already made sections:
- a blog
- a devlog
The devlog is a form of microblogging powered by Zine’s expressive templating system where you add new entries not by creating new pages (like in a blog), but rather by adding a new paragraph within a single content page. The devlog has its own dedicated RSS feed where every post has a separate entry.
Zine has a devlog as well, and a few other projects are also starting to adopt this communication format. If you too are developing an Open Source project, or just like microblogging, consider giving it a try as a zen alternative to mainstream social media platforms.
3. Get developer tooling
This step is optional but strongly recommended as it will give you access to syntax highlighting, autoformatting and language server diagnostics for your editor.
If you have VSCode, install Ziggy
, SuperMD
and SuperHTML
from the VSCode Extensions tab (the right extensions are all from Loris Cro
).
If you don’t use VSCode, see the Editor support section.
Start editing your Zine site
Run zine
(without subcommand) to start the development server and begin editing your new Zine site.
Every time you save a file, the dev server will automatically rebuild the site and reload your browser page.
To learn more about Zine, see the docs section.
See the Community page to join our community.