xzebra / notion-blog

notion-blog

notion-blog allows you to use Notion as a CMS for pages built with hugo. You can use it as a cli or even automate your blog repo to update itself with the Github Action.

Requisites

• Notion database for your articles.
• Notion API secret token.
• Hugo powered blog.

Usage

CLI

The cli shows the executable flags when using flag —help.

$> notion-blog —help

Binary

The binary looks for a config file called notionblog.config.json in the directory where it is executed. You can see the example config in notionblog.config.json.

Github Action

To use it as a Github Action, you can follow the example of the repository in .github/worflows/notion.yml.

Compilation

This is only required if you are not going to use the repo as a Github Action. The compilation is simple as Golang installs everything for you.

go build -o ./bin/main cmd/main/main.go

You can compile any form of the app (cli or binary) by compiling the main file in any of the packages in cmd/.

notion-blog's Issues

Exits After "Querying Notion database" with no error message

After compiling a binary and running, it shows the spinner with "Querying Notion database" and then just exits with no error message.

Repeat image name for the screenshot

On the question of pictures, my Notion page is like this https://saltbo.notion.site/Test-post-216c5ab26f15415eb41a057deb8ab975. As you can see, the pictures in this article are all Untitled.png.

reproduce step:

1. screenshot to clipboard
2. go to the notion input area
3. paste directly

Originally posted by @saltbo in #7 (comment)

Like it, hope fly

I like this project very much, and it coincides with my idea: a notion converter + md template = any static blog based on notion

Repositioning: it's not just suitable for hugo, it's suitable for any statically generated blog.
Improve documentation: add a description of archetypeFile or simplify archetypeFile
Change the name: notion-blog and https://github.com/ijjk/notion-blog have the same name, which is not conducive to promotion.

But I don't have any good ideas about changing the name...