Creating a Blogpost

Creating a Blogpost for Developer.Concur.com

Create your new post file and save it in the blog/_posts directory.

The naming scheme of the file is:

YEAR-MONTH_DAY-Title.markdown

If I wrote a blog post entitled 'New Blogpost' on February 3rd, 2016 the title of my file would be:

2016-02-03-New-Blogpost.markdown

Write the required YAML front matter.

The very first thing in your file should be the YAML front matter. It should look something like this:

---
layout: post
title: Title
date: YEAR-MONTH-DAY
tags:
	- Tag
	- Tag-Two
references:
	- url: /link-one
	  link: Name of Link One
	- url: /link-two
	  link: Name of Linkn Two
---

Do include the --- wrapping your frontmatter.

Some other pointers regarding the above:

• layout:

Should always be 'post'.

• title:

The title of your post as you would like it to appear live.

• date:

Format example: 2016-02-03

• tags:

Please note that each - will be replaced with a space.

Also, this field is case sensative so please check the casing of previously used tags should you want your post to be appear in the same tag groups.

For example, a tag called 'Business-travel' will appear as 'Business travel' and 'Business-Travel' will appear as 'Business Travel'.

• references:

If you would like to include references in your post header, please include them here.

Format example:

references:	
  - url: /api-reference/expense/attendees/index.html
    link: Expense Attendees
  - url: /api-reference/callouts/request-validation.html
    link: Travel Request Validation

They will appear in the header, before the main content of your post like so:

This post references:
	- Expense Attendees
	- Travel Request Validation		

• author:

Your name (or the name of the group you would like the post to be published under) as you would like it to appear live.

Write the content of your blog post in markdown.

After closing the YAML header, write the content of your post in markdown.

Should you have any media to include in your post please place it in the /blog/images folder.

You can then reference it via the link {{ site.baseurl }}/blog/images/image.jpeg.

For example, if I had an image called 'logo.jpeg' I would place a copy of it in the /blog/images folder, then reference it in my markdown like so:

< img src="{{ site.baseurl }}/blog/images/logo.jpeg" >

References on markdown syntax can be found here and here.