aeefd96f创建于 2021年11月18日历史提交
文件最后提交记录最后更新时间
4 年前
4 年前
README.md

准备

  1. 参考 http://git.mydoc.io/?t=179267 注册Gitee账号。

  2. 在Gitee个人设置中设置主邮箱地址,在此https://gitee.com/profile/emails。

  3. 签署贡献者协议,https://www.openeuler.org/zh/other/cla。

  4. 参考http://git.mydoc.io/?t=180692准备你的git环境

理解新闻格式

openEuler是用markdown格式写新闻的。 请阅读该文章 https://gitee.com/openeuler/website-v2/blob/master/web-ui/docs/zh/interaction/post-news/README.md来理解openEuler新闻是如何设计的。

文件头需要包含如下信息:

---
title: Sample Post
date: 2020-03-03
tags: 
    - theme
banner: img/banners/banner-2020hdc.png
author: openEuler
sig: sig-xxx
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 news. 

小提示:你可以复制 https://gitee.com/openeuler/website-v2/blob/master/web-ui/docs/zh/interaction/post-news/news_example/2020-03-03-sample-post.md 到你的工作路径下然后继续编辑。

提交新闻

新闻的提交利用了Gitee的PR(Pull Request)。

  1. Fork openEuler 新闻项目 https://gitee.com/openeuler/website-v2 到你自己的Gitee上。如果需要具体指导请参考 http://git.mydoc.io/?t=153749

  2. Clone代码

git clone https://gitee.com/<your-gitee-id>/website-v2
  1. 创建分支
git checkout -b <branch-name>
  1. 创建工作路径

如果你发表中文新闻,工作路径是 web-ui/docs/zh/news 。 假设你要写一个英文新闻:

cd web-ui/docs/en/news
mkdir <your-gitee-id>
cd <your-gitee-id>
touch YEAR-MONTH-DAY-title.md

你可以以你的md文档名来命名你的资源文件,方便使用。例如:

YEAR-MONTH-DAY-title-NN.MARKUP

其中,YEAR, MONTH, DAY, 和 title 和你的新闻md文件名一致。NN 是01、02、03这样的序号。MARKUP文件扩展名。如下例子:

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

使用HTML <img> 标签嵌入图片, 但你的图片资源需要放入当前目录下(即your-gitee-id目录下),输入图片名称作为 src 值:

<img src = "./2020-01-01-new-years-is-coming-01.png">
  1. Commit 你的新闻
git add <file-path>
git commit -m "<message>"
git push origin <branch-name>:<branch-name>
  1. 参考 http://git.mydoc.io/?t=153749 提交你的PR

  2. 等待评审和合入。