+++
title = "Guidance to Post a Blog"

+++


## Preparation

1. Refer to <http://git.mydoc.io/?t=179267> to register Gitee account.

2. Set your primary mail box in gitee settings <https://gitee.com/profile/emails>.

3. Sign your CLA in <https://openeuler.org/zh/cla.html>.

4. Prepare your git environment refering to <http://git.mydoc.io/?t=180692>.

## Understand blog format

The openEuler blog is written in markdown format.
You can read <https://gitee.com/openeuler/blog/blob/master/design/content_posts.md> to get understand how the blog is designed.

The head includes the following information:
```
+++
title = "Sample Post"
date = "2020-03-03"
tags = ["Sample", "ABC", "cccc"]
archives = "2020-03"
author = "openEuler Blog Maintainer"
summary = "Just about everything you'll need to style in the theme: headings, paragraphs, blockquotes, tables, code blocks, and more."
+++

Here you can edit your blog. 
```

Tips: you can copy content/_example/2020-03-03-sample-post.md to your folder and edit it.

## Post your blog

The blog posting follows the pull request of [Gitee](gitee.com).

1. Fork openEuler blog project <https://gitee.com/openeuler/blog> to your own gitee. Refer to <http://git.mydoc.io/?t=153749> for detailed guidance.

2. Clone the code to your local environment.

```
git clone https://gitee.com/<your-gitee-id>/blog
```

3. Create a branch

```
git checkout -b <branch-name>
```

4. Create a folder in the blog floder
```
cd content\post
mkdir <your-gitee-id>
cd <your-gitee-id>
touch YEAR-MONTH-DAY-title.md
```

And You can put the resources in the same folder as your text file's, and name the resources as 
```
YEAR-MONTH-DAY-title-NN.MARKUP
```
Where the YEAR, MONTH, DAY, and title are the same as your blog file, and NN is the serial number of the pictures, like 01, 02 and so on. The MARKUP is the file extension, and for pictures it is recommended to use png.
The following are one example.
```
2020-01-01-new-years-is-coming.md
2020-01-01-new-years-is-coming-01.png
2020-01-01-new-years-is-coming-02.gif
2020-01-01-new-years-is-coming-03.pdf
```

5. Commit your post

```
git add <file-path>
git commit -m "<message>"
git push origin <branch-name>:<branch-name>
```

6. Refer to <http://git.mydoc.io/?t=153749> to submit your Pull Request

7. Wait for reviewing and merging.
