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$ 通常可以省略。