---
# System prepended metadata

title: Writing Blog Posts for the Forgotten Runes Website

---

# Writing Blog Posts for the Forgotten Runes Website

The blog posts are just text files in the `/posts` directory of the repository.

[The posts folder of the repository is here](https://github.com/forgottenrunes/forgotten-runes-website/tree/master/posts).

![](https://i.imgur.com/X4L4kYn.png)

If you:

- **add** a file, it will create a new blog post
- **update** a file, it will edit that blog post

## File format


The file format is Markdown. HackMD is one way to write markdown (but not the only way, because it is an open standard).

### The Body

This means you can copy and paste markdown from anywhere and it will work just fine. 

### The Header

Each file has a header that lets you configure stuff. It looks like this:

```
---
title: Wizard Murals
description: "See a Wizard in physical paint in your neighborhood"
ogImage: https://i.imgur.com/fg29jza.jpg
index: 5
category: art
---
```

Notice that it has the three `---` marks at the beginning and end, and then has 5 settings:

* `title`: The title of the blog post
* `description`: The description of the blog post
* `ogImage`: A URL to an image to use in the social preview card (optional)
* `index`: What order you want it to appear in (optional)
* `category`: Whatever category you want. Currently we have: "lore", "art", "collection", and "community"

## Editing a file

Go to the [posts directory](https://github.com/forgottenrunes/forgotten-runes-website/tree/master/posts) and find the file you want to edit. Click on it.

Then, click the pencil button that says: "edit this file"
![](https://i.imgur.com/rpDqAcA.png)

You will get an editor where you can make your changes (and click "preview" if you want to preview them)

![](https://i.imgur.com/lNlqSVW.png)

Then scroll down and type your commit message:  
![](https://i.imgur.com/1HToTcr.png)

Click "commit changes"

**Now the change will automatically be deployed to the live site** (it takes about 20 minutes).

## Adding a File

Adding a file is a lot like editing a file:

Go to the [posts directory](https://github.com/forgottenrunes/forgotten-runes-website/tree/master/posts) 

Click "Add file" and choose "Create new file"

![](https://i.imgur.com/I5gaNQ5.png)

Give your post a filename. **This path will be the URL**.

![](https://i.imgur.com/TWJLuLM.png)

Paste your markdown here:

![](https://i.imgur.com/votRY9V.png)

> NOTE! Be sure to add the _header_ as described above. This gives your post a title etc.

Now add a description, "added new post" and hit "save"

![](https://i.imgur.com/U2j97XD.png)

The blog post will automatically deploy to production (the build takes about 20 minutes)
