Go to file
Niko Abeler d66c1a6817 WIP adding guards to webmention 2022-09-09 21:14:49 +02:00
.vscode refactoring 2022-07-20 19:32:32 +02:00
assets removed reference 2022-08-15 21:37:04 +02:00
cmd/owl #13 GitHub Handle 2022-09-08 21:28:05 +02:00
embed #13 GitHub Handle 2022-09-08 21:28:05 +02:00
.gitignore renamed old file 2022-08-24 21:15:23 +02:00
Dockerfile adjust Dockerfile 2022-09-05 21:23:43 +02:00
README.md WIP outgoing webmentions 2022-09-04 15:03:16 +02:00
directories.go limit posts to single depth directory 2022-08-03 18:03:10 +02:00
embed.go refactoring rendering 2022-08-18 21:06:06 +02:00
go.mod start to use a proper cli library 2022-09-05 20:34:24 +02:00
go.sum start to use a proper cli library 2022-09-05 20:34:24 +02:00
owl_test.go refactoring to have full http response in parser 2022-09-06 20:32:21 +02:00
post.go WIP adding guards to webmention 2022-09-09 21:14:49 +02:00
post_test.go WIP adding guards to webmention 2022-09-09 21:14:49 +02:00
release.sh release 2022-08-31 20:03:49 +02:00
renderer.go twitter handle + refactor user config in renderer 2022-09-06 21:32:31 +02:00
renderer_test.go #13 GitHub Handle 2022-09-08 21:28:05 +02:00
repository.go refactoring to have full http response in parser 2022-09-06 20:32:21 +02:00
repository_test.go refactoring to have web config (single user, unsafe) in config of repo 2022-09-05 20:50:46 +02:00
rss.go refactoring reading Meta and RenderedContent 2022-08-22 21:15:36 +02:00
rss_test.go items in rss feed. #3 2022-08-13 18:47:56 +02:00
user.go #13 GitHub Handle 2022-09-08 21:28:05 +02:00
user_test.go refactoring to have web config (single user, unsafe) in config of repo 2022-09-05 20:50:46 +02:00
webmention.go improved header parsing 2022-09-06 21:17:25 +02:00
webmention_test.go improved header parsing 2022-09-06 21:17:25 +02:00

README.md

Mascot

Owl Blogs

A simple web server for blogs generated from Markdown files

Repository

A repository holds all data for a web server. It contains multiple users.

User

A user has a collection of posts. Each directory in the /users/ directory of a repository is considered a user.

User Directory structure

<user-name>/
  \- public/
       \- <post-name>
            \- index.md
                -- This will be rendered as the blog post.
                -- Must be present for the blog post to be valid.
                -- All other folders will be ignored
            \- status.yml
                -- Used to track various process status related to the post, 
                -- such as if a webmention was sent.
            \- media/
                -- Contains all media files used in the blog post.
                -- All files in this folder will be publicly available
            \- webmention/
               \- <hash>.yml
                    -- Contains data for a received webmention
  \- meta/
       \- base.html
            -- The template used to render all sites
       \- VERSION
            -- Contains the version string.
            -- Used to determine compatibility in the future
  \- config.yml
        -- Contains settings global to the user.
        -- For example: page title and style options

Post

Posts are Markdown files with a mandatory metadata head.

  • The title will be added to the web page and does not have to be reapeated in the body. It will be used in any lists of posts.
  • aliases are optional. They are used as permanent redirects to the actual blog page.
---
title: My new Post
date: 13 Aug 2022 17:07 UTC
aliases:
     - /my/new/post
     - /old_blog_path/
---

Actual post

status.yml

webmentions:
     - target: https://example.com/post
       supported: true
       scanned_at: 2021-08-13T17:07:00Z
       last_sent_at: 2021-08-13T17:07:00Z