Terraform Libvirt Provider 文档构建问题分析与修复

在Terraform Libvirt Provider项目中，用户发现文档构建过程中存在一个关于网络资源页面显示的问题。该问题表现为在本地构建文档时，网络资源页面既不会出现在目录中，也无法通过域名页面上的链接访问。

经过深入分析，发现问题根源在于文档文件的命名规范和链接路径设置。具体表现为两点：

1. 网络资源文档文件使用了错误的扩展名.markdown，而正确的扩展名应该是.html.markdown。这种命名方式符合Terraform文档系统的规范要求。

2. 在域名页面中指向网络资源页面的链接使用了绝对路径/website/docs/r/network.markdown，这会导致链接失效。正确的做法是使用相对路径./network.html.markdown。

这类文档构建问题在开源项目中较为常见，特别是当项目采用自动化文档生成系统时。正确的文件命名和路径引用对于文档系统的正常运行至关重要。对于Terraform Provider项目而言，文档生成系统会扫描特定格式的文件名（以.html.markdown结尾）来构建完整的文档结构。

解决方案已经明确：

1. 将网络资源文档文件从network.markdown重命名为network.html.markdown
2. 将域名页面中的链接路径修改为相对路径形式

这种修复方式不仅解决了当前的问题，也符合项目文档系统的长期维护规范。对于开发者而言，理解文档系统的构建规则和文件命名约定，有助于避免类似问题的再次发生。