sebastienrousseau / kaishi.github.io

Make beautiful websites with Kaishi, a Shokunin (職人) Static Site Generator starter template.

Home Page:http://kaishi.one/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Logo of the Kaishi Starter Template

Kaishi.one 🌏

Welcome to Kaishi.one, a Starter Template for Shokunin! This documentation will guide you through the process of getting up and running with Kaishi in just a few minutes.

Banner of the Kaishi Starter Template

Installation

To use Kaishi, you'll need to install the Rust-based library called Shokunin.

Follow the steps below to get started:

  1. Install the Rust toolchain: Before installing Shokunin and Kaishi, make sure you have the Rust toolchain installed on your machine. You can find instructions for installing the Rust toolchain on the Rust website.

  2. Install Shokunin: Once you have the Rust toolchain installed, open your terminal and run the following command to install Shokunin:

cargo install ssg

Shokunin is the core library that powers Kaishi. It is a Rust-based static site generator that can be used to generate a static website from a set of Markdown files and HTML templates.

  1. Download the Kaishi Starter Template: You can download the Kaishi Starter Template from the Kaishi website. Alternatively, you can download the Kaishi Starter Template directly from GitHub.

Usage 📖

Shokunin provides a simple command line interface (CLI) for managing and building your website. Here are some of the most common commands:

  • Create a new site: Use the following command to create a new site based on the Kaishi template:
cd kaishi/
ssg  --new=docs --content=_posts --template=_layouts --output=output --serve=public

Alternatively, you can use the shorthand version of the command:

cd kaishi/
ssg -n=docs -c=_posts -t=_layouts -o=output -s=public

This command will create a new directory called docs within the Kaishi project directory. It will use the specified _posts directory for your site's content, the _layouts directory for the site's template files, and generate the output files in the output directory.

Now you're ready to start building your website with Kaishi! Feel free to customize the content, modify the template, and explore the features of Shokunin.

Happy coding!

About

Make beautiful websites with Kaishi, a Shokunin (職人) Static Site Generator starter template.

http://kaishi.one/

License:Apache License 2.0


Languages

Language:HTML 87.0%Language:JavaScript 11.8%Language:Python 1.2%