~xdavidwu/xdavidwu.link

c7f29a1d56fca977e0c1aec78f7035a43c9ccee5 — Michael Rose 10 years ago e2e01bd
Rename Articles to Posts to stay consistent with Jekyll naming conventions
6 files changed, 31 insertions(+), 18 deletions(-)

M README.md
M _config.yml
M _layouts/post.html
M about.md
R articles.md => posts.md
M theme-setup.md
M README.md => README.md +2 -2
@@ 34,7 34,7 @@ General notes and suggestions for customizing Minimal Mistakes.
## Setup for an Existing Jekyll site

1. Clone the following folders: `_includes`, `_layouts`, `assets`, and `images`.
2. Clone the following files and personalize content as need: `about.md`, `articles.html`, `index.md`, `feed.xml`, `sitemap.xml`
2. Clone the following files and personalize content as need: `about.md`, `posts.md`, `index.md`, `feed.xml`, `sitemap.xml`
3. Set the following variables in your `config.yml` file:

``` yaml


@@ 71,7 71,7 @@ bing_verify:
# For external links add external: true
links:
  - title: Theme Setup
    url: /theme-setup
    url: /theme-setup/
  - title: External Link
    url: http://mademistakes.com
    external: true

M _config.yml => _config.yml +2 -2
@@ 32,8 32,8 @@ bing_verify:
links:
  - title: About
    url: /about/
  - title: Articles
    url: /articles/
  - title: Posts
    url: /posts/
  - title: Theme Setup
    url: /theme-setup/
  - title: Made Mistakes

M _layouts/post.html => _layouts/post.html +1 -1
@@ 42,7 42,7 @@

<div class="footer-wrap">
  {% if site.related_posts.size > 0 %}<div class="related-articles">
  <h4>You might also enjoy <small class="pull-right">(<a href="{{ site.url }}/articles">View all articles</a>)</small></h4>
  <h4>You might also enjoy <small class="pull-right">(<a href="{{ site.url }}/posts/">View all posts</a>)</small></h4>
    <ul>
    {% for post in site.related_posts limit:3 %}
      {% assign match = false %}

M about.md => about.md +1 -1
@@ 1,6 1,6 @@
---
layout: page
permalink: /about/index.html
permalink: /about/
title: About the Theme
tagline: Minimal Mistakes, a Jekyll Theme
tags: [about, Jekyll, theme, responsive]

R articles.md => posts.md +3 -3
@@ 1,7 1,7 @@
---
layout: post-index
permalink: /articles/
title: Articles
permalink: /posts/
title: All Posts
tagline: A List of Posts
tags: [blog, graphic design]
tags: [blog]
---
\ No newline at end of file

M theme-setup.md => theme-setup.md +22 -9
@@ 1,6 1,6 @@
---
layout: page
permalink: /theme-setup/index.html
permalink: /theme-setup/
title: Theme Setup
description: "Instructions on how to install and customize the Jekyll theme Minimal Mistakes."
tags: [Jekyll, theme, responsive]


@@ 42,7 42,7 @@ minimal-mistakes/
├── _layouts/
|    ├── home.html  #homepage layout
|    ├── page.html  #page layout
|    ├── post-index.html  #post listing layout
|    ├── post-index.html  #post index layout
|    └── post.html  #post layout
├── _posts/
├── assets/


@@ 55,7 55,7 @@ minimal-mistakes/
|    └── less/
├── images/  # images for posts and pages
├── about.md  # about page
├── articles.md  # lists all posts from latest to oldest
├── posts.md  # lists all posts from latest to oldest
└── index.md  # homepage. lists 5 most recent posts
{% endhighlight %}



@@ 69,7 69,7 @@ Most of the variables found here are used in the .html files found in `_includes

#### Owner/Author Information

Change your name, bio, and avatar photo (100x100 pixels or larger), Twitter url, email, and Google+ url. If you want to link to an external image on Gravatar or something similiar you'll need to edit the path in `_author-bio.html` since it assumes it is located in `\images`.
Change your name, bio, and avatar photo (100x100 pixels or larger), Twitter url, email, and Google+ url. If you want to link to an external image on Gravatar or something similiar you'll need to edit the path in `_author-bio.html` since it assumes it is located in `/images`.

Including a link to your Google+ profile has the added benefit of displaying [Google Authorship](https://plus.google.com/authorship) in Google search results if you've went ahead and applied for it. Don't have a Google+ account? Just leave it blank.



@@ 85,11 85,11 @@ Edit page/post titles and URLs to include in the site's navigation. For external
# sample top navigation links
links:
  - title: About Page
    url: /about
  - title: Articles
    url: /articles
    url: /about/
  - title: Posts
    url: /posts/
  - title: Other Page
    url: /other-page
    url: /other-page/
  - title: External Page
    url: http://mademistakes.com
    external: true


@@ 97,7 97,7 @@ links:

### Adding Posts and Pages

There are two main content layouts: *post.html* (for posts) and *page.html* (for pages). Both have large **feature images** that span the full-width of the screen, and both are meant for text heavy blog posts (or articles). 
There are two main content layouts: *post.html* (for posts) and *page.html* (for pages). Both have large **feature images** that span the full-width of the screen, and both are meant for long form articles and blog posts. 

#### Feature Images



@@ 120,6 120,19 @@ image:
  creditlink: http://mademistakes.com #url to their site or licensing
{% endhighlight %}

#### Post Index Page

A [sample index page]({{ site.url }}/posts/) listing all posts grouped by the year they were published has been provided. The name can be customized to your liking by editing a few references. For example, to change **Posts** to **Writing** update the following:

* In `_config.yml` under `links:` rename the title and URL to the following:
{% highlight yaml %}
  links:
  - title: Writing
    url: /writing/
{% endhighlight %}
* Rename `posts.md` to `writing.md` and update the YAML front matter to match the title and URL set in `_config.yml`
* Update the **View all posts** link in `post.html` layout found in `_layouts` to match title and URL set previously.

#### Thumbnails for OG and Twitter Cards

Post and page thumbnails work the same way. These are used by [Open Graph](https://developers.facebook.com/docs/opengraph/) and [Twitter Cards](https://dev.twitter.com/docs/cards) meta tags found in *_head.html*. If you don't assign a thumbnail the default graphic *(default-thumb.png)* is used. I'd suggest changing this to something more meaningful --- your logo or avatar are good options.