kushaldas / khata

Look at https://kushaldas.in for the result

Khata: The writing pad

This is the Rust implementation of Shonku project.

This is kind of stable, I am using it for long enough now for my blog.

Need nightly rust

rustup default nightly

To build from the source for normal systems

cargo build --features shadow --release

The shadow feature will enable -e/--exe to get details about the executable. But, in case you want to run it under WASI, then build it using the following command.

cargo build --target wasm32-wasi --release

How to use?

You will the following directory structure.

|-> templates
|-> pages
|-> posts
|-> output
    |
    |-> posts
    |-> pages
    |-> categories
    |-> assets

You can make them all as

mkdir -p pages posts output/{posts,pages,categories}
cp -r assets output/

To use WASI

cp ./target/wasm32-wasi/release/khata.wasm ./
wasmtime --dir=. khata.wasm -- -h

Create a new blog post

./khata --new
wasmtime --dir=. khata.wasm -- --new

Build the posts after any change

./khata
wasmtime --dir=. khata.wasm

To build the updated/new posts.

To rebuild the whole site

./khata --rebuild
wasmtime --dir=. khata.wasm -- --rebuild

To rebuild the whole site.

To view the help

./khata -h
wasmtime --dir=. khata.wasm -- -h

To view all the help options.

We have default templates and assets in the git repo.

To view which binary you are using (when you enable shadow feature)

./khata -e

khata's Issues

There should not be any relative URL

description should not contain relative URL references: /posts/using-python-to-access-onion-network-over-socks-proxy.html

Missing atom link

https://validator.w3.org/feed/docs/warning/MissingAtomSelfLink.html explains the issue.

RSS is missing guid

Each item of the feed should have tag.

Typo in copy command in README.md

Read-me section of making directory structure.
cp -r assests output/
should be
cp -r assets output/

Pushing datetime is not proper RFC822 complient

Problematical RFC 822 date-time value: Tue, 6 Oct 2020 09:35:15 +0530

There is more than 1 space and also date number should be double digit.

[Fix] Overflow Issue

• I just tried fixing the overflow issue in your website

• adding overflow-wrap: anywhere; to .vertical class is fixing it

• looks like your github repo does not reflect the latest blog changes. I
  tried looking for the sceen.css file, in which this class is present, Ot
  herwise i could have sent a PR