You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Niko Abeler 7667190a9c added some OpenGraph meta tags 3 months ago
.vscode refactoring 7 months ago
assets removed reference 6 months ago
cmd/owl resolved warnings 4 months ago
embed added some OpenGraph meta tags 3 months ago
.gitignore renamed old file 5 months ago
Dockerfile adjust Dockerfile 5 months ago
README.md more docs 5 months ago
directories.go resolved warnings 4 months ago
embed.go refactoring rendering 6 months ago
files.go refactoring yaml save/load into functions 4 months ago
go.mod start to use a proper cli library 5 months ago
go.sum start to use a proper cli library 5 months ago
owl_test.go more thread safety 5 months ago
post.go added some OpenGraph meta tags 3 months ago
post_test.go new posts as draft 4 months ago
release.sh release 5 months ago
renderer.go added some OpenGraph meta tags 3 months ago
renderer_test.go added some OpenGraph meta tags 3 months ago
repository.go remove ioutil 4 months ago
repository_test.go new posts as draft 4 months ago
rss.go description in rss items 4 months ago
rss_test.go new posts as draft 4 months ago
user.go resolved warnings 4 months ago
user_test.go resolved warnings 4 months ago
webmention.go refactoring webmention interface 5 months ago
webmention_test.go more thread safety 5 months ago

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
            \- webmentions.yml
                -- Used to track incoming and outgoing webmentions 
            \- 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
  \- media/
       -- All this files will be publicly available. To be used for general files
       \- avatar.{png, jpg, jpeg, gif}
            -- The avatar for the user
  \- 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

webmentions.yml

incoming:
     - source: https://example.com/post
       title: Example Post
       ApprovalStatus: ["", "approved", "rejected"]
       retrieved_at: 2021-08-13T17:07:00Z
outgoing:
     - target: https://example.com/post
       supported: true
       scanned_at: 2021-08-13T17:07:00Z
       last_sent_at: 2021-08-13T17:07:00Z