Question

我一直在使用Docfx生成文档，并且一切正常。 Docfx会按预期生成.html文件。

但是，由于html个文件已嵌入php个文件中，因此我正在寻找一种将文件生成为.php个文件而不是我不使用的.html个文件的方法找不到任何信息。

我需要此功能，因为我在应用程序中使用了PHP模板引擎，并且希望在markdown文件中插入模板变量，以便PHP在加载到浏览器中时解析动态值。

如果可能的话，我希望获得有关如何执行此操作的指南。例如，如果我可以在创建文件的源代码中找到并修改文件扩展名。

谢谢。

Answer 1

没有内置功能。由于我今天遇到了同样的问题，因此，这里有一个小的解决方法，可以将其存档（在Powershell中进行采样）：

$destinationRoot = "path/to/doc"

[RegEx]$Search = '(\.html)"'
$Replace = '.php"'

ForEach ($File in (Get-ChildItem -Path $destinationRoot -Recurse -File)) {
    (Get-Content $File.FullName) -Replace $Search,$Replace | 
        Set-Content $File.FullName
}

之后，您也必须通过脚本重命名文件（这不是该脚本的一部分）。您可以通过修改Set-Content $File.FullName命令对其进行存档。您也可能希望删除旧文件。

请记住，如果链接以.html"结尾，它也会替换内容中的链接，但是页面通常不会以该扩展名结尾，因此这是可以接受的折衷方案。如果您确实遇到了这个问题，只需在URL后面附加#或其他内容即可。

在docfx文档中生成.php文件而不是.html文件

1 个答案: