|
|
|
|
@@ -1,5 +1,5 @@
|
|
|
|
|
---
|
|
|
|
|
title: "Welcome to My Blog"
|
|
|
|
|
title: "Read Me . Markdown!"
|
|
|
|
|
date: "2025-05-17"
|
|
|
|
|
tags: ["welcome", "introduction"]
|
|
|
|
|
summary: "Read Me Please"
|
|
|
|
|
@@ -7,56 +7,72 @@ summary: "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.
|
|
|
|
|
This blog was built as a response to the lack of blogging systems that accept "human readable" formats editable in a terminal emulator.
|
|
|
|
|
|
|
|
|
|
**Prequesits:**
|
|
|
|
|
- NPM
|
|
|
|
|
- Docker (optional)
|
|
|
|
|
**Prerequisites:**
|
|
|
|
|
- NPM
|
|
|
|
|
- Docker (optional)
|
|
|
|
|
|
|
|
|
|
Thats about it.
|
|
|
|
|
That's 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.)
|
|
|
|
|
## Formatting
|
|
|
|
|
|
|
|
|
|
Standard Markdown is supported. HTML with some basic CSS too! External CSS files aren't supported. JavaScript files aren't supported either (and won't be in the future, as it's 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. |
|
|
|
|
|
| <span style="color:blue;">data</span> | 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 destination files. |
|
|
|
|
|
|
|
|
|
|
HTML:
|
|
|
|
|
<p style="background-color:grey;color:white;font-style:italic;">If you noticed <span style="color: #5BCEFA; font-weight: bold;">data</span> was blue! This works due to the HTML / CSS / Markdown <span style="font-weight: bold; font-size: 1em; padding: 0.2em 0.4em; border-radius: 4px;"><span style="color: #5BCEFA;">T</span><span style="color: #F5A9B8;">r</span><span style="color: #FFFFFF;">a</span><span style="color: #F5A9B8;">n</span><span style="color: #5BCEFA;">s</span></span>piler. This basically means you can embed HTML into your Markdown blog-styled posts, and it will interpret correctly!</p>
|
|
|
|
|
|
|
|
|
|
<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>
|
|
|
|
|
**HTML Example:**
|
|
|
|
|
|
|
|
|
|
<p style="text-align:center;font-style:italic;font-weight:bold;font-size:2em;background-color:grey;font-family:cursive;color:white;">Hello from HTML</p>
|
|
|
|
|
|
|
|
|
|
Heres the fancy **source code** for the **interrested**:
|
|
|
|
|
|
|
|
|
|
```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>
|
|
|
|
|
<p style="text-align:center;font-style:italic;font-weight:bold;font-size:2em;background-color:grey;font-family:cursive;color:white;">Hello from HTML</p>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Some technical Information:
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
For the development I used:
|
|
|
|
|
## Some Technical Information
|
|
|
|
|
|
|
|
|
|
For development, I used:
|
|
|
|
|
- Docker
|
|
|
|
|
- TypeScript
|
|
|
|
|
- Next.JS
|
|
|
|
|
- Git (ofc)
|
|
|
|
|
- Next.js
|
|
|
|
|
- Git (of course)
|
|
|
|
|
|
|
|
|
|
## Building:
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Building
|
|
|
|
|
|
|
|
|
|
If you are deploying this on your machine for whatever reason, please note:
|
|
|
|
|
- Docker Building is fully implemented and supported
|
|
|
|
|
- Docker will deploy this app to Port 8080 (http://localhost:8080)
|
|
|
|
|
- If you run this with:
|
|
|
|
|
- Docker building is fully implemented and supported.
|
|
|
|
|
- Docker will deploy this app to port 8080 (http://localhost:8080)
|
|
|
|
|
- If you run this with:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
- Note that the build times will take a while. Docker takes ages too, but once built it can recover stuff from the cache, so it's much faster after the first build.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Administration
|
|
|
|
|
|
|
|
|
|
If you are a Admin then the default password / user is
|
|
|
|
|
<p style="color:red;font-style:bolder;">Please set your name (or not) in @.env.local! Before deploying this to Docker!</p>
|
|
|
|
|
|
|
|
|
|
If you are an admin, then the default username and password are:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
user: admin
|
|
|
|
|
@@ -64,14 +80,39 @@ 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.
|
|
|
|
|
> Change the administration password once the server is set up. This is really easy!
|
|
|
|
|
> The server will store your password as a hash. So be careful of people getting that hash.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
You can pin a Post both in the UI and in the Backend of the Server.
|
|
|
|
|
You can pin a post both in the UI and in the backend of the server.
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
/path/to/your/instance/posts/pinned.json
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## TODO
|
|
|
|
|
|
|
|
|
|
| Status | Task |
|
|
|
|
|
|:------:|:----:|
|
|
|
|
|
|<span style="color:red;">NOT DONE!</span>|GitHub's Caution/Error Stuff|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Issues
|
|
|
|
|
|
|
|
|
|
If any issues pop up, please open a Gitea issue with **proper** error reports!
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Closing Statements
|
|
|
|
|
|
|
|
|
|
Developing of this Applet has been really fun! Thanks JavaScript for fucking my ass harder than , eh ... idk , im gay, i cant make jokes about this.
|
|
|
|
|
Yeah fuck JavaScript, TypeScript is better.
|
|
|
|
|
|
|
|
|
|
<q style="font-style:italic;">
|
|
|
|
|
- Thanks Ratta<b>twink</b>o ; 17.05.2025
|
|
|
|
|
</q>
|
|
|
|
|
<img src="https://upload.wikimedia.org/wikipedia/commons/4/48/Gay_Pride_Flag.svg" style="width:50px;height:50px;float:left;"/>
|