joplin-mdbooks-website/README.md
2024-07-11 00:07:42 -04:00

2.0 KiB

Joplin to mdbook Website Generator

Export your joplin notes into a mdbook compatible format for easy website creation.

joplinexport

  • Connects to the local Joplin database.sqlite file and iterates through all the folders, notes and their individual tags. If the note has the blog tag, do the following:
    • Grab the contents of the note, resolve any links to other notes and replace them with the proper HTML path
    • If the note has images or other resources, resolve and replace the filepath to the resource with the HTML path and then export the resource to the /content/resources directory.
    • export the contents of the note to a .md file within the /content directory.
  • Generates a SUMMARY.md file within the /content directory with each of the folders and notes that had the blog tag.
    • If there is a Welcome note with the blog tag, it will be placed at the top of the SUMMARY.md file before any other folders/notes, this will be the landing page of the website.

Settings

  • The mdbook configuration files: config.toml and book.toml are responsible for all the settings for the website. See for detailed breakdown.

This project is a fork of the very skilled Stavros Korokithakis's Project

Notable Changes

  • Notes and Folders are grabbed based on a whitelist instead of a blacklist
    • Instead of checking if a notebook/note is tagged with "private", instead checks if the notebook/note is tagged with "blog"

Stavros' notes

This is a static website that gets autogenerated from a bunch of Joplin notes. I wrote a small script to read the notes, export them, and generate a static site. If you want to use the script and generate such a site for yourself, feel free to fork this repository.

Just run ./joplinexport, it will read the database and create a site like this one and upload it to GitLab pages.

You can see the final site at:

https://notes.stavros.io