fix(docs): correct imageZoom and {markdown_url} config in v0.12 release blog

- Use nested imageZoom.enable: true instead of scalar imageZoom: true
- Use {markdown_url} (snake_case) placeholder matching the actual template-url
  utility key, not {markdownUrl} (camelCase) which would silently not substitute
This commit is contained in:
Xin
2026-02-20 23:35:44 +00:00
parent 8c059f7776
commit 2e709bf92d
4 changed files with 20 additions and 16 deletions

View File

@@ -43,9 +43,9 @@ hugo mod get -u github.com/imfing/hextra
![منوی زمینه](https://github.com/user-attachments/assets/0b55bee9-6f4d-4e1d-9461-60c40208cb6c)
منوی زمینه صفحه دکمه‌ای کشویی فراهم می‌کند که با آن می‌توانید محتوای صفحه را به‌صورت Markdown کپی کنید یا سورس خام Markdown را مشاهده نمایید. با افزایش کاربرانی که مستندات را به ابزارهای هوش مصنوعی مولّد می‌دهند، دسترسی سریع به Markdown تمیز بسیار مفید است. پیوندهای سفارشی با متغیرهای قالب (`{url}`، `{title}`، `{markdownUrl}`) به شما امکان می‌دهند میان‌برهای «از AI بپرس» یا سایر یکپارچه‌سازی‌ها را مستقیماً در منو ایجاد کنید.
منوی زمینه صفحه دکمه‌ای کشویی فراهم می‌کند که با آن می‌توانید محتوای صفحه را به‌صورت Markdown کپی کنید یا سورس خام Markdown را مشاهده نمایید. با افزایش کاربرانی که مستندات را به ابزارهای هوش مصنوعی مولّد می‌دهند، دسترسی سریع به Markdown تمیز بسیار مفید است. پیوندهای سفارشی با متغیرهای قالب (`{url}`، `{title}`، `{markdown_url}`) به شما امکان می‌دهند میان‌برهای «از AI بپرس» یا سایر یکپارچه‌سازی‌ها را مستقیماً در منو ایجاد کنید.
برای استفاده از قابلیت‌های «مشاهده به‌صورت Markdown» و `{markdownUrl}`، فرمت خروجی Markdown را در پیکربندی سایت فعال کنید:
برای استفاده از قابلیت‌های «مشاهده به‌صورت Markdown» و `{markdown_url}`، فرمت خروجی Markdown را در پیکربندی سایت فعال کنید:
```yaml {filename="hugo.yaml"}
outputs:
@@ -62,7 +62,7 @@ params:
enable: true
links:
- name: "Ask AI"
url: "https://example.com?content={markdownUrl}"
url: "https://example.com?content={markdown_url}"
icon: "sparkles"
```
@@ -86,7 +86,8 @@ params:
```yaml {filename="hugo.yaml"}
params:
imageZoom: true
imageZoom:
enable: true
```
### تحلیل‌گر GoatCounter

View File

@@ -43,9 +43,9 @@ hugo mod get -u github.com/imfing/hextra
![コンテキストメニュー](https://github.com/user-attachments/assets/0b55bee9-6f4d-4e1d-9461-60c40208cb6c)
ページコンテキストメニューはドロップダウンボタンを提供し、ページの内容を Markdown としてコピーしたり、生の Markdown ソースを表示できます。ドキュメントを生成 AI ツールに取り込むユーザーが増える中、クリーンな Markdown への素早いアクセスはますます有用です。テンプレート変数(`{url}``{title}``{markdownUrl}`を使ったカスタムリンクにより、「AI に質問」ショートカットなどのインテグレーションをメニューに直接組み込めます。
ページコンテキストメニューはドロップダウンボタンを提供し、ページの内容を Markdown としてコピーしたり、生の Markdown ソースを表示できます。ドキュメントを生成 AI ツールに取り込むユーザーが増える中、クリーンな Markdown への素早いアクセスはますます有用です。テンプレート変数(`{url}``{title}``{markdown_url}`を使ったカスタムリンクにより、「AI に質問」ショートカットなどのインテグレーションをメニューに直接組み込めます。
「Markdown として表示」および `{markdownUrl}` 機能を利用するには、サイト設定で Markdown 出力フォーマットを有効にしてください:
「Markdown として表示」および `{markdown_url}` 機能を利用するには、サイト設定で Markdown 出力フォーマットを有効にしてください:
```yaml {filename="hugo.yaml"}
outputs:
@@ -62,7 +62,7 @@ params:
enable: true
links:
- name: "Ask AI"
url: "https://example.com?content={markdownUrl}"
url: "https://example.com?content={markdown_url}"
icon: "sparkles"
```
@@ -86,7 +86,8 @@ params:
```yaml {filename="hugo.yaml"}
params:
imageZoom: true
imageZoom:
enable: true
```
### GoatCounter アナリティクス

View File

@@ -43,9 +43,9 @@ hugo mod get -u github.com/imfing/hextra
![Context menu](https://github.com/user-attachments/assets/0b55bee9-6f4d-4e1d-9461-60c40208cb6c)
The page context menu provides a dropdown button that lets you copy the page content as Markdown or view the raw Markdown source. As more users feed documentation into generative AI tools, having quick access to clean Markdown is increasingly useful. Custom links with template variables (`{url}`, `{title}`, `{markdownUrl}`) let you wire up "Ask AI" shortcuts or other integrations directly in the menu.
The page context menu provides a dropdown button that lets you copy the page content as Markdown or view the raw Markdown source. As more users feed documentation into generative AI tools, having quick access to clean Markdown is increasingly useful. Custom links with template variables (`{url}`, `{title}`, `{markdown_url}`) let you wire up "Ask AI" shortcuts or other integrations directly in the menu.
To use the "View as Markdown" and `{markdownUrl}` features, enable the Markdown output format in your site configuration:
To use the "View as Markdown" and `{markdown_url}` features, enable the Markdown output format in your site configuration:
```yaml {filename="hugo.yaml"}
outputs:
@@ -62,7 +62,7 @@ params:
enable: true
links:
- name: "Ask AI"
url: "https://example.com?content={markdownUrl}"
url: "https://example.com?content={markdown_url}"
icon: "sparkles"
```
@@ -86,7 +86,8 @@ Enable click-to-zoom on Markdown images with a new configuration option, powered
```yaml {filename="hugo.yaml"}
params:
imageZoom: true
imageZoom:
enable: true
```
### GoatCounter Analytics

View File

@@ -43,9 +43,9 @@ hugo mod get -u github.com/imfing/hextra
![页面上下文菜单](https://github.com/user-attachments/assets/0b55bee9-6f4d-4e1d-9461-60c40208cb6c)
页面上下文菜单提供下拉按钮,可将页面内容复制为 Markdown 或查看原始 Markdown 源码。随着越来越多用户将文档输入生成式 AI 工具,快速获取干净的 Markdown 变得越来越有用。通过模板变量(`{url}``{title}``{markdownUrl}`)添加自定义链接,可以在菜单中直接集成“询问 AI”快捷方式或其他功能。
页面上下文菜单提供下拉按钮,可将页面内容复制为 Markdown 或查看原始 Markdown 源码。随着越来越多用户将文档输入生成式 AI 工具,快速获取干净的 Markdown 变得越来越有用。通过模板变量(`{url}``{title}``{markdown_url}`)添加自定义链接,可以在菜单中直接集成“询问 AI”快捷方式或其他功能。
要使用“以 Markdown 查看”和 `{markdownUrl}` 功能,请在站点配置中启用 Markdown 输出格式:
要使用“以 Markdown 查看”和 `{markdown_url}` 功能,请在站点配置中启用 Markdown 输出格式:
```yaml {filename="hugo.yaml"}
outputs:
@@ -62,7 +62,7 @@ params:
enable: true
links:
- name: "Ask AI"
url: "https://example.com?content={markdownUrl}"
url: "https://example.com?content={markdown_url}"
icon: "sparkles"
```
@@ -86,7 +86,8 @@ params:
```yaml {filename="hugo.yaml"}
params:
imageZoom: true
imageZoom:
enable: true
```
### GoatCounter 分析