如何更新p6doc读取的Raku文档？Mac环境实操求助

步骤1：确认p6doc的文档搜索路径 #

首先执行以下命令，查看p6doc实际读取的文档目录列表：

p6doc --paths

输出会包含core、site等不同层级的文档路径，例如：

/usr/local/Cellar/rakudo-star/2023.02/share/perl6/core/doc
/usr/local/Cellar/rakudo-star/2023.02/share/perl6/site/doc

注意：Str属于Raku核心类型，p6doc优先读取core目录下的核心文档，你之前替换的site/doc目录对核心类型无效。

步骤2：替换正确的文档目录 #

将从Raku/doc仓库获取的最新doc目录内容，替换到p6doc --paths输出的core/doc路径下（比如/usr/local/Cellar/rakudo-star/2023.02/share/perl6/core/doc），覆盖原有文件。

步骤3：指定路径重建索引 #

不要直接执行p6doc build，需要明确指定文档路径构建索引，确保p6doc针对更新后的文档生成索引：

p6doc build /usr/local/Cellar/rakudo-star/2023.02/share/perl6/core/doc

步骤4：验证结果 #

执行p6doc Str，此时应该能正常显示Str类型的最新文档内容。

替代方案：使用本地文档服务器 #

如果p6doc的索引问题仍无法解决，推荐直接使用Raku官方文档的本地镜像：

1. 进入克隆的Raku/doc仓库目录
2. 启动本地服务：

   raku serve.raku
   

3. 在浏览器访问http://localhost:3000，即可查看最新的Raku文档，体验比p6doc更流畅。

内容的提问来源于stack exchange，提问作者AlvaPan