|
3 | 3 |
|
4 | 4 | [English](README.md) | [中文](README_ZH.md)
|
5 | 5 |
|
6 |
| -This is the repository containing all the source code of `https://linkis.apache.org`. |
7 |
| -The project is specially for Linkis, based on the newest `vite` & `vue3` |
8 |
| -## Preview and generate static files |
| 6 | +这是包含 `https://linkis.apache.org` 的所有源代码的存储库。 |
9 | 7 |
|
10 |
| -This website is compiled using node. |
| 8 | +## 预览并生成静态文件 |
11 | 9 |
|
12 |
| -1. download and install nodejs (version>12.5.0) |
13 |
| -2. clone the code to local |
14 |
| -2. run `npm install` to install the required libraries. |
15 |
| -3. run `npm run` in the root directory, you can visit http://localhost:3000 to view the site preview |
16 |
| -4. to generate static website resource files, run `npm run build`. The static resources built are in the dist directory. |
| 10 | +本网站是使用node编译的。 |
17 | 11 |
|
18 |
| -## Contribution Guidelines |
19 |
| - |
20 |
| -This guide will guide you how to contribute to the Linkis website. |
21 |
| - |
22 |
| -### Specification |
23 |
| - |
24 |
| -#### 1. Directory naming convention |
25 |
| - |
26 |
| -Use all lowercase, separated by a dash. If there is a plural structure, use plural nomenclature and do not use plural abbreviations. |
27 |
| - |
28 |
| -Positive example: `scripts / styles / components / images / utils / layouts / demo-styles / demo-scripts / img / doc` |
29 |
| - |
30 |
| -Counter example: `script / style / demo_scripts / demoStyles / imgs / docs` |
31 |
| - |
32 |
| -[Special] The component directory in components in the VUE project is named with kebab-case |
33 |
| - |
34 |
| -Positive example: `head-search / page-loading / authorized / notice-icon` |
35 |
| - |
36 |
| -Counter-example: `HeadSearch / PageLoading` |
37 |
| - |
38 |
| -[Special] All directories in the VUE project except the components directory are also named with kebab-case |
39 |
| -Positive example: `page-one / shopping-car / user-management` |
40 |
| - |
41 |
| -Counter-example: `ShoppingCar / UserManagement` |
42 |
| - |
43 |
| -#### 2.vue and static resource file naming convention |
44 |
| - |
45 |
| -All lowercase, separated by a dash |
46 |
| - |
47 |
| -Positive example: `render-dom.js / signup.css / index.html / company-logo.png` |
48 |
| - |
49 |
| -Counter example: `renderDom.js / UserManagement.html` |
50 |
| - |
51 |
| -#### 3. Resource path |
52 |
| - |
53 |
| -Image resources are unified under `src/assets/{module name}` |
54 |
| - |
55 |
| -css and other style files are placed in the `src/style` directory |
56 |
| - |
57 |
| - |
58 |
| - |
59 |
| -### Home page modification |
60 |
| - |
61 |
| -Located in `src/pages/home/index.vue` |
62 |
| - |
63 |
| - |
64 |
| - |
65 |
| -### Document modification |
66 |
| - |
67 |
| -Located in src/pages/docs |
68 |
| - |
69 |
| -```json |
70 |
| -filename.vue //vue page |
71 |
| -filename_zh.md //Chinese document corresponding |
72 |
| -filename_en.md //English document corresponding |
73 |
| - |
74 |
| -``` |
75 |
| - |
76 |
| - |
77 |
| -### FAQ modification |
78 |
| - |
79 |
| -Located in `src/pages/home/index.vue` |
80 |
| - |
81 |
| -Chinese revision: src/pages/faq/faq_en.md |
82 |
| -English revision: src/pages/faq/faq_zh.md |
83 |
| - |
84 |
| -### Download page modification |
85 |
| - |
86 |
| -Chinese list data file: src/pages/download/downloaddata_en.js |
87 |
| -English list data file: src/pages/download/downloaddata_zh.js |
88 |
| -Example of list data entry |
89 |
| - |
90 |
| -```json |
91 |
| -{ |
92 |
| - "version":"1.0.2", //version |
93 |
| - "releaseDate":"2021-09-02",//release date |
94 |
| - "releaseDesc":"This release mainly introduces Flink-support into Linkis ecosystem.",//Description |
95 |
| - "newFeatures":"6",//The number of new features added to this version |
96 |
| - "enhancement":"5",//Enhanced optimization function than version |
97 |
| - "bugFixs":"5",//The number of bugs fixed in this version |
98 |
| - "changeLogUrl":"https://github.com/apache/incubator-linkis/releases/tag/1.0.2",//Detailed change log link to release log on github |
99 |
| - "downloadUrl":"https://github.com/apache/incubator-linkis/archive/refs/tags/1.0.2.zip"//version download address |
100 |
| -} |
101 |
| -``` |
102 |
| - |
103 |
| - |
104 |
| - |
105 |
| -## other |
106 |
| - |
107 |
| -The naming convention refers to "Alibaba Front-end Development Specification" |
| 12 | +1. 下载并安装 nodejs(version>12.5.0) |
| 13 | +2. 克隆代码到本地 |
| 14 | +2. 运行 `npm install` 来安装所需的库。 |
| 15 | +3. 在根目录运行`npm run start`,英文模式 可以访问http://localhost:3000查看站点预览 |
| 16 | +3. 在根目录运行`npm run start-zh`,中文模式 可以访问http://localhost:3000查看站点预览 |
| 17 | +4. 要生成静态网站资源文件,运行 `npm run build`。构建得静态资源在build目录中。 |
0 commit comments