Welcome to Kaa - a Python-based HTML blog generator! Convert your Markdown to structured HTML blogs.
Install using pip install -r requirements.txt.
Create a new post in the posts directory. Call it whatever you like.
The first line of the file will be the title of the blog post. The date will be automatically populated from the time you created or modified the file.
The rest of the file should be the content of the blog post in Markdown format.
You can create a file anywhere in your posts directory, and it will be converted to HTML and added to your blog. If you want a file to be treated as a page, with a permalink on the homepage, homepage, you can add the file name to the pages array in config.json.
After cloning the repository, you can use the following command to build your blog from markdown files if you're doing this for the first time (chmod is necessary to allow the build script to be executed, but you only need to do this once):
chmod +x build.sh && ./build.shAfter the first time, you can just run the following command to build your blog:
./build.shIf you prefer, or you have special Python environment requirements, you can also run the following command to build your blog:
python3 generate_htmlYou can deploy your blog to a service like Vercel, Netlify, or Heroku.
If your chosen service supports build steps, you can instruct the service to run build.sh or python3 generate_html before deploying your blog, and then you don't even need to build it! Of course, it only takes a second to build, and then you can identify any errors that might pop up, but to each their own!
- Markdown to HTML conversion
- Automatic sitemap generation
- Easy URL configuration in
config.json