You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@seatunnel.apache.org by ki...@apache.org on 2021/12/28 02:41:31 UTC

[incubator-seatunnel-website] branch main updated: README_ZH add (#18)

This is an automated email from the ASF dual-hosted git repository.

kirs pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-seatunnel-website.git


The following commit(s) were added to refs/heads/main by this push:
     new 6664321  README_ZH add (#18)
6664321 is described below

commit 66643212922e3fe6d9c72258bf1fc95e22ea646c
Author: benjobs <be...@qq.com>
AuthorDate: Tue Dec 28 10:41:28 2021 +0800

    README_ZH add (#18)
    
    * README_ZH add
---
 README.md    |   6 +--
 README_ZH.md | 130 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 133 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index e038551..4e97dcf 100644
--- a/README.md
+++ b/README.md
@@ -8,10 +8,10 @@ This guide will guide you how to contribute to the SeaTunnel website.
 
 
 ## Branch
-dev is the development branch. For all modifications, please fork first, and then proceed on the dev branch.
+main is the default branch. For all modifications, please fork first, and then proceed on the main branch.
+
 ```
-master 
-dev #development branch
+main #default branch
 asf-site   #The official environment of asf-site official website is accessed through https://seatunnel.apache.org
 asf-staging #The asf-staging official website test environment is accessed through https://seatunnel.staged.apache.org
 ```
diff --git a/README_ZH.md b/README_ZH.md
new file mode 100644
index 0000000..cfa384d
--- /dev/null
+++ b/README_ZH.md
@@ -0,0 +1,130 @@
+# Apache SeaTunnel Website
+[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
+
+[English](README.md) | [中文](README_ZH.md)
+
+这是包含 `https://seatunnel.apache.org` 的所有源代码的存储库。
+本指南将指导您如何为SeaTunnel的网站做出贡献。
+
+
+## 分支 
+main为默认主分支,修改请先fork到自己的仓库,然后在main分支上进行开发修改。
+```
+main  默认分支
+asf-site    官网正式环境  通过https://seatunnel.apache.org 访问
+asf-staging 官网测试环境  通过https://seatunnel.staged.apache.org 访问
+```
+
+
+## 1.预览并生成静态文件
+
+本网站是使用node编译的,使用的是Docusaurus框架组件
+
+1. 下载并安装 nodejs(version>12.5.0)
+2. 克隆代码到本地 `git clone  git@github.com:apache/incubator-seatunnel-website.git`
+2. 运行 `npm install` 来安装所需的依赖库。
+3. 在根目录运行`npm run start`,可以访问http://localhost:3000查看站点英文模式预览
+4. 在根目录运行`npm run start-zh`,可以访问http://localhost:3000查看站点的中文模式预览
+5. 要生成静态网站资源文件,运行 `npm run build`。构建的静态资源在build目录中。
+
+## 2.目录结构
+```html
+
+|-- community //社区
+|-- docs     //文档  存方下一个即将发布的版本
+|-- download //下载
+|-- faq      //Q&A
+|-- i18n    
+|   -- zh-CN  //国际化中文
+|       |-- code.json
+|       |-- docusaurus-plugin-content-docs
+|       |-- docusaurus-plugin-content-docs-community
+|       |-- docusaurus-plugin-content-docs-download
+|       |-- docusaurus-plugin-content-docs-faq
+|       `-- docusaurus-theme-classic
+|-- resource // 架构/时序/流程图等的原始工程文件
+|-- src
+|   |-- components
+|   |-- css
+|   |-- js
+|   |-- pages
+|   |   |-- home
+|   |   |-- index.jsx
+|   |   |-- team
+|   |   |-- user
+|   |-- styles
+|-- static //图片静态资源
+|   |-- doc  //文档的图片
+|   |-- user //用户的图片
+|   |-- home //首页的图片
+|   |-- img  //公用图片
+|-- docusaurus.config.js
+
+```
+
+## 3.规范
+
+### 3.1 目录命名规范
+
+全部采用小写方式, 以中下划线分隔,有复数结构时,要采用复数命名法, 缩写不用复数
+
+正例: `scripts / styles / components / images / utils / layouts / demo_styles / demo-scripts / img / doc`
+
+反例: `script / style / demoStyles / imgs / docs`
+
+### 3.2 vue以及静态资源文件命名规范
+
+全部采用小写方式, 以中划线分隔
+
+正例: `render-dom.js / signup.css / index.html / company-logo.png`
+
+反例: `renderDom.js / UserManagement.html`
+
+### 3.3 资源路径 
+
+图片资源统一放在`static/{模块名}`下
+
+css等样式文件放在`src/css`目录下
+
+### 3.4 页面内容修改 
+> 除了首页、团队、用户、Docs>All Version 模块页面外,其余页面都能通过底部的'Edit this page'按钮 直接跳转至对应的github的资源修改页
+
+### 3.5 首页页面修改
+访问页面  https://seatunnel.apache.org/
+位于 `src/pages/home`
+
+```
+├─home
+│      languages.json 首页中英文的配置  
+│      index.less  首页样式
+```
+### 3.6 团队页面修改
+访问页面  https://seatunnel.apache.org/zh-CN/team
+位于 `src/pages/team`
+```
+├─team
+│ languages.json
+│ index.js
+│ index.less
+```
+### 3.7  用户 列表页面修改
+访问页面  https://seatunnel.apache.org/zh-CN/user/
+```
+位于 `src/pages/user`
+└─versions
+        data.json
+        images.json
+        index.js
+        index.less
+        languages.json
+```
+
+### 3.8 version 列表页面修改
+访问页面  https://seatunnel.apache.org/zh-CN/versions/
+```
+位于 `src/pages/versions`
+└─versions
+        languages.json
+        index.jsorchestrator/overview.md
+        index.less
+```