feat: docs to publish new bog post
parent
cd9edd0755
commit
5545afbd4a
|
@ -0,0 +1,37 @@
|
||||||
|
# Add new blog post
|
||||||
|
|
||||||
|
1. Create new file at `/content/blog/yyyy-mm-dd-blog-post-title.md` and
|
||||||
|
populate with the following metadata:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
+++
|
||||||
|
title = "title of your blog post"
|
||||||
|
date = "yyyy-mm-dd"
|
||||||
|
description = "description of your blog post, will be displayed in blog listing"
|
||||||
|
|
||||||
|
[taxonomies]
|
||||||
|
tags = ['tags', 'docs', 'rant']
|
||||||
|
|
||||||
|
[extra]
|
||||||
|
# **Only use author nicks in blog post Markdown files, it is used to lookup author details.**
|
||||||
|
author = 'imbatman' # author nickname
|
||||||
|
+++
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Add author details in [`config.toml`](../config.toml) in `authors`
|
||||||
|
under `extra` section:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[extra]
|
||||||
|
# Put all your custom variables here
|
||||||
|
authors = [
|
||||||
|
{ "nick"="imbatman", name="Batman", "website"="https://batman.example.org" },
|
||||||
|
{ "nick"="superman", name="Superman", "website" ="https://superman.example.org" }
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
This information is used to render author information in blog posts.
|
||||||
|
**Only use author nicks in blog post Markdown files, it is used to
|
||||||
|
lookup author details.**
|
||||||
|
|
||||||
|
3. Add content to your blog post file, save and commit! 🎉
|
Loading…
Reference in New Issue