From a02dca5ba6238e508bf6ea10b373abe8d6fe2b84 Mon Sep 17 00:00:00 2001 From: Tim-Paik Date: Sun, 15 May 2022 13:49:01 +0800 Subject: [PATCH 1/2] docs: improve the Chinese translation --- scripts/markdown/readme/languages/chinese.md | 258 ++++++++++++------- 1 file changed, 172 insertions(+), 86 deletions(-) diff --git a/scripts/markdown/readme/languages/chinese.md b/scripts/markdown/readme/languages/chinese.md index cd672cff6e..aabe72d8b3 100644 --- a/scripts/markdown/readme/languages/chinese.md +++ b/scripts/markdown/readme/languages/chinese.md @@ -16,71 +16,128 @@

- Website • + 官网 • Discord • Twitter • Reddit • - Documentation -

+ 文档 +

![OpenSourceAirtableAlternative](https://user-images.githubusercontent.com/5435402/133762127-e94da292-a1c3-4458-b09a-02cd5b57be53.png)

- NocoDB - The Open Source Airtable alternative | Product Hunt + NocoDB - 开源的 Airtable 替代品 | Product Hunt

# 快速尝试 -### 一键式部署 + +### 一键部署 + +在部署之前，请确保你有一个 Heroku 账户。默认情况下，将使用一个附加的 Heroku Postgres 作为数据库。你可以通过访问 Heroku 应用程序设置并选择 Config Vars 来查看 DATABASE_URL 中定义的连接方式。 #### Heroku + Deploy NocoDB to Heroku with 1-Click
-### 使用Docker -```bash -docker run -d --name nocodb -p 8080:8080 nocodb/nocodb:latest -``` - -- NocoDB needs a database as input : See [Production Setup](https://github.com/nocodb/nocodb/blob/master/README.md#production-setup). -- 要使用数据持久化，你可以挂载到 `/usr/app/data/`。 +## NPX - 示例: +如果你需要一个交互式的配置，你可以运行下面的命令。 - ``` - docker run -d -p 8080:8080 --name nocodb -v "$(pwd)"/nocodb:/usr/app/data/ nocodb/nocodb:latest - ``` - -### 使用NPM ``` npx create-nocodb-app ``` -### 使用git -``` + + + +## Node 应用程序 + +我们提供了一个简单的 NodeJS 应用程序以供入门。 + +```bash git clone https://github.com/nocodb/nocodb-seed cd nocodb-seed npm install npm start ``` -### GUI +## Docker 部署 + +```bash +# 如果使用 SQLite 的话 +docker run -d --name nocodb \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +nocodb/nocodb:latest + +# 如果使用 MySQL 的话 +docker run -d --name nocodb-mysql \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +-e NC_DB="mysql2://host.docker.internal:3306?u=root&p=password&d=d1" \ +-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ +nocodb/nocodb:latest + +# 如果使用 PostgreSQL 的话 +docker run -d --name nocodb-postgres \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +-e NC_DB="pg://host.docker.internal:5432?u=root&p=password&d=d1" \ +-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ +nocodb/nocodb:latest + +# 如果使用 MSSQL 的话 +docker run -d --name nocodb-mssql \ +-v "$(pwd)"/nocodb:/usr/app/data/ \ +-p 8080:8080 \ +-e NC_DB="mssql://host.docker.internal:1433?u=root&p=password&d=d1" \ +-e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ +nocodb/nocodb:latest +``` + +> 你可以通过在 0.10.6 以上的版本中挂载 `/usr/app/data/` 来持久化数据，否则你的数据会在重新创建容器后完全丢失。 -使用仪表板使用 : [http://localhost:8080/dashboard](http://localhost:8080/dashboard) +> 如果你打算输入一些特殊字符，你可能需要在创建数据库时改变字符集和排序。请查看[MySQL Docker](https://github.com/nocodb/nocodb/issues/1340#issuecomment-1049481043)的例子。 +## Docker Compose + +我们在[这个目录](https://github.com/nocodb/nocodb/tree/master/docker-compose)下提供了不同的 docker-compose.yml 文件。下面是一些例子： + +```bash +git clone https://github.com/nocodb/nocodb +# 如果使用 MySQL 的话 +cd nocodb/docker-compose/mysql +# 如果使用 PostgreSQL 的话 +cd nocodb/docker-compose/pg +# 如果使用 MSSQL 的话 +cd nocodb/docker-compose/mssql +docker-compose up -d +``` + +> 你可以通过在 0.10.6 以上的版本中挂载 `/usr/app/data/` 来持久化数据，否则你的数据会在重新创建容器后完全丢失。 + +> 如果你打算输入一些特殊字符，你可能需要在创建数据库时改变字符集和排序。请查看[MySQL Docker Compose](https://github.com/nocodb/nocodb/issues/1313#issuecomment-1046625974)的例子。 + +# GUI + +点击 [http://localhost:8080/dashboard](http://localhost:8080/dashboard) 打开仪表盘。 # 加入我们的社区 - + + -
-
+ + + # 截图 @@ -117,83 +174,112 @@ npm start ![11](https://user-images.githubusercontent.com/86527202/136066756-fc203c2c-570e-4514-b9f4-2a41ac24e5dd.png)
-# 特征 +# 功能 + ### 丰富的电子表格功能 -- ⚡ 搜索，排序，过滤，隐藏列 -- ⚡ 创建视图：网格，画廊，看板，甘特图，表单 -- ⚡ 分享视图：公开 或 密码保护 -- ⚡ 个人和锁定视图 -- ⚡ 将图像上传到单元格（使用S3，Minio，GCP，Azure，DigitalOcean，Linode，OVH，Backblaze） -- ⚡ 角色：所有者，创建者，编辑器，查看器，评论者，自定义角色。 -- ⚡ 访问控制：在 `数据库`、`表`、`列` 级别的访问控制。 - -### 工作流自动化应用商店： -- ⚡ 聊天：微软Teams，Slack，Discord，Mattermost -- ⚡ 电子邮件：SMTP，SES，MailChimp -- ⚡ 短信：Twilio -- ⚡ whatsapp -- ⚡ 任何第三方API - -### Programmatic API访问通过： -- ⚡ REST API (Swagger) -- ⚡ GraphQL API -- ⚡ JWT身份验证和社交验证 -- ⚡ 与Zapier，Integromat集成的API - -# 生产安装 -NoCodb 要求一个数据库用来存储电子表格视图和外部元数据。可以在`NC_DB`环境变量中指定此数据库的连接参数。 - -## Docker - -#### MySQL 示例 -```bash -docker run -d -p 8080:8080 \ - -e NC_DB="mysql2://host.docker.internal:3306?u=root&p=password&d=d1" \ - -e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ - nocodb/nocodb:latest -``` +- ⚡ 基本操作：对表、列和行进行增删改查 +- ⚡ 字段操作：排序、过滤、隐藏/取消隐藏列 +- ⚡ 多种视图：网格（默认）、画廊和表单视图 +- ⚡ 视图权限：协作视图和锁定的视图 +- ⚡ 分享基础/视图：公开或私人（有密码保护） +- ⚡ 多种单元格类型：ID、链接到另一记录、查找、滚动、单行文本、附件、货币、公式等 +- ⚡ 基于角色的访问控制：不同层次的精细化地控制访问 +- ⚡ 以及更多...... -#### Postgres 示例 -```bash -docker run -d -p 8080:8080 \ - -e NC_DB="pg://host:port?u=user&p=password&d=database" \ - -e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ - nocodb/nocodb:latest +### 工作流程自动化的应用商店 + +我们在三个主要类别中提供不同的集成。详见App Store。 + +- ⚡ 聊天：Slack、Discord、Mattermost 等 +- ⚡ 电子邮件: AWS SES，SMTP，MailerSend 等 +- ⚡ 存储：AWS S3，Google Cloud Storage，Minio 等 + +### 外部程序 API + +我们提供以下方式让用户以编程方式调用操作。 您可以使用 Token（JWT 或 Social Auth）来签署您对 NocoDB 授权的请求。 + +- ⚡  REST APIs +- ⚡  NocoDB SDK + +### 架构同步 + +如果您在 NocoDB GUI 之外进行了更改，我们允许您同步架构更改。 但是，必须注意的是，您必须附有自己的迁移架构才能从一个环境迁移到其他环境。 有关详细信息，请参阅 同步架构。 + +### 审计 + +我们将所有用户操作日志保存在一起。 有关详细信息，请参阅 审计。 + +# 生产部署 + +默认情况下使用 SQLite 存储元数据。你也可以指定你自己的数据库。这个数据库的连接参数可以在 `NC_DB` 环境变量中指定。此外，我们还提供以下环境变量进行配置： + +## 环境变量 + +参见[环境变量](https://docs.nocodb.com/getting-started/installation#environment-variables) + +# 开发 + +## 拉取项目 + +```shell +git clone https://github.com/nocodb/nocodb +cd nocodb ``` -#### SQL Server 示例 -```bash -docker run -d -p 8080:8080 \ - -e NC_DB="mssql://host:port?u=user&p=password&d=database" \ - -e NC_AUTH_JWT_SECRET="569a1821-0a93-45e8-87ab-eb857f20a010" \ - nocodb/nocodb:latest +## 本地运行后端 + +```shell +cd packages/nocodb +npm install +npm run watch:run +# 在浏览器中打开 localhost:8080/dashboard ``` -## Docker Compose -```bash -git clone https://github.com/nocodb/nocodb -cd docker-compose -cd mysql or pg or mssql -docker-compose up -d +## 本地运行前端 + +```shell +cd packages/nc-gui +npm install +npm run dev +# 在浏览器中打开 localhost:3000/dashboard ``` -## 环境变量 +修改代码后会自动重新启动。 + +> nocodb/packages/nocodb 包括 nc-lib-gui，它是 npm 源中托管的 nc-gui 的预构建版本。如果您只想修改后端，则可以在本地启动后端后在浏览器中访问 localhost:8000/dashboard -Please refer to [Environment variables](https://docs.nocodb.com/getting-started/installation#environment-variables) +## 本地运行 Cypress 测试 + +```shell +# 安装依赖 (cypress) +npm install -# 开发安装 +# 使用 docker compose 运行带有所需数据库的 mysql 数据库 +docker-compose -f ./scripts/docker-compose-cypress.yml up -Please refer to [Development Setup](https://github.com/nocodb/nocodb/tree/master#development-setup) +# 使用以下命令运行后端 api +npm run start:api + +# 使用以下命令运行前端 Web UI +npm run start:web + +# 等待 3000 和 8080 端口都可用后 +# 使用以下命令运行 cypress 测试 +npm run cypress:run + +# 或运行以下命令以使用 GUI 运行它 +npm run cypress:open +``` # 贡献 -Please refer to [Contribution Guide](https://github.com/nocodb/nocodb/blob/master/.github/CONTRIBUTING.md). +参见[贡献指南](https://github.com/nocodb/nocodb/blob/master/.github/CONTRIBUTING.md). -# 为什么我们建立这个？ +# 我们为什么要做这个？ -大多数互联网业务都配备了电子表格或数据库以解决其业务需求，每天有上亿人使用电子表格。我们基于数据库运行更强大的工具能更高效地完成工作。用SaaS产品解决此问题的尝试已经意味着可怕的访问控制，供应商锁定，数据锁定，突然的价格变化，甚至是将来可能会阻碍发展。 +大多数互联网企业都为自己配备了电子表格或数据库来解决他们的业务需求。每天有十亿多人协作使用电子表格。然而，我们在数据库上以类似的效率工作还有很长的路要走，这些数据库在计算方面是更强大的工具。使用 SaaS 产品解决这个问题意味着可怕的访问控制、供应商锁定、数据锁定、突然的价格变化以及最重要的是未来可能出现的玻璃天花板。 # 我们的任务 -我们的使命是为数据库提供最强大的无码界面，为世界上每一个互联网业务的开源使用。这不仅将民主化带给强大的计算工具，还将为数亿人增强他们的创造力。 +我们的使命是为数据库提供最强大的无代码接口，并向世界上每一个互联网企业开放源代码。这不仅能让这个强大的计算工具开放给每个人，而且10亿或更多的人将会在互联网上拥有激进的修补和建设能力。 From 24b9a11dee39f0b6dc164c3f10c5544e54f63491 Mon Sep 17 00:00:00 2001 From: Tim-Paik Date: Sun, 15 May 2022 14:04:24 +0800 Subject: [PATCH 2/2] docs: improve the Chinese translation --- scripts/markdown/readme/languages/chinese.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/markdown/readme/languages/chinese.md b/scripts/markdown/readme/languages/chinese.md index aabe72d8b3..f4fc28bd4d 100644 --- a/scripts/markdown/readme/languages/chinese.md +++ b/scripts/markdown/readme/languages/chinese.md @@ -195,7 +195,7 @@ docker-compose up -d - ⚡ 电子邮件: AWS SES，SMTP，MailerSend 等 - ⚡ 存储：AWS S3，Google Cloud Storage，Minio 等 -### 外部程序 API +### 使用 API 编程访问 我们提供以下方式让用户以编程方式调用操作。 您可以使用 Token（JWT 或 Social Auth）来签署您对 NocoDB 授权的请求。