> For the complete documentation index, see [llms.txt](https://dzp.gitbook.io/tt1book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dzp.gitbook.io/tt1book/qian-yan/yue-du-zhi-nan.md).

# 阅读指南✅

本书共分为五部分。分别是：

* TinTin++ 入门
* 高级话题
* 实战
* 参考手册
* 社区

### TinTin++ 入门

这部分主要面向 tt 新用户，包含 tt 的基本指令和常用语法。

其中「**快速上手**」一章希望能够帮助新用户用较短的时间解决初次使用过程中常见的一些问题，对 tt 有一个初步的印象，尽快进入实质使用阶段。

### TinTin++ 语法指南

这部分内容将以分主题的形式阐述 tt 使用过程中不得不面对的一些看似简单实则复杂的话题。通过深入每个主题，较为系统地阐述 tt 语法，为后续学习其它功能打下坚实的基础。

「**命令和命令解析**」讲述 tt 命令的解析规则，帮助你理解 tt 是如何看待你写出的代码的。

「**变量和数据类型**」讲述 tt 中的数据类型，以及它们之间的关系。特别是一些高级数据结构的使用方法，如果掌握它们的话可以将你在其它高级语言中的编程经验迁移过来。

「**流程控制**」讲述 tt 中的流程控制语法，包括循环、分支等等。

「**强大的正则表达式**」系统介绍了 tt 内置的正则表达式语法，以及如何在 tt 中使用 PCRE。

「**调试和日志**」讲述 tt 中调试代码的技巧。

「**会话管理**」介绍在 tt 中使用多重会话来维护不同的游戏角色，以及如何发展你的群控技术。

### 实战

除了完善的编程语言特性，tt 中有着非常丰富的 MUD 客户端功能。包含各种不同类型的触发器，以及强大的地图维护功能和 UI 画图功能。有了前面的 tt 语法基础，再去掌握 tt 的高级命令，才能得心应手，随心所欲。

「**地图与路径**」介绍了 tt 的地图维护功能。主要涉及 `#map` 和 `#path` 这两个命令。

「**从走路说起**」讲述如何从头开始设计一个走路机器人。

「**数据与代码同构**」讲述 tt 中如何像操作字符串列表一样操作代码，以及如何将数据当成代码来使用。这也是 tt 非常特别的一个特性。

tt 是一种基于文本的 MUD 客户端，但这并不意味着它的人机交互功能就不够。「**定制你的人机交互方式**」一章讲述如何定制你的 UI，绘制自定义图形，在屏幕上增加可视化元素，支持鼠标，以及提高键盘输入效率。

「**坑**」主要讲述 tt 编程中容易遇到的一些陷阱。

### 参考手册

「**TinTin++指令手册**」一章计划对 tt 的每个命令做一个详尽的介绍。可以当作是 tt 命令的一个中文手册。

「**TinTin++支持的协议**」一章主要介绍 TELNET 协议以及和 MUD 有关的 TELNET 协议扩展，以及一些相关的知识。

### 社区

「**社交礼仪**」主要介绍如何在网络上寻求帮助，怎样才可以清楚地描述自己的问题以引起其他人的积极回复。

「**贡献指南**」介绍如何帮助完善本书。

「**鸣谢**」是一个贡献者名单，以铭记那些对本书撰写提出过意见和建议的人。

「**流行MUD介绍**」帮助你找到你自己喜欢的游戏。

「**参与TinTin++开发**」介绍 TinTin++ 目前的社区现状，以及如何帮助完善 TinTin++ 自身。