如何实现Gramex应用自动渲染各级目录下的readme.md？

AI 小北

2026-7-31

实现自动识别子目录的Gramex Markdown渲染服务

你的需求完全可行，当前问题出在URL模式匹配范围不足，导致子目录请求未被指定的FileHandler处理，触发了Gramex默认的目录索引行为。以下是修正后的配置和关键说明：

修正后的gramex.yaml配置

url:
  app:
    pattern: /$YAMLURL(.*)/
    handler: FileHandler
    kwargs:
      index: false
      path: $YAMLPATH{path}/readme.md
      transform:
        "*.md":
          encoding: utf-8
          function: markdown.markdown(content)
          headers:
            Content-Type: text/html; charset=UTF-8

关键修改说明

扩展URL匹配范围：将pattern改为/$YAMLURL(.*)/，其中(.*)会捕获根路径后的所有子目录路径（比如访问/subdir1/时，{path}的值为/subdir1），确保所有子目录请求都被该Handler接管。
动态定位文件路径：path配置简化为$YAMLPATH{path}/readme.md，利用捕获的{path}参数自动指向对应子目录下的readme.md。访问根路径时{path}为空，自然匹配根目录的readme.md。
禁用目录索引：保持index: false，避免Gramex在未匹配到指定文件时显示目录列表。
保留Markdown转换逻辑：原有的transform配置不变，确保所有readme.md文件都被转换为HTML格式输出。