如何通过wkhtmltopdf向HTML封面（cover.html）传递字符串参数？

仅用wkhtmltopdf原生功能，无法直接用页眉页脚的内置查询字符串或--replace参数给cover.html传递数据。原因是wkhtmltopdf的页眉页脚有专属的渲染上下文，内置参数和--replace是针对这个上下文设计的，但封面页作为独立初始页面渲染，不共享该上下文，所以直接套用页眉页脚的传参方式会得到undefined。

可行的替代方案（仅用wkhtmltopdf实现） #

通过给cover.html的URL添加查询字符串参数，再在cover.html里用JavaScript解析参数：

1. 命令行传参示例：

wkhtmltopdf --cover cover.html?project=MyProject&version=1.0 --header-html header.html input.html output.pdf

2. cover.html中解析参数的代码：

<script>
function getQueryParam(paramName) {
    const params = new URLSearchParams(window.location.search);
    return params.get(paramName);
}

window.addEventListener('load', () => {
    // 渲染自定义参数
    document.getElementById('project-title').textContent = getQueryParam('project') || '默认项目';
    document.getElementById('version-tag').textContent = getQueryParam('version') || '未知版本';
});
</script>

<!-- 页面中对应位置 -->
<h1>项目文档：<span id="project-title"></span></h1>
<p>版本：<span id="version-tag"></span></p>

注意事项 #

• 封面页是独立渲染的，没有分页相关的内置参数（如page/topage），如果需要这类数据，需自行计算后通过查询字符串传递。
• 查询字符串中的特殊字符需要做URL编码（比如空格用%20代替），避免解析错误。

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