# Cattca 项目地址：[GitHub](https://github.com/WiseDragon-chem/Cattca) --- ## 目录 - [介绍](#介绍) - [基本概念](#基本概念) - [常用命令](#常用命令) - [运算符](#运算符) - [示例](#示例) - [互动小说](#1-互动小说) - [算法演示](#2-算法演示冒泡排序) - [最佳实践](#最佳实践) - [常见问题](#常见问题) - [更多资源](#更多资源) --- ## 介绍 ### Cattca 是什么？ Cattca 是一门 **交互式文本编程语言**。它结合了**文本标记**与**逻辑控制**，让你在写故事或文档时加入变量、分支和输入。 ### Cattca 能做什么？ - **互动小说** - **文字冒险游戏** - **算法演示** 或 **教学示例** ### 为什么选择 Cattca？ - **简单**：几分钟就能上手。 - **直观**：文本就是界面，逻辑用命令补充。 - **高效**：快速实现小型交互项目。 --- ## 基本概念 Cattca 文件由两部分组成：**文本**和**命令**。 ### 文本直接写的文字会按顺序输出： ```Cattca 一段文本第二段文本 ``` 输出： ``` 一段文本第二段文本 ``` ### 命令命令用 `` 包裹，可以多条写在一起，用 `;` 分隔： ```Cattca 一段文本第二段文本 ``` ### 注释注释用 `/*`和`*/`包裹。 ```Cattca 这段文本会被渲染 /* 这段文本不会被渲染 */ ``` --- ## 常用命令以下命令是 Cattca 的核心。每个命令都有 **作用 / 语法 / 示例**。 --- ### `` 与 `` 像“书签”和“翻页”： * **label**：打书签 * **goto**：跳到书签 **语法：** ```Cattca ``` **示例：** ```Cattca 一段文本。这段文本不会被显示。这段文本会被显示。 ``` 输出： ``` 一段文本。这段文本会被显示。 ``` --- ### `` 结束程序。 ```Cattca 一段文本。这段文本不会显示。 ``` --- ### `` 与 `` * **let**：声明变量 * **set**：修改变量 ```Cattca ``` 变量支持 **数字、布尔值、字符串**。未赋值时默认为 `null`。 --- ### `` 条件判断。 **语法：** ```Cattca action /> ``` 支持运算符：`>``<``==` **示例：** ```Cattca 5 -> goto success /> a 大于 5！ ``` --- ### `` 在终端输出变量或表达式。 ```Cattca ``` 输出： ``` 42 ab ``` --- ### `` 获取用户输入。 #### 文本输入 ```Cattca 你好，！ ``` #### 选项输入 ```Cattca goto open: '转身离开' -> goto leave; > 你走进了森林。你回到了小镇。 ``` --- ### `` 直接把一个字符串输出到文本流。 ```Cattca 你好，！ ``` 输出： ``` 你好，莱莉菥！ ``` ### `` `random` 用来将一个变量赋值为随机整数。语法：`` 其中，left/right为两个整数，表示区间。左闭右闭。 variable_name 需要提前声明。 --- ## 运算符 Cattca 支持基本运算： * `+` 加法 / 字符串拼接 * `-` 减法 * `*` 乘法示例： ```Cattca ``` --- ## 示例 ### 1. 互动小说 ```Cattca 你叫莱莉菥。现在是早上六点，你醒了。你要怎么做？ goto sleep: '起床' -> goto wake: '看手机' -> goto fail; /> 3 -> goto end_sleep /> 你翻来覆去，还是没睡着。结局一：你起床了，迎来了新的一天。结局二：你看手机太久，不知不觉天亮了。结局三：你又睡着了，错过了一整天。 ``` --- ### 2. 算法演示（冒泡排序） ```Cattca goto cmp; goto outer_inc; /> goto cmp0; if j == 1 -> goto cmp1; if j == 2 -> goto cmp2; goto step_end; /> right -> goto swap0; goto noswap0; /> right -> goto swap1; goto noswap1; /> right -> goto swap2; goto noswap2; /> goto finished; if pass < n - 1 -> goto outer; goto finished; /> ``` --- ## 最佳实践 1. **标签要清晰**：避免 `label1`，尽量写成 `label_wake`。 2. **防止死循环**：使用 `goto` 时要设计好退出条件。 3. **变量名可读**：如 `score`、`hp`，而不是 `a`、`b`。 --- ## 常见问题 **Q: 如何在文本中显示 ``？** A: 目前需要避免直接写出，可以用替代符号。 **Q: 支持哪些数据类型？** A: 数字、布尔值、字符串。 **Q: 可以嵌套命令吗？** A: 命令块内能写多条命令，但不能嵌套。 --- ## 更多资源 * [GitHub 仓库](https://github.com/WiseDragon-chem/Cattca) * [示例项目](https://github.com/WiseDragon-chem/Cattca/examples) * [反馈问题](https://github.com/WiseDragon-chem/Cattca/issues)

Cattca - 动态的文本标记语言