Tealdeer自定义页面配置指南

问题背景

在使用Tealdeer这个命令行工具时，许多用户希望创建自己的自定义页面来补充官方文档库中没有的命令说明。然而，在1.5.0版本中，用户按照最新文档配置自定义页面时遇到了无法识别的问题。

版本差异解析

Tealdeer在1.5.0版本和后续版本中对自定义页面的命名规范有所不同：

1. 1.5.0版本要求：自定义页面文件扩展名应为.page.md
2. 即将发布的版本：将改为使用.md作为扩展名

这种版本间的差异导致了用户配置不成功的情况。

正确配置步骤

对于使用1.5.0版本的用户，以下是创建和使用自定义页面的完整流程：

1. 确定自定义页面目录： 执行tldr --show-paths命令查看系统配置的路径信息，其中"Custom pages dir"即为自定义页面存放位置。

2. 创建自定义页面： 在指定目录下创建以.page.md结尾的文件，例如foo.page.md。

3. 页面内容格式： 自定义页面需要遵循特定的Markdown格式：

   # 命令名称
   
   > 简短描述
   
   - 使用示例1
   
   `命令 参数`
   

4. 使用自定义页面： 创建完成后，直接使用tldr 命令名即可查看自定义内容，无需额外更新缓存。

常见问题排查

如果自定义页面无法正常显示，请检查：

1. 文件是否放在正确的自定义页面目录下
2. 文件扩展名是否为.page.md(1.5.0版本)
3. 文件内容是否符合格式要求
4. 文件名是否与要查询的命令名一致(不含扩展名)

最佳实践建议

1. 保持自定义页面简洁明了
2. 优先补充工作中常用的但官方文档中没有的命令
3. 定期备份自定义页面目录
4. 考虑将自定义页面纳入版本控制系统管理

通过正确配置自定义页面，用户可以极大地提升Tealdeer工具的实用性和工作效率，打造个性化的命令行帮助系统。