PythonTurtle 技术文档

1. 安装指南

1.1 Windows 和 macOS

在 pythonturtle.org 和 GitHub 上可以找到适用于 Microsoft Windows 和 macOS 的安装程序。

1.2 Ubuntu Linux

在 Ubuntu 上安装 PythonTurtle，首先需要安装依赖项：

sudo apt-get install -y python3-wxgtk4.0

然后通过 pip 安装 PythonTurtle：

python3 -m pip install --user PythonTurtle
PythonTurtle

1.3 Fedora

在 Fedora 上安装 PythonTurtle，首先需要通过 pip 安装 wxPython：

python3 -m pip install wxpython

然后通过 pip 安装 PythonTurtle：

python3 -m pip install --user PythonTurtle
PythonTurtle

1.4 自动化安装

如果你喜欢自动化安装，可以使用 Ansible 任务来设置 PythonTurtle，包括 GNOME 桌面快捷方式。

2. 项目的使用说明

2.1 启动 PythonTurtle

安装完成后，可以通过命令行启动 PythonTurtle：

PythonTurtle

2.2 使用说明

PythonTurtle 提供了一个交互式的 Python shell，学生可以通过这个 shell 使用 Python 函数来控制屏幕上的海龟。一个带有插图的帮助屏幕会向学生介绍 Python 编程的基础知识，并演示如何移动海龟。

2.3 示例代码

以下是一个简单的示例代码，用于移动海龟并绘制图形：

from turtle import *

# 移动海龟
forward(100)
right(90)
forward(100)

3. 项目API使用文档

3.1 基本函数

• forward(distance): 向前移动海龟指定的距离。
• backward(distance): 向后移动海龟指定的距离。
• right(angle): 向右旋转海龟指定的角度。
• left(angle): 向左旋转海龟指定的角度。

3.2 高级函数

• penup(): 抬起画笔，海龟移动时不绘制。
• pendown(): 放下画笔，海龟移动时绘制。
• color(color_name): 设置画笔颜色。
• circle(radius): 绘制指定半径的圆。

4. 项目安装方式

4.1 源码安装

如果你希望从源码安装 PythonTurtle，可以按照以下步骤操作：

git clone https://github.com/PythonTurtle/PythonTurtle.git
cd PythonTurtle
python3 -m pythonturtle

4.2 构建应用包

你可以通过以下命令构建应用包：

python3 setup.py clean bundle

5. 常见问题

5.1 ImportError: libpng12.so.0: cannot open shared object file: No such file or directory

如果在 Ubuntu 上遇到此错误，可以参考 askubuntu.com 上的解决方案。

6. 兼容性

PythonTurtle 已在 Python 3.6 和 wxPython 4.0.1 上进行了测试，并报告在 Windows、macOS、Ubuntu Linux 和 Fedora 上运行良好。

7. 开发与贡献

如果你希望为 PythonTurtle 贡献代码或修复 bug，请提交 Pull Request。如果可以，请同时添加测试。

8. 引用 PythonTurtle

如果你在学术工作中引用 PythonTurtle，请使用以下引用格式：

@misc{rachum2009pythonturtle,
    author={Rachum, Ram and Bittner, Peter and others},
    title={PythonTurtle: A learning environment for Python suited for beginners and children, inspired by Logo},
    month={may},
    year={2009},
    publisher={GitHub},
    doi={10.5281/zenodo.10465283},
    url={https://github.com/PythonTurtle/PythonTurtle/}
}

9. 许可证

本项目采用 MIT 许可证。