Noblog NPM | npm.io

noblog

This package aims to generate static content from notion.so and provide a plugable component/theme market for you bloggers.

the pattern would be like notablog (see reference), but more flexiable thanks to the mighty power of Astro

Usage

npm install -g noblog
noblog

[OPTIONAL] Duplicate this database and write blogs on it.
Find a astro template, here is a shabby template I made: nobloger

set two env variables:

NOBLOG_DATABASE_ID: your notion database id.
NOTION_API_SECRET: your notion api secret.

Run noblog and deploy your site.

By default, noblog saves all your post (the posts at the surface og your database) under SAVE_PATH.

The articles that are not directly posted on the database is saved under SAVE_PATH/SUB_PATH.

The default value of SAVE_PATH is ./src/pages/posts/, SUB_PATH is nob_children/

So if you run noblog only, the file structure would be,

project root
└──src
   └── pages
       └── posts
           ├── blog_1.md
           ├── blog_2.md
           └── nob_children
               ├── referenced_blog_1.md
               ├── referenced_blog_2.md
               ├── referenced_blog_3.md
               ├── referenced_blog_4.md
               └── referenced_blog_5.md

Save dir could be altered by add args when running command,

noblog <SAVE_PATH> <SUB_PATH>

At this time, all the generated markdown is with Astro style, which means each file has a frontmatter like this,

---
layout: ../../layouts/MarkdownPostLayout.astro
title: "golang blog"
tags: ["lang", "go"]
pubDate: 2024-01-24
archived: false
description: "sometimes I hate, sometimes I love. <3"
---

Layout used is hard coded in the name of ./src/layouts/MarkdownPostLayout.astro

In addition, any astro template that offer ./src/layouts/MarkdownPostLayout.astro and use the default blog file structure (please refer to the code block above) is compatiable with noblog.