Files
markdownblog/posts/welcome.md

2.2 KiB

title, date, tags, summary
title date tags summary
Welcome to My Blog 2025-05-17
welcome
introduction
Read Me Please

Welcome to the Blog

This Blog was built as a response to the lack of blogging systems that accept "Human readable" Formats that are editable in a Terminal Emulator.

Prequesits:

  • NPM
  • Docker (optional)

Thats about it.

Formating:

Standard Markdown is supported. HTML with some basic CSS too! External CSS Files arent Supported JavaScript files arent supported too. (This will not be supported in the Future as it is a safety risk.)

This is Markdown!

Option Description
data path to data files to supply the data that will be passed into templates.
engine engine to be used for processing templates. Handlebars is the default.
ext extension to be used for dest files.

HTML:

Hello from HTML

<p style="text-align:center;font-style:italic;font-style:bold;font-size:2em;background-color:grey;font-family:cursive;color:white;">Hello from HTML</p>

Some technical Information:

For the development I used:

  • Docker
  • TypeScript
  • Next.JS
  • Git (ofc)

Building:

If you are deploying this on your machine for whatever reason, please note:

  • Docker Building is fully implemented and supported
  • If you run this with:
npm install && npm run dev # or production (if you're fancy enough to deal with it)
  • note that the build times will take like 10 Years. Docker takes ages too , but once built it can recover shit from the cache. So its faster by a TON.

Administration

If you are a Admin then the default password / user is

user: admin
password: admin

Caution

Change the Administration Password once the Server is set up. This is really easy! The server will store your password in a Hash. So be carefull of people getting that Hash.


You can pin a Post both in the UI and in the Backend of the Server.

/path/to/your/instance/posts/pinned.json