悠悠楠杉
网站页面
NReco.PdfGenerator页码定制指南
11/12
标题是每一页信息传递的第一印象。在使用NReco.PdfGenerator时，若希望每页顶部或底部显示动态标题与当前页码，需借助其支持的页眉（HeaderSettings）与页脚（FooterSettings）功能。但直接插入页码占位符如[page]往往显得单调，无法满足复杂排版需求。为此，建议采用内联HTML模板的方式构建页眉页脚内容。例如：
csharp
var footer = new FooterSettings {
FontSize = 8,
RightText = "第 [page] 页 共 [topage] 页",
Line = true
};
这种方式虽基础，但在多数情况下已能满足基本展示需要。若需进一步增强可读性，可通过CSS样式嵌入更复杂的布局结构，比如居中显示页码、左侧保留文档标题、右侧标注版本号等。关键在于理解WkHtmlToPdf底层渲染机制：它本质上是一个无头浏览器，因此所有HTML和CSS规则均需兼容WebKit引擎。
关键词的合理运用不仅有助于SEO优化，也能提升生成PDF的语义清晰度。在页码定制中，“关键词”更多体现为对文档结构的精准识别。例如，当正文中存在多个章节标题（h1-h6标签），我们可通过JavaScript或服务端预处理手段标记分页点。虽然NReco.PdfGenerator本身不提供自动章节编号功能，但可通过插入带有特定样式的div元素实现强制分页：
html
第二章 用户权限管理
这种做法的优势在于完全可控，开发者可根据业务逻辑决定何时开启新页，并结合CSS定义该页面的默认页眉页脚行为。此外，利用类名或data属性记录章节名称，可在页脚中动态显示“当前章节：用户权限管理”，从而让页码信息更具上下文意义。
描述部分则关乎用户体验的整体感知。一份高质量的PDF文档不应只是内容的堆砌，更应体现设计者的用心。为此，页码样式应与整体视觉风格保持一致。假设原始HTML使用了深灰色主色调与衬线字体，那么页脚中的页码也应沿用相同配色与字体族，避免出现违和感。这要求我们在设置FooterSettings的RightText或其他文本字段时，尽量使用支持HTML的选项，并嵌入<span>标签配合内联样式：
csharp
footer.HtmlUrl = $"data:text/html;charset=utf-8,{Uri.EscapeDataString(@"
<div style='text-align:center; font-family: ""Times New Roman"", serif; color:#333; font-size:9px;'>
<span>© 2025 公司名称保留所有权利</span> |
<span>第 <span class='page'></span> 页 / 共 <span class='topage'></span> 页</span>
</div>")}";
值得注意的是，使用HtmlUrl加载内嵌HTML可突破纯文本表达的局限，实现图文混排、自定义字体甚至小型图标插入。但需警惕资源路径问题——由于是离线渲染，所有引用必须为绝对路径或Base64编码内联资源。
正文内容的设计直接影响页码分布的合理性。一段超过千字的连续文本若未做任何分段处理，极易导致某一页内容过载而下一页空白。因此，在生成PDF前应对原文进行结构性优化：合理使用段落标签、控制行高与边距、避免过宽表格撑破页面布局。同时，建议启用NReco.PdfGenerator的Web.EnableJavascript选项，以便在文档加载完成后执行脚本动态调整分页逻辑。
此外，考虑到不同设备输出的一致性，推荐明确设置页面尺寸、边距及DPI参数：
csharp
var pdfConverter = new NReco.PdfGenerator.HtmlToPdfConverter();
pdfConverter.PageSize = NReco.PdfGenerator.PageSize.A4;
pdfConverter.Margins = new PageMargins { Top = 20, Bottom = 20, Left = 15, Right = 15 };
pdfConverter.DPI = 150;
这些配置不仅能提升打印质量，也有助于页码位置的稳定呈现。特别是在包含图片或多列布局的情况下，适当的外边距能有效防止页脚被裁剪。
