Tampio 开源项目使用手册

1. 项目目录结构及介绍

Tampio 是一个面向对象的编程语言，其语法设计模仿了芬兰语的特点。以下是对该项目在GitHub上的目录结构的概述：

- .git/                  # Git版本控制相关文件
- examples/              # 示例代码存放目录
    - <示例程序>.itp     # 编写好的Tampio源码文件
- tampio.py             # 主要的编译和运行脚本
- ast.py                # 抽象语法树相关的处理代码
- editor.py             # 可能用于编辑器支持的相关功能
- fatal_error.py        # 错误处理逻辑
- grammar.py            # 语言语法定义
- hierarchy.py          # 类层次处理
- highlighter.py        # 代码高亮相关代码
- inflect.py            # 芬兰语形态学处理函数
- lex.py                # 词法分析器
- std.itp               # 标准库或者示例的标准输入文件
- syntax.css            # 语法高亮CSS样式
- README.md             # 项目说明文档
- LICENSE               # 许可证文件
- gitignore             # Git忽略文件列表

目录结构解析:

• examples: 包含Tampio语言的示例程序，如计算阶乘等。
• tampio.py: 运行时核心，提供了编译到JavaScript或交互式运行的功能。
• 各类.py*: 处理Tampio语言编译、解析、错误处理等逻辑的Python模块。

2. 项目启动文件介绍

主要启动文件是tampio.py。通过这个脚本，用户可以执行以下操作：

• 打开交互式提示：python3 tampio.py。
• 将Tampio源代码编译为JavaScript：python3 tampio.py file.itp。
• 输出带有语法高亮的Markdown代码：python3 tampio.py -s markdown-lists file.itp。
• 生成含有JavaScript和语法高亮的HTML页面：python3 tampio.py -i -p file.itp。

该脚本作为与Tampio语言互动的主要入口点，既支持开发阶段的即时反馈，也支持将源码转换为其他形式，如Web可执行的JavaScript代码。

3. 项目的配置文件介绍

Tampio项目本身并未直接强调特定的配置文件。它的配置更多依赖于环境变量和外部依赖（如Python 3版本、Libvoikko库）。然而，在实际应用中，用户可能需要调整自己的开发环境，比如设置PYTHONPATH以确保能正确调用tampio.py脚本，以及安装必要的依赖项，特别是libvoikko及其配套的芬兰语字典文件，这些通常不是通过项目内配置文件来管理的，而是通过系统包管理器或pip进行安装。

对于想要定制编译或运行行为的高级用户，他们可能会间接通过环境变量或修改tampio.py脚本中的默认参数来进行配置，但这并不构成一个标准的配置文件部分。

---

请注意，项目没有直接提供的配置文件，因此这里的“配置文件介绍”基于如何准备环境以满足项目要求的视角来解释。