Magazine Issues - midnightbreakfast/web GitHub Wiki

The Magazine is broken down into Issues which are published once a month. Each Issue is comprised of 6 pieces, all of which include either an illustration or accompanying photo.

Magazine issues are kept in _src/magazine/_posts and organized into folders according to Issue Number, like issue000 or issue001.

Go to _src/magazine/_posts, and create a new folder for the Issue. Then, inside that folder, create separate files for each piece in the issue.

From the Github website, new files are created using the "+" link after the file path at the top. This is typically used for creating a new file, but if you want to create a new file within a new folder, simply type something like: issue003/2014-08-28-new-article.md. That will create both the new folder, and the new file, all at once.

The files should be named according to the following format: YYYY-MM-DD-slug-goes-here.md, where the slug is the shortened, lowercase, hyphenated form of the title which will be used in the URL.

Use the following as an initial template for the article:

---
layout: post
issue: XXX
type: Above Title
title: Title Goes Here
by: Author Name
author:
  name: TK
  url: TK
  bio: |
    TK

illustrator:
  name: TK
  url: TK
  
featured_image: issueTK/slug/image.jpg
thumb: issueTK/slug/thumb.jpg
---

<figure class="right">
  {% include picture.html path=page.featured_image %}
</figure>

ARTICLE GOES HERE

Documentation regarding images is forthcoming. For now, simply leave that part alone unless you know what you're doing.