Merge branch 'main' of github.com:d4v1d03/kcl-lang.io into main

Author: d4v1d03

VERSION

@@ -1 +1 @@
-0.8
+0.9

docs/user_docs/concepts/type-and-definition.md

@@ -9,7 +9,7 @@ KCL features a **gradual static type system**, initially designed to consider sc
 The configuration of attributes and types in KCL usually follows a simple pattern:
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 where $k$ is the attribute name, $v$ is the attributes value, and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted.

docs/user_docs/getting-started/intro.md

@@ -65,10 +65,10 @@ While KCL is not a general-purpose language, it excels within its specific domai
 KCL's attribute configuration follows a simple pattern:
 
 $$
-k op (T) v
+k\ o \ (T) \ v
 $$
 
-where $k$ is the attribute name, $v$ is the attributes value, $op$ is the attribute operator and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted. `deploy = Deployment {}` is a simple example that satisfies the pattern.
+where $k$ is the attribute name, $v$ is the attributes value, $o$ is the attribute operator and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted. `deploy = Deployment {}` is a simple example that satisfies the pattern.
 
 This is an example of generating Kubernetes manifests.
 

docs/user_docs/support/faq-install.md

@@ -28,6 +28,14 @@ Please ensure that the following dependencies are in your PATH:
 - `gcc` for Linux
 - `cl.exe` for Windows, which can be obtained by installing `MSVC` including `MSVCP140.dll` and `VCRUNTIME140.dll`.
 
+## Error: invalid character 'c' looking for beginning of value
+
+Please ensure that the following dependencies are in your PATH:
+
+- `clang` for MacOS
+- `gcc` for Linux
+- `cl.exe` for Windows, which can be obtained by installing `MSVC` including `MSVCP140.dll` and `VCRUNTIME140.dll`.
+
 ## Encountering exit status 0xc0000135 error on Windows platform
 
 Please ensure that `.NET Framework` and `MSVC` are installed on your Windows. If not installed, you can install them and try again.

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/concepts/type-and-definition.md

@@ -9,7 +9,7 @@ KCL features a **gradual static type system**, initially designed to consider sc
 The configuration of attributes and types in KCL usually follows a simple pattern:
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 where $k$ is the attribute name, $v$ is the attributes value, and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted.

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/getting-started/intro.md

@@ -66,10 +66,10 @@ KCL 试图提供独立于运行时的可编程性，不在本地提供线程和
 KCL 配置通常遵循如下模式：
 
 $$
-k op (T) v
+k\ o \ (T) \ v
 $$
 
-其中，$k$ 是属性名称，$v$ 是属性值，$op$ 是属性运算符，$T$ 是类型注解。由于 KCL 具有类型推导的能力，因此 $T$ 通常可以省略。比如 `deploy = Deployment {}` 就是一个符合该模式的简单示例。
+其中，$k$ 是属性名称，$v$ 是属性值，$o$ 是属性运算符，$T$ 是类型注解。由于 KCL 具有类型推导的能力，因此 $T$ 通常可以省略。比如 `deploy = Deployment {}` 就是一个符合该模式的简单示例。
 
 下面是一个用 KCL 生成 Kubernetes 资源的例子
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/support/faq-install.md

@@ -28,6 +28,14 @@ xattr -d com.apple.quarantine /path/to/kcl
 - Linux: `gcc`
 - Windows: `cl.exe` (可以通过安装 `MSVC` 获得，主要包括 `MSVCP140.dll` 和 `VCRUNTIME140.dll` 等程序集)
 
+## 错误：invalid character 'c' looking for beginning of value
+
+请确保如下依赖在您的 PATH 中
+
+- MacOS: `clang`
+- Linux: `gcc`
+- Windows: `cl.exe` (可以通过安装 `MSVC` 获得，主要包括 `MSVCP140.dll` 和 `VCRUNTIME140.dll` 等程序集)
+
 ## 在 Windows 平台上遇到 exit status 0xc0000135 错误
 
 请确保您的 Windows 上安装了 `.NET Framework` 和 `MSVC`，如没有安装，可以安装并重试。

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/support/faq-kcl.md

@@ -2556,3 +2556,72 @@ final_list:
 ## 61. KCL 代码片段 `version: "v1" = "v1"` 是什么意思？
 
 这里的第一个 `"v1"` 表示变量 `version` 的类型是字符串字面类型。第二个 `"v1"` 表示变量 `version` 的默认值是 "v1"。
+
+## 62. 如何定义一个 KCL Schema 校验给定 JSON/YAML 文件的内容？
+
+我们可以使用 kcl 的 vet 工具来校验给定 JSON 文件中的数据。例如，在下面的 data.json 文件中，我们使用以下的 KCL 文件（schema.k）来校验 age 参数。
+
+data.json
+
+```json
+[
+  {
+    "name": "Alice",
+    "age": 18
+  },
+  {
+    "name": "Bob",
+    "age": 10
+  }
+]
+```
+
+schema.k
+
+```kcl
+schema Person:
+    name: str
+    age: int
+
+    check:
+        age >= 10
+```
+
+校验 JSON 数据的命令
+
+```shell
+kcl vet data.json schema.k
+```
+
+## 63. 如何在给定 Schema 扩展数组属性的默认值？
+
+我们使用 += 运算符来扩展 Schema 数组属性的默认值。
+
+```python
+schema MyApp:
+   args: [str] = ["default", "args"]
+
+app = MyApp {
+   args += ["additional", "args"]
+}
+```
+
+## 64. 可以配置 kcl 在特定路径上生成 `.kclvm` 文件夹或者其他与 kcl 编译缓存相关的目录吗？
+
+可以通过变量 KCL_CACHE_PATH 来更改路径。
+
+在 macOS 和 Linux 上：
+
+可以通过向 ~/.bashrc、~/.zshrc 或类似的 shell rc 文件中添加 export 命令来设置 KCL_CACHE_PATH，或者如果您希望它只对当前会话生效，也可以直接在终端中运行它。
+
+```shell
+export KCL_CACHE_PATH=/tmp # 或者更改为您想要的路径
+```
+
+在 Windows 上
+
+可以通过命令提示符或 PowerShell 将 KCL_CACHE_PATH 设置为环境变量，以便影响所有 KCL 会话。 对于命令提示符，请使用 setx 命令来永久设置该值：
+
+```powershell
+setx KCL_CACHE_PATH "C:\temp" /M
+```

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.5/user_docs/concepts/type-and-definition.md

@@ -9,7 +9,7 @@ KCL features a **gradual static type system**, initially designed to consider sc
 The configuration of attributes and types in KCL usually follows a simple pattern:
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 where $k$ is the attribute name, $v$ is the attributes value, and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted.

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.5/user_docs/getting-started/intro.md

@@ -61,7 +61,7 @@ KCL 试图提供独立于运行时的可编程性，不在本地提供线程和I
 KCL 配置通常遵循如下模式：
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 其中，$k$ 是属性名称，$v$ 是属性值，$T$ 是类型注解。由于 KCL 具有类型推导的能力，因此 $T$ 通常可以省略。

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.6/user_docs/concepts/type-and-definition.md

@@ -9,7 +9,7 @@ KCL features a **gradual static type system**, initially designed to consider sc
 The configuration of attributes and types in KCL usually follows a simple pattern:
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 where $k$ is the attribute name, $v$ is the attributes value, and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted.

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.6/user_docs/getting-started/intro.md

@@ -64,7 +64,7 @@ KCL 试图提供独立于运行时的可编程性，不在本地提供线程和I
 KCL 配置通常遵循如下模式：
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 其中，$k$ 是属性名称，$v$ 是属性值，$T$ 是类型注解。由于 KCL 具有类型推导的能力，因此 $T$ 通常可以省略。

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.7/user_docs/concepts/type-and-definition.md

@@ -9,7 +9,7 @@ KCL features a **gradual static type system**, initially designed to consider sc
 The configuration of attributes and types in KCL usually follows a simple pattern:
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 where $k$ is the attribute name, $v$ is the attributes value, and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted.

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.7/user_docs/getting-started/intro.md

@@ -64,7 +64,7 @@ KCL 试图提供独立于运行时的可编程性，不在本地提供线程和I
 KCL 配置通常遵循如下模式：
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 其中，$k$ 是属性名称，$v$ 是属性值，$T$ 是类型注解。由于 KCL 具有类型推导的能力，因此 $T$ 通常可以省略。

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/user_docs/concepts/type-and-definition.md

@@ -9,7 +9,7 @@ KCL features a **gradual static type system**, initially designed to consider sc
 The configuration of attributes and types in KCL usually follows a simple pattern:
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 where $k$ is the attribute name, $v$ is the attributes value, and $T$ is the type annotation. Since KCL has the ability of the type inference, $T$ is usually omitted.

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/user_docs/getting-started/intro.md

@@ -66,7 +66,7 @@ KCL 试图提供独立于运行时的可编程性，不在本地提供线程和
 KCL 配置通常遵循如下模式：
 
 $$
-k = (T) v
+k\ o \ (T) \ v
 $$
 
 其中，$k$ 是属性名称，$v$ 是属性值，$T$ 是类型注解。由于 KCL 具有类型推导的能力，因此 $T$ 通常可以省略。

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9.json

@@ -0,0 +1,136 @@
+{
+  "sidebar.user_docs.category.Get Started": {
+    "message": "快速开始"
+  },
+  "sidebar.user_docs.category.Introduction": {
+    "message": "简介"
+  },
+  "sidebar.user_docs.category.User Guide": {
+    "message": "用户手册"
+  },
+  "sidebar.user_docs.guides.category.Automation": {
+    "message": "自动化"
+  },
+  "sidebar.user_docs.category.Configuration": {
+    "message": "配置"
+  },
+  "sidebar.user_docs.category.Data Integration": {
+    "message": "数据集成"
+  },
+  "sidebar.user_docs.category.Package Management": {
+    "message": "包管理工具"
+  },
+  "sidebar.user_docs.category.Package Management Tools": {
+    "message": "包管理工具"
+  },
+  "sidebar.user_docs.category.How to": {
+    "message": "如何使用"
+  },
+  "sidebar.user_docs.category.Schema Definition": {
+    "message": "模型定义"
+  },
+  "sidebar.user_docs.category.Validation": {
+    "message": "验证"
+  },
+  "sidebar.user_docs.category.Concepts": {
+    "message": "核心概念"
+  },
+  "sidebar.user_docs.category.FAQ": {
+    "message": "常见问答"
+  },
+  "sidebar.reference.category.Tutorial": {
+    "message": "教程"
+  },
+  "sidebar.reference.category.Code Lab": {
+    "message": "代码实验室"
+  },
+  "sidebar.reference.category.Spec": {
+    "message": "语言规范"
+  },
+  "sidebar.reference.category.Errors and Warnings": {
+    "message": "错误与警告"
+  },
+  "sidebar.reference.category.Types": {
+    "message": "类型系统"
+  },
+  "sidebar.reference.category.System Package": {
+    "message": "系统模块"
+  },
+  "sidebar.reference.category.Plugin System": {
+    "message": "插件系统"
+  },
+  "sidebar.reference.category.Multi-Language": {
+    "message": "多语言集成"
+  },
+  "sidebar.reference.category.Cheat Sheet": {
+    "message": "备忘表"
+  },
+  "sidebar.reference.category.Package Management": {
+    "message": "包管理工具"
+  },
+  "sidebar.reference.category.Command Reference": {
+    "message": "命令参考"
+  },
+  "sidebar.reference.category.Advanced-Concepts": {
+    "message": "进阶概念"
+  },
+  "sidebar.reference.category.Best-Practices": {
+    "message": "最佳实践"
+  },
+  "sidebar.tools.category.Command Line Tools": {
+    "message": "命令行工具"
+  },
+  "sidebar.tools.category.KCL Tools": {
+    "message": "语言工具"
+  },
+  "sidebar.tools.category.Package Management Tools": {
+    "message": "包管理工具"
+  },
+  "sidebar.tools.category.OpenAPI Tools": {
+    "message": "OpenAPI 工具"
+  },
+  "sidebar.community.category.Community": {
+    "message": "简介"
+  },
+  "sidebar.community.category.Types": {
+    "message": "类型系统"
+  },
+  "sidebar.community.category.Contribution Guide": {
+    "message": "贡献指南"
+  },
+  "sidebar.community.category.Release Policy": {
+    "message": "发布策略"
+  },
+  "sidebar.docs.category.GitOps": {
+    "message": "GitOps",
+    "description": "The label for category GitOps in sidebar docs"
+  },
+  "sidebar.docs.category.CI Integration": {
+    "message": "CI 集成",
+    "description": "The label for category CI Integration in sidebar docs"
+  },
+  "sidebar.user_docs.category.GitOps": {
+    "message": "GitOps",
+    "description": "The label for category GitOps in sidebar user_docs"
+  },
+  "sidebar.user_docs.category.CI Integration": {
+    "message": "CI 集成",
+    "description": "The label for category CI Integration in sidebar user_docs"
+  },
+  "sidebar.docs.category.Mutate or Validate Kubernetes Manifests": {
+    "message": "编辑或验证 Kubernetes 资源",
+    "description": "The label for category Mutate or Validate Kubernetes Manifests in sidebar docs"
+  },
+  "sidebar.user_docs.category.Mutate or Validate Kubernetes Manifests": {
+    "message": "编辑或验证 Kubernetes 资源",
+    "description": "The label for category Mutate or Validate Kubernetes Manifests in sidebar user_docs"
+  },
+  "sidebar.docs.category.Secret Management": {
+    "message": "敏感信息管理",
+    "description": "The label for category Secret Management in sidebar docs"
+  },
+  "sidebar.user_docs.category.Secret Management": {
+    "message": "敏感信息管理",
+    "description": "The label for category Secret Management in sidebar user_docs"
+  }
+}

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9/community/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "社区",
+  "position": 5
+}

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9/community/contribute/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "贡献指南",
+  "position": 4
+}

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9/community/contribute/contribute-code.md

@@ -0,0 +1,25 @@
+---
+sidebar_position: 2
+---
+
+# 如何贡献代码?
+
+欢迎参与 KCL 共建贡献完善代码、完善代码文档和测试，同时也欢迎通过 Issue 提供反馈。本文主要针对修改和完善已有的代码，如果是希望增加 KCL 语言特性请通过 KEP 流程提交。
+
+## 1. 代码和注释中的错别字
+
+如果只是修改代码和注释中的错别字，不涉及代码逻辑的调整，那么可以直接在 Github 克隆仓库后直接修改并提交 PR。需要注意的是尽量保持代码风格一致。
+
+## 2. 如何贡献 KCL 代码
+
+- 先确保本地测试环境正常
+- 修改代码并补充测试
+- 本地测试通过后提交 PR
+
+## 3. 如何贡献 VS Code 插件代码
+
+请参考 VS Code 插件仓库的相关文档
+
+## 4. 开发流程相关代码
+
+欢迎通过 Issue 和讨论组讨论。