Yotsuba Society Website

This is the new Jekyll/Minimal-Mistakes based Yotsuba Society website, created by the Bibliotheca Anonoma to replace the rotting Drupal 7.x website they used to use. Sometimes, even the archivists need to be archived.

And don't worry, all the old pagelinks and downloads still work (we worked hard to make that possible), so no need to change your bookmarks.

Getting Started

Minimal Mistakes takes advantage of Sass and data files to make customizing easier. These features require Jekyll 2.x and will not work with older versions of Jekyll.

To learn how to install and use this theme check out the Setup Guide for more information.

Creating/Editing a Blog Post

To create a new blog post, go to the _posts/ folder (the one with an underscore) in this repository and click the button pictured below to Create a new file here.

Make sure to name your file, and follow the format of 2014-09-15-post-shortlink.md. The words in the filename will be used as the shortlink, in this case http://yotsubasociety.org/post-shortlink/.

Next, you need to create a FrontMatter section at the top. Just copy and paste the following and change fields as necessary: It is recommended that you specify some categories. Check the Jekyll FrontMatter documentation for more info.

---
layout: post
title: "This is your Blog Title, Change this"
excerpt: "Write a short description of your post here, this will be displayed as a preview."
tags: [blog, example]
category: "Example Category"
modified: 2014-09-15 14:40:45
---

Note: Alternatively, to edit an existing post, click the file in the _posts/ folder, and click Edit at the top right.

Now, you can write your blog post in Markdown format, right below the FrontMatter. Check out Github's excellent Markdown Tutorial to get a feel for this powerful markup language.

When you're finished, make sure to write a description of your changes in the Commit changes section. Then, click the green Commit Changes button to post the page to the blog.

Create and edit Pages

Jekyll can do much more than plain ol' blog posts. You can also make website pages, for Articles or Briefings.

To create a new page, go to the pages/ folder (no underscore) in this repository and click the button pictured below to Create a new file here.

Make sure to name your file, and follow the format of page-shortlink.md (no date necessary for pages). The words in the filename will be used as the shortlink, in this case http://yotsubasociety.org/page-shortlink/.

---
layout: page
title: "This is your Page Title, Change this"
excerpt: "Write a short description of your page here, this will be displayed as a preview."
tags: [page, example]
category: page
modified: 2014-09-15 14:40:45
---

Note: Alternatively, to edit an existing post, click the file in the posts/ folder, and click Edit at the top right.

Now, you can write your page in Markdown format, right below the FrontMatter. Check out Github's excellent Markdown Tutorial to get a feel for this powerful markup language.

When you're finished, make sure to write a description of your changes in the Commit changes section. Then, click the green Commit Changes button to post the page to the blog.

Finally, you must link to the page before anyone will be able to access it.

If this page is an Article, click the articles.md file under the pages/ folder.
Then, click Edit at the top right. Then add a link to your new page in the bulleted list, as follows:

Note: Make sure to create a relative link to the page. If your page's URL is http://yotsubasociety.org/intro-to-ys/, just link to ../intro-to-ys/.

* [Introduction to Yotsuba Society](../intro-to-ys/)
* [The Protochannel and the First Channel](../ayashii-and-amezou/)

Note: The ../ prefix is used because the generated articles page is one directory level below the website folder.

Now your page is available for the public to enjoy.

Special Jekyll Markdown Syntax

Jekyll uses some unique syntactical extensions to Markdown. For one, you can dump any HTML you want, and it'll also be valid Markdown.

Images

Make sure to store all images you use in your images/ folder. Then, you embed them as follows:

![]({{ site.url }}/images/picture1.jpg)

Button Links

Minimal Mistakes allows you to create some snazzy button links.

<a markdown="0" href="{{ site.url }}/theme-setup" class="btn">Install Minimal Mistakes Theme</a>

You can create buttons that link to other sites as well.

<a markdown="0" href="http://purl.stanford.edu/tf565pz4260" class="btn">YS Archives</a>

Edit the Navigation Bar

There is a nice, neat navigation bar along the top for important links, and even external links. You can edit it from the file _data/navigation.yml. Here's an example:

# Site navigation links

- title: Blog
  url: /posts/

- title: Articles
  url: /articles/

- title: Staff
  url: /staff/

- title: Contact Us
  url: /contact/
  
- title: YS Archives
  url: http://purl.stanford.edu/tf565pz4260

aslian / yotsubasociety.github.io