This is a blog software completely written in C# / Blazor. The aim is to have it configurable as possible.
The basic idea is that the content creator writes his posts in markdown language (like this readme file). The markdown will then be translated into HTML and displayed to the client. This gives an easy entry to writing posts with all the flexibility markdown has. This also includes source code snippets. Highlighting is done via highlight.js with the GitHub theme.
The blog software allows you to integrate via different micro-transaction services. The following chapter will show you how to set up donations.
You can use Ko-fi as a payment service to receive donations. To acquire the KofiToken as seen in the config above, head to widgets page, click on "Ko-fi Button".
Now choose "Image" as the type. In the field below under Copy & Paste Code you see an <a href='https://ko-fi.com/XYZ' tag. Just take the XYZ part and put it into KofiToken.
Enables the usage of GitHub Sponsors as a payment service to receive donations. Only pass in your username. The button will use the following url: https://github.com/sponsors/{your-user-name}.
The blog includes some of the most important tags to get indexed by a crawler. Furthermore, some aspects of the Open Graph specification are implemented.
In the wwwroot/ you can find a default robots.txt. It allows the site gets completely indexed. If you want to tweak that behavior - feel free.
Also, you can provide a sitemap.xml to get a better ranking. The blog can create a sitemap.xml on its own. For that log in and click on the Admin button in the navigation bar and afterward on Sitemap. There you can let the blog create a new one for you. This is especially helpful after you created a new blog post to make it easier for indexers like Google.
To get better results when for example shared via LinkedIn some of the <meta property="og:tag"> tags are implemented.
The following tags are set depending on the page:
| Open Graph Tag | Index | Display Blog Post |
|---|---|---|
| og:title | Title of the blog (defined in Introduction) | Title of the Blog Post |
| og:url | Url to the index page | Url of the page |
| og:image | Profile image (defined in Introduction) | Uses the preview image. If a fallback is defined this will be used instead. |
| og:type | article | article |
| og:description | Short description in plain text (defined in Introduction) | Short Description of Blog Post in plain text |
Furthermore, the following tags are set:
| Tag | Index | Display Blog Post |
|---|---|---|
| Title of the web page | Defined in AppConfiguration.BlogName | Title of the blogpost |
| <meta name="keyword" content="" /> | not set | Tags defined in the Blog Post |
This blog also offers an RSS feed (RSS 2.0 specification), which can be consumed by your users or programs like Feedly. Just append feed.rss to your URL or click on the RSS feed icon in the navigation bar to get the feed. The RSS feed does not expose the whole content of a given blog post but its title and short description including some other tags like preview image, publishing date and so on.
