Skip to content

doc(Html2Pdf): add localization for sample code #8080

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ArgoZhang merged 1 commit into from
Jun 3, 2026
+54 −19
Merged

doc(Html2Pdf): add localization for sample code #8080

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 18 additions & 19 deletions src/BootstrapBlazor.Server/Components/Samples/Html2Pdfs.razor
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,45 +29,44 @@
<p class="code-label">@((MarkupString)Localizer["Html2PdfStep1"].Value)</p>
<Pre>services.AddBootstrapBlazorHtml2PdfService();</Pre>

<p class="code-label">常见问题</p>
<p class="code-label">@Localizer["CommonIssuesTitle"]</p>

<p class="code-quest">1. 本地或者发布后无法使用</p>
<p class="code-answer"><code>BootstrapBlazor.Html2Pdf v9.0.3</code> 后增加了日志输出功能，可以根据日志判断具体问题出现在哪里。比如由于根据当前浏览器版本去下载对应版本的
<code>chrome-headless-shell-win64.zip</code> 安装包</p>
<p class="code-quest">@Localizer["Issue1Title"]</p>
<p class="code-answer">@((MarkupString)Localizer["Issue1Answer"].Value)</p>
<Pre>info: BootstrapBlazor.Components.DefaultPdfService[0]
Ready to start downloading browser
info: BootstrapBlazor.Components.DefaultPdfService[0]
Browser downloaded successfully. installed browser 138.0.7204.101
info: BootstrapBlazor.Components.DefaultPdfService[0]
Start your browser | Args: --no-sandbox, --disable-setuid-sandbox, --disable-web-security</Pre>

<p class="code-quest">2. 如何手动安装 <code>Debian</code> Linux 系统的 <code>Chrome</code> 浏览器</p>
<p class="code-quest">@((MarkupString)Localizer["Issue2Title"].Value)</p>
<Pre>wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb</Pre>

<p class="code-quest">3. 如何检查 <code>Debian</code> Linux 系统 <code>Chrome</code> 依赖缺失</p>
<p class="code-quest">@((MarkupString)Localizer["Issue3Title"].Value)</p>
<ul class="ul-demo">
<li>检查是否可以连接到 Chrome 服务器</li>
<li>检查服务器是否有执行安装包权限</li>
<li>检查是否有依赖缺失</li>
<li>@Localizer["Issue3Item1"]</li>
<li>@Localizer["Issue3Item2"]</li>
<li>@Localizer["Issue3Item3"]</li>
</ul>

<p>通过下面命令检查依赖缺失情况</p>
<p>@Localizer["Issue3CommandIntro"]</p>

<Pre>ldd chrome | grep not</Pre>

<p class="code-quest">4. 部署后是否会反复下载 Chrome 安装包</p>
<p class="code-answer">不会，Html2Pdf 会检查是否存在安装目录安装成功后即不会重复下载安装操作</p>
<p class="code-quest">@Localizer["Issue4Title"]</p>
<p class="code-answer">@Localizer["Issue4Answer"]</p>

<Tips>
<p>可以通过 <code>PdfOptions</code> 配置类设置导出 <code>Pdf</code> 一些相关设置</p>
<p>@((MarkupString)Localizer["PdfOptionsIntro"].Value)</p>
<ul class="ul-demo" style="margin-bottom: 0;">
<li><code>Landscape</code> 是否横向打印 默认 false</li>
<li><code>PrintBackground</code> 是否打印背景色 默认 false</li>
<li><code>Format</code> 纸张格式 默认 A4</li>
<li><code>DisplayHeaderFooter</code> 是否显示页眉页脚 默认 false</li>
<li><code>Scale</code> 放大比例 默认 1 取值 0.1 到 2 之间</li>
<li><code>MarginOptions</code> 页面边距 默认 none</li>
<li>@((MarkupString)Localizer["PdfOptionsItem1"].Value)</li>
<li>@((MarkupString)Localizer["PdfOptionsItem2"].Value)</li>
<li>@((MarkupString)Localizer["PdfOptionsItem3"].Value)</li>
<li>@((MarkupString)Localizer["PdfOptionsItem4"].Value)</li>
<li>@((MarkupString)Localizer["PdfOptionsItem5"].Value)</li>
<li>@((MarkupString)Localizer["PdfOptionsItem6"].Value)</li>
</ul>
</Tips>

Expand Down
18 changes: 18 additions & 0 deletions src/BootstrapBlazor.Server/Locales/en-US.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2567,6 +2567,7 @@
"Html2ImageTitle": "Html to Image"
},
"BootstrapBlazor.Server.Components.Samples.Html2Pdfs": {
"CommonIssuesTitle": "Common issues",
"ExportButtonText": "Export Pdf",
"ExportPdfButtonIntro": "Export the specified <code>Id</code> element content as <code>Pdf</code> by setting <code>ExportPdfButton</code> component parameter <code>ElementId</code>",
"ExportPdfButtonTitle": "ExportPdfButton",
Expand All @@ -2581,7 +2582,24 @@
"Html2PdfNote": "If you export too much content, <code>signalR</code> communication interruption may be triggered. Please adjust the <code>HubOptions</code> configuration.",
"Html2PdfStep1": "Inject Service",
"Html2PdfTitle": "Html export to Pdf",
"Issue1Answer": "Since <code>BootstrapBlazor.Html2Pdf v9.0.3</code>, logging output has been added, and you can determine where the specific problem occurs from the logs. For example, it may be downloading the matching <code>chrome-headless-shell-win64.zip</code> package based on the current browser version.",
"Issue1Title": "1. It cannot be used locally or after deployment",
"Issue2Title": "2. How to manually install the <code>Chrome</code> browser on <code>Debian</code> Linux",
"Issue3CommandIntro": "Use the following command to check for missing dependencies",
"Issue3Item1": "Check whether the server can connect to the Chrome download server",
"Issue3Item2": "Check whether the server has permission to execute the installation package",
"Issue3Item3": "Check whether any dependencies are missing",
"Issue3Title": "3. How to check missing <code>Chrome</code> dependencies on <code>Debian</code> Linux",
"Issue4Answer": "No. Html2Pdf checks whether the installation directory already exists, and after a successful installation it will not repeatedly download and install the package.",
"Issue4Title": "4. Will the Chrome installation package be downloaded repeatedly after deployment?",
"PackageIntro": "Component default not implemented <code>IHtml2Pdf</code>, please refer to the package <code>BootstrapBlazor.Html2Pdf</code> package",
"PdfOptionsIntro": "You can configure related export settings for <code>Pdf</code> through the <code>PdfOptions</code> configuration class",
"PdfOptionsItem1": "<code>Landscape</code> whether to print in landscape mode, default is false",
"PdfOptionsItem2": "<code>PrintBackground</code> whether to print background colors, default is false",
"PdfOptionsItem3": "<code>Format</code> paper format, default is A4",
"PdfOptionsItem4": "<code>DisplayHeaderFooter</code> whether to display headers and footers, default is false",
"PdfOptionsItem5": "<code>Scale</code> zoom ratio, default is 1, range is between 0.1 and 2",
"PdfOptionsItem6": "<code>MarginOptions</code> page margins, default is none",
"Tips1": "Introduce",
"Tips2": "service",
"ToastContent": "Export table by id to pdf success.",
Expand Down
18 changes: 18 additions & 0 deletions src/BootstrapBlazor.Server/Locales/zh-CN.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2567,6 +2567,7 @@
"Html2ImageTitle": "Html2Image 网页元素转成图片服务"
},
"BootstrapBlazor.Server.Components.Samples.Html2Pdfs": {
"CommonIssuesTitle": "常见问题",
"ExportButtonText": "导出 Pdf",
"ExportPdfButtonIntro": "通过设置 <code>ExportPdfButton</code> 组件参数 <code>ElementId</code> 将指定 <code>Id</code> 元素内容导出为 <code>Pdf</code>",
"ExportPdfButtonTitle": "使用 ExportPdfButton 导出按钮",
Expand All @@ -2581,7 +2582,24 @@
"Html2PdfNote": "如果导出内容过多，可能会触发 <code>signalR</code> 通讯中断问题，请自行调整 <code>HubOptions</code> 配置即可。",
"Html2PdfStep1": "注入服务",
"Html2PdfTitle": "Html 导出为 Pdf",
"Issue1Answer": "<code>BootstrapBlazor.Html2Pdf v9.0.3</code> 后增加了日志输出功能，可以根据日志判断具体问题出现在哪里。比如由于根据当前浏览器版本去下载对应版本的 <code>chrome-headless-shell-win64.zip</code> 安装包",
"Issue1Title": "1. 本地或者发布后无法使用",
"Issue2Title": "2. 如何手动安装 <code>Debian</code> Linux 系统的 <code>Chrome</code> 浏览器",
"Issue3CommandIntro": "通过下面命令检查依赖缺失情况",
"Issue3Item1": "检查是否可以连接到 Chrome 服务器",
"Issue3Item2": "检查服务器是否有执行安装包权限",
"Issue3Item3": "检查是否有依赖缺失",
"Issue3Title": "3. 如何检查 <code>Debian</code> Linux 系统 <code>Chrome</code> 依赖缺失",
"Issue4Answer": "不会，Html2Pdf 会检查是否存在安装目录安装成功后即不会重复下载安装操作",
"Issue4Title": "4. 部署后是否会反复下载 Chrome 安装包",
"PackageIntro": "组件默认未实现 <code>IHtml2Pdf</code>，请通过引用包 <code>BootstrapBlazor.Html2Pdf</code> 实现",
"PdfOptionsIntro": "可以通过 <code>PdfOptions</code> 配置类设置导出 <code>Pdf</code> 一些相关设置",
"PdfOptionsItem1": "<code>Landscape</code> 是否横向打印 默认 false",
"PdfOptionsItem2": "<code>PrintBackground</code> 是否打印背景色 默认 false",
"PdfOptionsItem3": "<code>Format</code> 纸张格式 默认 A4",
"PdfOptionsItem4": "<code>DisplayHeaderFooter</code> 是否显示页眉页脚 默认 false",
"PdfOptionsItem5": "<code>Scale</code> 放大比例 默认 1 取值 0.1 到 2 之间",
"PdfOptionsItem6": "<code>MarginOptions</code> 页面边距 默认 none",
"Tips1": "实现原理",
"Tips2": "服务",
"ToastContent": "通过表格 Id 导出 Pdf 文件成功",
Expand Down
Loading