Skip to content

Commit 525e75b

Browse files
ArgoZhangArgoZhang
authored
doc(Html2Pdf): add localization for sample code (#8080)
1 parent e7d3b67 commit 525e75b

3 files changed

Lines changed: 54 additions & 19 deletions

File tree

‎src/BootstrapBlazor.Server/Components/Samples/Html2Pdfs.razor‎

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -29,45 +29,44 @@
2929
<p class="code-label">@((MarkupString)Localizer["Html2PdfStep1"].Value)</p>
3030
<Pre>services.AddBootstrapBlazorHtml2PdfService();</Pre>
3131

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

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

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

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

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

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

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

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

‎src/BootstrapBlazor.Server/Locales/en-US.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2567,6 +2567,7 @@
25672567
"Html2ImageTitle": "Html to Image"
25682568
},
25692569
"BootstrapBlazor.Server.Components.Samples.Html2Pdfs": {
2570+
"CommonIssuesTitle": "Common issues",
25702571
"ExportButtonText": "Export Pdf",
25712572
"ExportPdfButtonIntro": "Export the specified <code>Id</code> element content as <code>Pdf</code> by setting <code>ExportPdfButton</code> component parameter <code>ElementId</code>",
25722573
"ExportPdfButtonTitle": "ExportPdfButton",
@@ -2581,7 +2582,24 @@
25812582
"Html2PdfNote": "If you export too much content, <code>signalR</code> communication interruption may be triggered. Please adjust the <code>HubOptions</code> configuration.",
25822583
"Html2PdfStep1": "Inject Service",
25832584
"Html2PdfTitle": "Html export to Pdf",
2585+
"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.",
2586+
"Issue1Title": "1. It cannot be used locally or after deployment",
2587+
"Issue2Title": "2. How to manually install the <code>Chrome</code> browser on <code>Debian</code> Linux",
2588+
"Issue3CommandIntro": "Use the following command to check for missing dependencies",
2589+
"Issue3Item1": "Check whether the server can connect to the Chrome download server",
2590+
"Issue3Item2": "Check whether the server has permission to execute the installation package",
2591+
"Issue3Item3": "Check whether any dependencies are missing",
2592+
"Issue3Title": "3. How to check missing <code>Chrome</code> dependencies on <code>Debian</code> Linux",
2593+
"Issue4Answer": "No. Html2Pdf checks whether the installation directory already exists, and after a successful installation it will not repeatedly download and install the package.",
2594+
"Issue4Title": "4. Will the Chrome installation package be downloaded repeatedly after deployment?",
25842595
"PackageIntro": "Component default not implemented <code>IHtml2Pdf</code>, please refer to the package <code>BootstrapBlazor.Html2Pdf</code> package",
2596+
"PdfOptionsIntro": "You can configure related export settings for <code>Pdf</code> through the <code>PdfOptions</code> configuration class",
2597+
"PdfOptionsItem1": "<code>Landscape</code> whether to print in landscape mode, default is false",
2598+
"PdfOptionsItem2": "<code>PrintBackground</code> whether to print background colors, default is false",
2599+
"PdfOptionsItem3": "<code>Format</code> paper format, default is A4",
2600+
"PdfOptionsItem4": "<code>DisplayHeaderFooter</code> whether to display headers and footers, default is false",
2601+
"PdfOptionsItem5": "<code>Scale</code> zoom ratio, default is 1, range is between 0.1 and 2",
2602+
"PdfOptionsItem6": "<code>MarginOptions</code> page margins, default is none",
25852603
"Tips1": "Introduce",
25862604
"Tips2": "service",
25872605
"ToastContent": "Export table by id to pdf success.",

‎src/BootstrapBlazor.Server/Locales/zh-CN.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2567,6 +2567,7 @@
25672567
"Html2ImageTitle": "Html2Image 网页元素转成图片服务"
25682568
},
25692569
"BootstrapBlazor.Server.Components.Samples.Html2Pdfs": {
2570+
"CommonIssuesTitle": "常见问题",
25702571
"ExportButtonText": "导出 Pdf",
25712572
"ExportPdfButtonIntro": "通过设置 <code>ExportPdfButton</code> 组件参数 <code>ElementId</code> 将指定 <code>Id</code> 元素内容导出为 <code>Pdf</code>",
25722573
"ExportPdfButtonTitle": "使用 ExportPdfButton 导出按钮",
@@ -2581,7 +2582,24 @@
25812582
"Html2PdfNote": "如果导出内容过多，可能会触发 <code>signalR</code> 通讯中断问题，请自行调整 <code>HubOptions</code> 配置即可。",
25822583
"Html2PdfStep1": "注入服务",
25832584
"Html2PdfTitle": "Html 导出为 Pdf",
2585+
"Issue1Answer": "<code>BootstrapBlazor.Html2Pdf v9.0.3</code> 后增加了日志输出功能，可以根据日志判断具体问题出现在哪里。比如由于根据当前浏览器版本去下载对应版本的 <code>chrome-headless-shell-win64.zip</code> 安装包",
2586+
"Issue1Title": "1. 本地或者发布后无法使用",
2587+
"Issue2Title": "2. 如何手动安装 <code>Debian</code> Linux 系统的 <code>Chrome</code> 浏览器",
2588+
"Issue3CommandIntro": "通过下面命令检查依赖缺失情况",
2589+
"Issue3Item1": "检查是否可以连接到 Chrome 服务器",
2590+
"Issue3Item2": "检查服务器是否有执行安装包权限",
2591+
"Issue3Item3": "检查是否有依赖缺失",
2592+
"Issue3Title": "3. 如何检查 <code>Debian</code> Linux 系统 <code>Chrome</code> 依赖缺失",
2593+
"Issue4Answer": "不会，Html2Pdf 会检查是否存在安装目录安装成功后即不会重复下载安装操作",
2594+
"Issue4Title": "4. 部署后是否会反复下载 Chrome 安装包",
25842595
"PackageIntro": "组件默认未实现 <code>IHtml2Pdf</code>，请通过引用包 <code>BootstrapBlazor.Html2Pdf</code> 实现",
2596+
"PdfOptionsIntro": "可以通过 <code>PdfOptions</code> 配置类设置导出 <code>Pdf</code> 一些相关设置",
2597+
"PdfOptionsItem1": "<code>Landscape</code> 是否横向打印 默认 false",
2598+
"PdfOptionsItem2": "<code>PrintBackground</code> 是否打印背景色 默认 false",
2599+
"PdfOptionsItem3": "<code>Format</code> 纸张格式 默认 A4",
2600+
"PdfOptionsItem4": "<code>DisplayHeaderFooter</code> 是否显示页眉页脚 默认 false",
2601+
"PdfOptionsItem5": "<code>Scale</code> 放大比例 默认 1 取值 0.1 到 2 之间",
2602+
"PdfOptionsItem6": "<code>MarginOptions</code> 页面边距 默认 none",
25852603
"Tips1": "实现原理",
25862604
"Tips2": "服务",
25872605
"ToastContent": "通过表格 Id 导出 Pdf 文件成功",

0 commit comments

Comments
 (0)