https://hugozh.cn/functions/lang/ Recent content in 语言函数 on Hugo 中文文档 Hugo zh-cn Fri, 02 Oct 2026 01:21:54 +0800 https://hugozh.cn/functions/lang/formataccounting/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/formataccounting/ <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{</span><span class="w"> </span><span class="nx">512</span><span class="na">.5032</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="nx">lang</span><span class="na">.FormatAccounting</span><span class="w"> </span><span class="nx">2</span><span class="w"> </span><span class="s">&#34;NOK&#34;</span><span class="w"> </span><span class="cp">}}</span> → NOK512.50</span></span></code></pre></div><aside class="callout callout-note"> <p class="callout-title">说明</p> <div class="callout-body"><p>日期、货币、数字与百分比的本地化由 <a href="https://github.com/bep/golocales" target="_blank" rel="noopener"><code>bep/golocales</code></a> 包完成。Hugo 使用 <a href="https://hugozh.cn/configuration/all/#locale"><code>locale</code></a> 配置项确定地区，未设置时回退到语言键本身。解析出的值必须是该包支持的地区。</p></div> </aside> https://hugozh.cn/functions/lang/formatcurrency/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/formatcurrency/ <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{</span><span class="w"> </span><span class="nx">512</span><span class="na">.5032</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="nx">lang</span><span class="na">.FormatCurrency</span><span class="w"> </span><span class="nx">2</span><span class="w"> </span><span class="s">&#34;USD&#34;</span><span class="w"> </span><span class="cp">}}</span> → $512.50</span></span></code></pre></div><aside class="callout callout-note"> <p class="callout-title">说明</p> <div class="callout-body"><p>日期、货币、数字与百分比的本地化由 <a href="https://github.com/bep/golocales" target="_blank" rel="noopener"><code>bep/golocales</code></a> 包完成。Hugo 使用 <a href="https://hugozh.cn/configuration/all/#locale"><code>locale</code></a> 配置项确定地区，未设置时回退到语言键本身。解析出的值必须是该包支持的地区。</p></div> </aside> https://hugozh.cn/functions/lang/formatnumber/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/formatnumber/ <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{</span><span class="w"> </span><span class="nx">512</span><span class="na">.5032</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="nx">lang</span><span class="na">.FormatNumber</span><span class="w"> </span><span class="nx">2</span><span class="w"> </span><span class="cp">}}</span> → 512.50</span></span></code></pre></div><aside class="callout callout-note"> <p class="callout-title">说明</p> <div class="callout-body"><p>日期、货币、数字与百分比的本地化由 <a href="https://github.com/bep/golocales" target="_blank" rel="noopener"><code>bep/golocales</code></a> 包完成。Hugo 使用 <a href="https://hugozh.cn/configuration/all/#locale"><code>locale</code></a> 配置项确定地区，未设置时回退到语言键本身。解析出的值必须是该包支持的地区。</p></div> </aside> https://hugozh.cn/functions/lang/formatnumbercustom/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/formatnumbercustom/ <p>该函数按给定精度格式化数字。第一个选项参数是一个以空格分隔的字符串，其中的字符分别表示负号、小数点与分组分隔符，默认值为 <code>- . ,</code>。第二个选项参数用于指定替代的定界字符。</p> https://hugozh.cn/functions/lang/formatpercent/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/formatpercent/ <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{</span><span class="w"> </span><span class="nx">512</span><span class="na">.5032</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="nx">lang</span><span class="na">.FormatPercent</span><span class="w"> </span><span class="nx">2</span><span class="w"> </span><span class="cp">}}</span> → 512.50%</span></span></code></pre></div><aside class="callout callout-note"> <p class="callout-title">说明</p> <div class="callout-body"><p>日期、货币、数字与百分比的本地化由 <a href="https://github.com/bep/golocales" target="_blank" rel="noopener"><code>bep/golocales</code></a> 包完成。Hugo 使用 <a href="https://hugozh.cn/configuration/all/#locale"><code>locale</code></a> 配置项确定地区，未设置时回退到语言键本身。解析出的值必须是该包支持的地区。</p></div> </aside> https://hugozh.cn/functions/lang/merge/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/merge/ <p>例如：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="o">{{</span> <span class="nv">$pages</span> :<span class="o">=</span> .Site.RegularPages <span class="p">|</span> lang.Merge <span class="nv">$frSite</span>.RegularPages <span class="p">|</span> lang.Merge <span class="nv">$enSite</span>.RegularPages <span class="o">}}</span></span></span></code></pre></div><p>会按从左到右的顺序，先用法语站点的内容、最后用英语站点的内容，为当前站点「填补空缺」。</p> <p>更实用的例子是用其它语言补齐缺失的译文：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="o">{{</span> <span class="nv">$pages</span> :<span class="o">=</span> .Site.RegularPages <span class="o">}}</span> </span></span><span class="line"><span class="cl"><span class="o">{{</span> range .Site.Home.Translations <span class="o">}}</span> </span></span><span class="line"><span class="cl"> <span class="o">{{</span> <span class="nv">$pages</span> <span class="o">=</span> <span class="nv">$pages</span> <span class="p">|</span> lang.Merge .Site.RegularPages <span class="o">}}</span> </span></span><span class="line"><span class="cl"><span class="o">{{</span> end <span class="o">}}</span></span></span></code></pre></div> https://hugozh.cn/functions/lang/translate/ Fri, 02 Oct 2026 00:00:00 +0800 https://hugozh.cn/functions/lang/translate/ <p><code>lang.Translate</code> 函数返回与给定键关联的值：先搜索当前语言的<a href="#%e7%bf%bb%e8%af%91%e8%a1%a8">翻译表</a>，再搜索 <a href="https://hugozh.cn/configuration/all/#defaultcontentlanguage"><code>defaultContentLanguage</code></a> 对应的翻译表。</p> <p>若未找到，该函数返回空字符串。</p> <aside class="callout callout-note"> <p class="callout-title">说明</p> <div class="callout-body"><p>要列出缺失的译文与回退使用的译文，请在项目配置中把 <a href="https://hugozh.cn/configuration/all/#printi18nwarnings"><code>printI18nWarnings</code></a> 设为 <code>true</code>，或在构建项目时使用 <code>--printI18nWarnings</code> 命令行参数。</p> <p>要为缺失的译文与回退使用的译文渲染占位符，请在项目配置中把 <a href="https://hugozh.cn/configuration/all/#enablemissingtranslationplaceholders"><code>enableMissingTranslationPlaceholders</code></a> 设为 <code>true</code>。</p>