# 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).


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"

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


Then scroll down and type your commit message:

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"


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


Paste your markdown here:


> 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"


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