Introduction

This repository is the source code for www.odata.org built with Jekyll. Site admins regularly updates the contents to the site.

Contribution Guide

Create blogs

OData lovers can write blogs to share their experiences with OData. Blogs will be published at www.odata.org/blog. To create a blog post :

• Create a markdown file under _posts folder.
• Name the file yyyy-mm-dd-your-blog-title.md
• Inside the markdown file, follow the templates: (If you are not familiar with markdown syntax, please refer to the Appendix A section below.

---
layout: post
title: your blog title
date: 2010-03-17 17:59:43.000000000 +08:00
author: Name you want to display
---
[Optional]Description of yourself

Contents of your blog post in Markdown syntax

• If you want to add images in your post, please add the image under assets folder first and the src url should be /assets/img.png

• If you want to add code in your post, please refer to the Appendix B section below.

• Then create a pull request for your update, we will publish your blog post after a quick review.

Other improvements

Other improvements including general site improvement ideas, modifying existing pages, adding new pages and etc, please create a GitHub issue or create a pull request.

Appendix A: Markdown Syntax

We highly recommend using Markdown to create a blog post.

Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

Markdown Basics

Markdown is very easy to use, with syntax below, you can write a pretty blog post.

Headings

You can create a heading by adding one or more # symbols before your heading text.

# h1
## h2
…
###### h6

Blockquotes

You can indicate blockquotes with a >.

In the words of Abraham Lincoln:
> Pardon my french

Styling text

*This text will be italic*
**This text will be bold**

Lists

You can make an unordered list by preceding list items with either * or -

* Item
* Item

- Item
- Item

You can make an ordered list by preceding list items with a number.

1. Item 1
2. Item 2

Code formatting

Use single backtick (`) to format text in a special monospace format.

You can use triple backticks to format text as its own distinct block.

Links

You can create an inline link by wrapping link text in brackets ( [ ] ), and then wrapping the link in parentheses ( ( ) ).

[Visit GitHub!](www.github.com)

More if you need

If you need more advanced guidelines, please refer to:

• Mastering Markdown
• Daring Fireball: Markdown Syntax Documentation

Appendix B: Code Formatting

There are two ways to formatting your code in a blog post.

Markdown coding formatting You can use coding format supported in Markdown, use triple backticks to format text as its own distinct block. This is very easy to use, but not support syntax highlighting

Jekyll supported code formatting Since our site is built with Jekyll, you can also use Jekyll supported code formatting, which supports syntax highlight. To render a code block with syntax highlighting, surround your code as follows:

{% highlight ruby %}
def foo
  puts 'foo'
end
{% endhighlight %}

The argument to the highlight tag (ruby in the example above) is the language identifier. ruby here is a short name, for regually used short names:

• csharp for C#
• javascript for JavaScript
• ruby for Ruby
• cpp for C++
• c for C
• java for Java
• json for JSON
• php for PHP
• python for Python

If the language you used not listed above, please look for the “short name” on the Pygments’ Lexers page.