25 Star 18 Fork 221

openGauss/blog

Create your Gitee Account
Explore and code with more than 12 million developers,Free private repositories !:)
Sign up
Clone or Download
contribute
Sync branch
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README
MIT

介绍

自 2023 年 07 月起,v2 分支 替代 master,作为 openGauss 官方博客仓库。

准备

  1. 参考 https://gitee.com/help/articles/4113 注册 Gitee 账号。

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

  3. 签署贡献者协议,https://www.opengauss.org/zh/contribution/

  4. 参考 https://gitee.com/help/articles/4106 准备你的 git 环境。

理解博客格式

openGauss 是用 markdown 格式写博客的。

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

---
title: 'Sample Post'
date: '2020-03-03'
category: 'blog'
tags: ['openGauss']
archives: '2020-03'
author: 'openGaussBlog 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.

小提示:你可以复制 https://gitee.com/opengauss/blog/blob/v2/app/zh/blogs/blog_example/20220901-sample-post.md 到你的工作路径下然后继续编辑。

关于格式

站点使用了 vitepress 框架提供了更好的 SEO,及更快的加载速度,但也有更严格的打包规则,以下规则非常重要我们建议你花几分钟阅读:

  • md 文件的文件名中禁止包含 + 号。
  • 图片命名禁止 空格、中文 、且大小写敏感,建议统一使用小写命名加中划线连接。如 blog-example.png。
  • <font> </font> <center> </center> 属于已弃用标签,vitepress 将不再支持,如有需要可以使用 <div style="align:center"></div>
  • md 中如需使用 HTML 标签,该标签需要闭合,如<div> </div>;。
  • 暂不支持 c++ 语言代码块,如果你有 c++代码需要展示,请不要指定代码块语言,而是采用默认语言。
  • 如果您的博客中包含代码、文件路径、键名、命令请使用代码块将其包裹。

提交博客

博客的提交利用了 Gitee 的 PR(Pull Request)。

  1. Fork openGauss 博客项目 https://gitee.com/opengauss/blog/tree/v2 到你自己的 Gitee 上。如果需要具体指导请参考 https://gitee.com/help/articles/4128

  2. Clone 代码

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

如果你发表中文博客,工作路径是 app/zh/blogs 。 假设你要写一个中文博客:

cd app/zh/blogs
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. 参考 https://gitee.com/help/articles/4128#article-header2 提交你的 PR

  2. 等待评审和合入。

The MIT License (MIT) Copyright (c) 2016 DevCows Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

openGauss official blog expand collapse
TypeScript and 6 more languages
MIT
Cancel

Releases

No release

Contributors

All

Activities

Load More
can not load any more
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/opengauss/blog.git
git@gitee.com:opengauss/blog.git
opengauss
blog
blog
v2

Search