From f70ad069e4620a4565ef2937dc56c874a5870c27 Mon Sep 17 00:00:00 2001 From: OreoYang <2167young@163.com> Date: Mon, 26 May 2025 15:07:21 +0800 Subject: [PATCH] update contribution guide and add README_zh --- CN/modules/ROOT/images/14.png | Bin 5754 -> 7791 bytes CN/modules/ROOT/nav.adoc | 2 +- CN/modules/ROOT/pages/v4.4/32.adoc | 83 +++++ CN/modules/ROOT/pages/v4.4/33.adoc | 88 ++++++ EN/modules/ROOT/images/14.png | Bin 5754 -> 7791 bytes README_zh.md | 107 +++++++ adoc_syntax_quick_reference.md | 471 +++++++++++++++++++++++++++++ 7 files changed, 750 insertions(+), 1 deletion(-) create mode 100644 CN/modules/ROOT/pages/v4.4/32.adoc create mode 100644 CN/modules/ROOT/pages/v4.4/33.adoc create mode 100644 README_zh.md create mode 100644 adoc_syntax_quick_reference.md diff --git a/CN/modules/ROOT/images/14.png b/CN/modules/ROOT/images/14.png index 0c832916f0d5a15c68b204ce4924aeaf961e3ced..478a60064681b0064c499165c034ef746e7566a5 100755 GIT binary patch literal 7791 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。 + +请参考注册您的github账号,并熟悉Git工具和工作流。 + +== 签署CLA + +在提交代码或文档贡献之前,个人或企业贡献者需要签署贡献者许可协议(CLA)。签署CLA是IvorySQL社区接受贡献的必要条件,以确保您的贡献被合法分发。请根据下列链接下载CLA进行签署并将签署后的CLA发送至 cla@ivorysql.org。 + +* https://www.ivorysql.org/zh-CN/assets/files/individual_cla-a81f001209eb5ce0f8ea7c3be4cc69b5.pdf[个人贡献者] +* https://www.ivorysql.org/zh-CN/assets/files/corporate_cla-76e89b6f17b0bc102cbc1105d438a917.pdf[企业贡献者] + +未签署CLA的Pull Request将无法进入评审阶段。 + +== 找到您感兴趣的项目 + +您可以从如下列表中找到感兴趣的项目及其代码仓库 + +[cols="1,1"] +|=== +|代码仓库 | 描述 +|https://github.com/IvorySQL/IvorySQL[IvorySQL] | 负责社区IvorySQL数据库的开发和维护 +|https://github.com/IvorySQL/Ivory-www[Ivory-www] | 负责社区的官网开发和维护 +|https://github.com/IvorySQL/ivory-operator[ivory-operator] | 负责IvorySQL云原生数据库及周边工具开发和维护 +|https://github.com/IvorySQL/docker_library[docker_library] | 负责IvorySQL多架构的镜像构建开发和维护 +|https://github.com/IvorySQL/ivory-cloud[ivory-cloud] | 负责IvorySQL云服务平台及周边生态开发和维护 +|https://github.com/IvorySQL/ivorysql_docs[Ivorysql_docs] | 负责社区的文档中心开发和维护 +|https://github.com/IvorySQL/ivory-doc-builder[ivory-doc-builder] | 负责Ivorysql_docs的编译 +|https://github.com/IvorySQL/ivorysql_web[Ivorysql_web] | 负责社区的文档中心网站维护 +|https://github.com/IvorySQL/ivorysql-wasm[Ivorysql_wasm] | 负责IvorySQL在线易用体验网站的开发和维护 +|=== + +== 开始您的贡献 + +=== 提交Issue +如果您准备向社区上报 Bug 或者提交需求,请在 IvorySQL 社区对应的仓库上提交 Issue,并参考Issue xref:./33.adoc[提交指南]。 + +=== 给自己分配Issue +您可以将自己创建的Issue或者愿意处理的Issue分配给自己。 只需要在评论框内输入/assign,机器人就会将问题分配给您。 每个 Issue 下面可能已经有参与者的交流和讨论,如果您感兴趣,也可以在评论框中发表自己的意见参与 Issue 讨论。 + +=== 提交Pull Request +对于提交一个PR应该保持一个功能,或者一个bug提交一次。禁止多个功能一次提交。 + + +==== 第1步:创建一个Pull Request + +1、打开你 Fork 的仓库: https://github.com/$user/$repo_addr (将 $user 替换为你的 GitHub ID)。 + +​2、点击 Compare & pull request 按钮 + +==== 第2步:填写PR信息 + +``` +Fix test +功能描述 +``` + +``` +leave a comment +对该提交功能进行比较详细的描述 +``` + +==== 第3步:提交PR + +点击Create pull request 按钮即可提交。 + + +== 致谢 +我们欢迎所有人参与 IvorySQL 社区贡献,我们的目标是发展一个由贡献者组成的活跃、健康的社区。 diff --git a/CN/modules/ROOT/pages/v4.4/33.adoc b/CN/modules/ROOT/pages/v4.4/33.adoc new file mode 100644 index 0000000..97fb7e0 --- /dev/null +++ b/CN/modules/ROOT/pages/v4.4/33.adoc @@ -0,0 +1,88 @@ + +:sectnums: +:sectnumlevels: 5 + +:imagesdir: ./_images += **问题提交指南** +发现并提交问题,也是对社区良好的贡献方式。 + +本文详细描述如何提交一个问题。 + +以IvorySQL为例,提交一个bug report + +== 确认问题所属仓库 +IvorySQL仓库: https://github.com/IvorySQL/IvorySQL + +== **创建新的Issue** + +=== 第1步 进入New issue 页面: + +点击New issue + +image::p3.png[] + + +=== 第2步:选择需要填写的issue类型 + +**1、bug report** + +``` +Title: 标题 +``` + +``` +## Bug Report +对bug进行描述 + + +### IvorySQL Version +在IvorySQL哪个版本发现的问题 + +### OS Version (uname -a) +系统版本 + +### Configuration options ( config.status --config ) +配置参数 + +### Current Behavior +当前的结果 + +### Expected behavior/code +期望的结果 + +### Step to reproduce +复现步骤 + +### Additional context that can be helpful for identifying the problem +有助于识别问题的其它信息 +``` + + +**2、Enhancement** + +``` +Title: 标题 +``` + +``` +## Enhancement +对于期望强化的功能作一个描述 +``` + +**3、Feature Request** + +``` +Title: 标题 +``` + +``` +## Feature Request +描述你期望实现的一个功能 +``` + + +=== 第3步:提交 + +点击 submit new issue 按钮, 提交即可。 + +提交问题以后,如果问题的描述和复现步骤清晰明确和可定位,会有人直接定位和解决该问题。但也有可能会出现,负责跟进该问题的开发者需要您提供更加详细的信息的情况,也感谢您的配合。 diff --git a/EN/modules/ROOT/images/14.png b/EN/modules/ROOT/images/14.png index 0c832916f0d5a15c68b204ce4924aeaf961e3ced..478a60064681b0064c499165c034ef746e7566a5 100755 GIT binary patch literal 7791 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 后禁止出现多个空格,只能使用一个空格,后接引用内容。 + +​ 14、使用有序列表时,必须从 1 开始,按顺序递增。 + +​ 15、使用列表时,每一列表项的标识符(+、-、* 或数字)后只能空一格,后接列表内容。 + +​ 16、列表(包括有序和无序列表)前后必须各空一行。 + +​ 17、代码块前后必须各空一行。 + +​ 18、文档中禁止出现裸露的 URL。如果希望用户能直接点击并打开该 URL,则使用一对尖括号 () 包裹该 URL。如果由于特殊情况必须使用裸露的 URL,不需要用户通过点击打开,则使用一对反引号 (`URL`) 包裹该 URL。 + +​ 19、使用加粗、斜体等强调效果时,在强调标识符内禁止出现多余的空格。如不能出现 `** 加粗文本 **`。 + +​ 20、单个反引号包裹的代码块内禁止出现多余的空格。如不能出现 ` 示例文本 `。 + +​ 21、链接文本两边禁止出现多余的空格。如不能出现 [某链接](https://www.example.com/)。 + +​ 22、链接必须有链接路径。如不能出现[空链接]()或[空链接](#)等情况。 + +## 示例 + +1、标题从一级开始递增使用,禁止跳级使用。 + +``` += Heading 1 +=== Heading 3 + +We skipped out a 2nd level heading in this document +``` + + + +2、标题必须统一使用 ATX 风格,即在标题前加 = 号来表示标题级别。 + +``` += Heading 1 +== Heading 2 +=== Heading 3 +==== Heading 4 +== Another Heading 2 +=== Another Heading 3 +``` + + + +3、标题的引导符号 = 后必须空一格再接标题内容。禁止=后多个空格,禁止=前出现空格 + +错误示范: + +``` += Heading 1 +== Heading 2 +``` + +正确示范: + +``` += Heading 1 +== Heading 2 +``` + + + +4、标题末尾仅能出现中英文问号、反引号、中英文单双引号等符号。 + +错误示范 + +``` += This is a heading. +``` + +正确示范 + +``` += This is a heading +``` + + + +5、标题上面空一行 + +错误示范 + +``` += Heading 1 +Some text +Some more text## Heading 2 +``` + +正确示范 + +``` += Heading 1 +Some text +Some more text + +== Heading 2 +``` + + + +6、文档中不能连续出现内容重复的标题,如一级标题为 = IvorySQL 描述,紧接着的二级标题就不能是 == IvorySQL 描述。如果不是连续的标题,则标题内容可重复。 + +错误示范 + +``` += Some text + +== Some text +``` + +正确示范 + +``` += Some text + +== Some more text +``` + + + +7、文档中只能出现一个一级标题。 + +错误示范 + +``` += Top level heading + += Another top-level heading +``` + +正确释放 + +``` += Title + +== Heading + +== Another heading +``` + + + +8、一般来说,除 TOC.adoc 文件可缩进 2 个空格外,其余所有 .adoc 文件每缩进一级,默认须缩进 4 个空格。 + +错误示范 + +``` +* List item + * Nested list item indented by 3 spaces +``` + +正确示范: + +``` +* List item + * Nested list item indented by 4 spaces +``` + + + +9、文档中(包括代码块内)禁止出现 Tab 制表符,如需缩进,必须统一用空格代替 + +错误示范: + +``` +Some text + * hard tab character used to indent the list item +``` + +正确示范: + +``` +Some text + * Spaces used to indent the list item instead +``` + + + +10、禁止出现连续的空行 + +错误示范 + +``` +Some text here + + +Some more text here +``` + +正确释放: + +``` +Some text here + +Some more text here +``` + + + +11、块引用符号 > 后禁止出现多个空格,只能使用一个空格,后接引用内容。 + +错误示范 + +``` +> This is a blockquote with bad indentation> there should only be one. +``` + +正确示范 + +``` +> This is a blockquote with correct> indentation. +``` + + + +12、使用有序列表时,必须从 1 开始,按顺序递增。 + +错误示范: + +``` +1. Do this. +1. Do that. +1. Done. +``` + +``` +0. Do this. +1. Do that. +2. Done. +``` + + 正确示范: + +``` +1. Do this. +2. Do that. +3. Done. +``` + + + +13、使用列表时,每一列表项的标识符(+、-、* 或数字)后只能空一格,后接列表内容。 + +正确示范 + +``` +* Foo +* Bar +* Baz + +1. Foo + * Bar +1. Baz +``` + + + +14、列表(包括有序和无序列表)前后必须各空一行。 + +错误示范 + +``` +Some text* Some* List + +1. Some2. List + +Some text +``` + +正确示范 + +``` +Some text + +* Some +* List + +1. Some +2. List + +Some text +``` + + + +15、代码块前后必须各空一行。 + +错误示范 + +``` +Some text +​``` +Code block +​``` +​``` +Another code block +​``` +Some more text +``` + +正确示范 + +``` +Some text + +​``` +Code block +​``` + +​``` +Another code block +​``` + +Some more text +``` + + + +16、文档中禁止出现裸露的 URL。如果希望用户能直接点击并打开该 URL,则使用一对尖括号 () 包裹该 URL。如果由于特殊情况必须使用裸露的 URL,不需要用户通过点击打开,则使用一对反引号 (`URL`) 包裹该 URL。 + +错误示范 + +``` +For more information, see https://www.example.com/. +``` + +正确示范 + +``` +For more information, see . +``` + + + +17、使用加粗、斜体等强调效果时,在强调标识符内禁止出现多余的空格。如不能出现 `** 加粗文本 **`。 + +错误示范 + +``` +Here is some ** bold ** text. + +Here is some * italic * text. + +Here is some more __ bold __ text. + +Here is some more _ italic _ text. +``` + +正确示范: + +``` +Here is some **bold** text. + +Here is some *italic* text. + +Here is some more __bold__ text. + +Here is some more _italic_ text. +``` + + + +18、单个反引号包裹的代码块内禁止出现多余的空格。如不能出现 ` 示例文本 `。 + +错误示范: + +``` +some text + some text +``` + +正确示范: + +``` +some text +``` + + + +19、链接文本两边禁止出现多余的空格。如不能出现 [ 某链接 ](https://www.example.com/)。 + +错误示范 + +``` +[ a link ](https://www.example.com/) +``` + +正确示范: + +``` +[a link](https://www.example.com/) +``` + + + +20、链接必须有链接路径。如不能出现[空链接]()或[空链接](#)等情况。 + +错误示范 + +``` +[an empty link]() + +[an empty fragment](#) +``` + +正确示范: + +``` +[a valid link](https://example.com/) + +[a valid fragment](#fragment) +``` + + + +21、文档中的代码块统一使用三个反引号进行包裹,禁止使用缩进四格风格的代码块。 + +错误示范: + +``` +Some text. + + # Indented code + +More text. +``` + +正确示范 + +``` +```ruby +# Fenced code +​``` +More text. +```