如何在 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 年

具体操作步骤

  1. 打开 documen.tician.de,你会看到 “Index of /” 及一列目录。
  2. 用浏览器的页内查找(Ctrl+F / Cmd+F)输入你记得的包名片段,例如 opencl,快速定位到 pyopencl/。
  3. 点击目录进入。预期结果是看到该目录下的文件列表,通常是 HTML 文档、PDF 或源码目录。
  4. 如果目录里还有子目录,继续点进去,直到找到 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 /”就是它的正常形态,不是出错页面。

documen.tician.de