lee-emqx / hocon-cn-translation

Unofficial Simplified Chinese translation of HOCON.md in lightbend/config

HOCON-CN-Translation

Here is the GitHub repository of the unofficial Simplified Chinese translation of HOCON.md in lightbend/config, mainly maintained by @ustc-zzzz and @3TUSK. The entire translation is located in HOCON.md of the repository.

这里是 lightbend/config 项目的 HOCON.md 的非官方简体中文翻译的 GitHub 仓库，由 @ustc-zzzz 和 @3TUSK 主要负责维护。整个翻译位于仓库的 HOCON.md 中。

协议

原文和本翻译均使用 Apache 2.0 协议发布。

翻译约定

翻译格式严格按照中文文案排版指北（简体中文版）进行，但有以下几个例外和补充约定：

• 链接之间不加空格
• 简体中文使用全角西式引号，而非直角引号
• 遇到斜体文本，翻译时将格式转换成粗体，因为中文排版本身不适合斜体

此外，在英译汉翻译本身方面，还有以下额外约定：

• 遇到某个英文链接时，如有对应中文链接（如对应翻译等），翻译时选择对应中文链接
• 对于特殊概念，可以在后面附上全小写字母组成的英文原文，并用括号括起来
• 特定术语的翻译首先以 JSON 官方规范为准，其次以已经出现的翻译为准
• 代表某个特定字符或字符串的英文原文，两边的引号使用原半角形式
• 代码段里的英文保持原样不翻译

翻译状态

• HOCON（人性化配置对象表示法，Human-Optimized Config Object Notation）（3TUSK，ustc-zzzz）
  • 目标/背景（ustc-zzzz）
  • 定义（ustc-zzzz）
  • 语法（3TUSK，ustc-zzzz）
    • 和 JSON 一样的地方（ustc-zzzz）
    • 注释（ustc-zzzz）
    • 对根结构更宽松的要求（ustc-zzzz）
    • 键值分隔符（ustc-zzzz）
    • 逗号（ustc-zzzz）
    • 空白（3TUSK）
    • 重复键与对象合并（3TUSK）
    • 不加引号的字符串（ustc-zzzz）
    • 多行字符串（ustc-zzzz）
    • 值连结（ustc-zzzz）
      • 字符串值连结（ustc-zzzz）
      • 数组值连结和对象值连结（ustc-zzzz）
      • 注意：引用之间含有空白的值连结（ustc-zzzz）
      • 注意：不含有逗号或换行符的数组（ustc-zzzz）
    • 路径表达式（ustc-zzzz）
    • 作为键的路径表达式（ustc-zzzz）
    • 引用（3TUSK，ustc-zzzz）
      • 自引用（ustc-zzzz）
      • 键值分隔符 +=（3TUSK）
      • 自引用举例（3TUSK）
    • 跨文件引用（ustc-zzzz）
      • 跨文件引用语法（ustc-zzzz）
      • 跨文件引用语义：合并（ustc-zzzz）
      • 跨文件引用语义：引用（ustc-zzzz）
      • 跨文件引用语义：不存在的文件和强制要求的文件（ustc-zzzz）
      • 跨文件引用语义：文件类型及格式（ustc-zzzz）
      • 跨文件引用语义：资源定位（ustc-zzzz）
    • 数字索引对象到数组的转换（ustc-zzzz）
  • MIME 类型（ustc-zzzz）
  • 对于 API 的建议（3TUSK，ustc-zzzz）
    • 自动类型转换（ustc-zzzz）
    • 单位格式（3TUSK）
    • 时间单位（3TUSK）
    • 日期单位（3TUSK）
    • 字节单位描述的尺寸（3TUSK）
    • 配置对象合并与文件合并（3TUSK）
    • 与 properties 文件之间的映射（3TUSK）
    • 常规的 JVM 应用配置文件（3TUSK）
    • 常规的系统属性覆盖（3TUSK）
    • 环境变量用作引用解析的备选项（3TUSK）
    • 连字符还是小写驼峰？（3TUSK）
  • 注意：和 Java 语言的 properties 文件的相似性（ustc-zzzz）
  • 注意：Windows 平台以及大小写敏感的环境变量（ustc-zzzz）