Go to file
Niko Abeler f2999ba53e iss param 2022-11-07 20:00:18 +01:00
.vscode refactoring 2022-07-20 19:32:32 +02:00
assets removed reference 2022-08-15 21:37:04 +02:00
cmd/owl iss param 2022-11-07 20:00:18 +01:00
embed indieauth-metadata 2022-11-07 19:44:10 +01:00
test redirect uri verification 2022-11-06 14:36:37 +01: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 warning 2022-11-01 22:00:01 +01:00
auth_test.go redirect uri verification 2022-11-06 14:36:37 +01:00
directories.go resolved warnings 2022-10-13 21:03:16 +02:00
embed.go refactoring rendering 2022-08-18 21:06:06 +02:00
files.go refactoring yaml save/load into functions 2022-10-13 20:48:43 +02:00
go.mod setting user password 2022-11-03 20:25:53 +01:00
go.sum setting user password 2022-11-03 20:25:53 +01:00
owl_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00
post.go added some OpenGraph meta tags 2022-10-19 21:14:31 +02:00
post_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00
release.sh release 2022-08-31 20:03:49 +02:00
renderer.go first successfull token issuing (tested with quill.p3k.io) 2022-11-06 19:57:44 +01:00
renderer_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00
repository.go remove ioutil 2022-10-13 21:00:28 +02:00
repository_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00
rss.go setting user password 2022-11-03 20:25:53 +01:00
rss_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00
user.go check age of auth code 2022-11-07 19:53:32 +01:00
user_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00
utils.go CSRF 2022-11-05 21:17:31 +01:00
webmention.go redirect uri verification 2022-11-06 14:36:37 +01:00
webmention_test.go WIP redirect_uri verification 2022-11-06 14:17:14 +01:00

README.md

Mascot

Owl Blogs

A simple web server for blogs generated from Markdown files.

This project is not yet stable. Expect frequent breaking changes! Only use this if you are willing to regularly adjust your project accordingly.

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
            \- incoming_webmentions.yml
                -- Used to track incoming webmentions
            \- outgoing_webmentions.yml
                -- Used to track 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
       \- config.yml
            -- Holds information about the user
       \- 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}
            -- Optional: Avatar to be used in various places
       \- favicon.{png|jpg|jpeg|gif|ico}
            -- Optional: Favicon for the site

User Config

Stored in meta/config.yml

title: "Title of the Blog"
subtitle: "Subtitle of the Blog"
header_color: "#ff0000"
author_name: "Your Name"
me:
  - name: "Connect on Mastodon"
    url: "https://chaos.social/@h4kor"
  - name: "I'm on Twitter"
    url: "https://twitter.com/h4kor"

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.
  • description is optional. At the moment this is only used for the HTML head meta data.
  • aliases are optional. They are used as permanent redirects to the actual blog page.
  • draft is false by default. If set to true the post will not be accessible.
  • reply optional. Will add the link to the top of the post with rel="in-reply-to". For more infos see: https://indieweb.org/reply
---
title: My new Post
Description: Short text used in meta data (and lists in the future)
date: 13 Aug 2022 17:07 UTC
aliases:
     - /my/new/post
     - /old_blog_path/
draft: false
reply:
     url: https://link.to/referred_post
     text: Text used for link
---

Actual post

Webmentions

This feature is not yet full supported and needs a lot of manual work. Expect this to change quiet frequently and breaking existing usages.

To send webmentions use the command owl webmention

Retrieved webmentions have to be approved manually by changing the approval_status in the incoming_webmentions.yml file.

incoming_webmentions.yml

- source: https://example.com/post
  title: Example Post
  approval_status: ["", "approved", "rejected"]
  retrieved_at: 2021-08-13T17:07:00Z

outgoing_webmentions.yml

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