如何在 documen.tician.de 上找到某个项目的文档?
documen.tician.de 的首页就是一个 Apache 风格的目录索引(标题为 “Index of /”),所有项目文档按目录名平铺列出。找文档的方式很直接:在列表里找到与项目同名的目录,点进去即可。目录名基本与 Python 包名一致,例如 pycuda/、pyopencl/、pudb/、loopy/、meshmode/。如果你已经知道包名,直接在浏览器里把包名拼到域名后面(如 documen.tician.de/pycuda/)通常比在长列表里翻找更快。
目录名与项目的对应关系
首页列出的每个条目都是一个子目录,右侧显示最后修改时间。按用途大致可以分成几类:
| 类别 | 目录示例 | 说明 |
|---|---|---|
| GPU 与并行计算 | pycuda/、pyopencl/、pytato/、loopy/、cgen/、codepy/ |
CUDA/OpenCL 绑定、代码生成与数组计算 |
| 网格与数值方法 | meshmode/、meshpy/、modepy/、grudge/、hedge/、boxtree/、sumpy/、pytential/ |
网格生成、离散化、积分方程等 |
| 符号与表达式 | pymbolic/、pytools/、islpy/、pymetis/ |
符号运算、工具库、多面体编译相关 |
| 调试与开发工具 | pudb/、pyvisfile/、genpy/、relate/、arraycontext/ |
终端调试器、代码生成与可视化 |
| 其他 | gmsh_interop/、dagrt/、leap/、namedisl/、starlark-pyo3/、pyublas/、pylo/ |
与 Gmsh 互操作、时间步进、语言绑定等 |
| 旧版文档 | hedge-manual/、hedge-reference/ |
早期 hedge 项目的手册与参考,时间戳停留在 2013 年 |
具体操作步骤
- 打开
documen.tician.de,你会看到 “Index of /” 及一列目录。 - 用浏览器的页内查找(Ctrl+F / Cmd+F)输入你记得的包名片段,例如
opencl,快速定位到pyopencl/。 - 点击目录进入。预期结果是看到该目录下的文件列表,通常是 HTML 文档、PDF 或源码目录。
- 如果目录里还有子目录,继续点进去,直到找到
index.html之类的入口文件并打开。
找不到时的排查方式
- 名字记不全:目录名就是包名,按 Python 导入时用的名字找。比如
import pycuda对应pycuda/。 - 不确定属于哪个项目:直接从头到尾浏览整个列表。列表不长,按字母顺序排列,扫一遍即可。
- 目录存在但内容为空或只有源码:部分目录可能只放了构建产物或源码,不一定有排版好的文档页面。这时可以回到列表换一个相关目录,例如找 hedge 的说明时,
hedge-manual/和hedge-reference/比hedge/更可能是文档本体。 - 时间戳很旧:像
codepy/(2016 年)、hedge/(2013 年)这类目录,内容可能对应较老版本,阅读时注意与当前版本是否一致。
这个站点是什么
documen.tician.de 是 Andreas Klöckner(tician)维护的项目文档集合入口,托管的是他参与开发的多个 Python 科学计算与 GPU 计算库的文档。首页没有导航页或搜索框,只有服务器自动生成的目录列表,所以“Index of /”就是它的正常形态,不是出错页面。