From 67e026efd733faef15c72990afac7522c90d1f2c Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Sat, 16 Mar 2024 17:40:14 +0900 Subject: [PATCH 01/43] translate: dummy authors (japanese) --- exampleSite/content/authors/nunocoracao/_index.ja.md | 5 +++++ exampleSite/content/authors/secondauthor/_index.ja.md | 5 +++++ 2 files changed, 10 insertions(+) create mode 100644 exampleSite/content/authors/nunocoracao/_index.ja.md create mode 100644 exampleSite/content/authors/secondauthor/_index.ja.md diff --git a/exampleSite/content/authors/nunocoracao/_index.ja.md b/exampleSite/content/authors/nunocoracao/_index.ja.md new file mode 100644 index 00000000..aba47315 --- /dev/null +++ b/exampleSite/content/authors/nunocoracao/_index.ja.md @@ -0,0 +1,5 @@ +--- +title: "Nuno Coração" +--- + +Nuno の素晴らしいダミープロフィールです。 diff --git a/exampleSite/content/authors/secondauthor/_index.ja.md b/exampleSite/content/authors/secondauthor/_index.ja.md new file mode 100644 index 00000000..6cd94497 --- /dev/null +++ b/exampleSite/content/authors/secondauthor/_index.ja.md @@ -0,0 +1,5 @@ +--- +title: "2人目のダミー作者" +--- + +2人目のダミー作者の素晴らしいダミープロフィールです。 From 74bd2b2b350d9f0172fd93d24ce353210bbfce23 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Wed, 20 Mar 2024 10:52:30 +0900 Subject: [PATCH 02/43] translate: samples/thumbnail_sample into japanese --- .../samples/thumbnail_sample/index.ja.md | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 exampleSite/content/samples/thumbnail_sample/index.ja.md diff --git a/exampleSite/content/samples/thumbnail_sample/index.ja.md b/exampleSite/content/samples/thumbnail_sample/index.ja.md new file mode 100644 index 00000000..af606f12 --- /dev/null +++ b/exampleSite/content/samples/thumbnail_sample/index.ja.md @@ -0,0 +1,38 @@ +--- +title: "サムネイル" +date: 2022-09-26 +draft: false +description: "記事のサムネイルを変更する。" +slug: "thumbnail_sample" +tags: ["thumbnail", "sample"] +summary: "A quick example of how to start using Thumbnails in your artciles." +type: 'sample' +--- + +記事でどのようにサムネイルを利用するかの簡単な例です。 + +記事の平均的なディレクトリが以下のようなものだとしたら: + +```shell +content +└── awesome_article.md +``` + +単一の markdown ファイルから、フォルダーに入っている形式に変更する必要があります。記事の名前と同一のディレクトリを作成し、その中に `index.md` ファイルを作成します。このようにすると、以下のような構成になります。 + +```shell +content +└── awesome_article + └── featured.png +``` + +記事内に `feature*` から始まる名前の画像ファイル (ほとんど全てのフォーマットを対応していますが、 `.png` か `.jpg` を推奨しています) を追加できます。以下が例です。 + +```shell +content +└── awesome_article + ├── index.md + └── featured.png +``` + +これによって Blowfish は、記事のサムネイルをウェブサイトまたは SNS の oEmbed カードの紹介画像として利用できます。例としては、この記事の URL を oEmbeds を表示するプラットフォーム (例: Twitter, WhatsApp, Telegram など) にコピーペーストどのように表示されるかをご覧ください。 From f81f55ba9461efee4e0fcf0ba685db68058cd098 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Wed, 20 Mar 2024 11:06:49 +0900 Subject: [PATCH 03/43] translate: samples/multiple-authors into japanese --- .../content/samples/multiple-authors/index.ja.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 exampleSite/content/samples/multiple-authors/index.ja.md diff --git a/exampleSite/content/samples/multiple-authors/index.ja.md b/exampleSite/content/samples/multiple-authors/index.ja.md new file mode 100644 index 00000000..1da1d36b --- /dev/null +++ b/exampleSite/content/samples/multiple-authors/index.ja.md @@ -0,0 +1,15 @@ +--- +title: "複数人の著者" +date: 2022-10-12 +draft: false +description: "複数人の著者の設定方法のサンプル" +tags: ["authors", "sample"] +summary: "複数人の著者の利用方法の簡単な例。" +showAuthor: false +authors: + - "nunocoracao" + - "secondauthor" +type: 'sample' +--- + +これは、著者が複数人の記事がどのように見えるかの例です。 \ No newline at end of file From 4a58dae0a49daac9855aa15b9ea2aef205c368d8 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Thu, 21 Mar 2024 00:24:21 +0900 Subject: [PATCH 04/43] translate: samples into japanese --- exampleSite/content/samples/_index.ja.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100755 exampleSite/content/samples/_index.ja.md diff --git a/exampleSite/content/samples/_index.ja.md b/exampleSite/content/samples/_index.ja.md new file mode 100755 index 00000000..20e89fb8 --- /dev/null +++ b/exampleSite/content/samples/_index.ja.md @@ -0,0 +1,19 @@ +--- +title: "サンプル" +description: "Blowfish で何ができるのか閲覧する。" + +cascade: + showEdit: false + showSummary: false + hideFeatureImage: true +--- + +{{< lead >}} +Blowfish はあなたのコンテンツに命を宿します。:heart_eyes: +{{< /lead >}} + +このセクションは、 Blowfish で様々な種類のコンテンツをどのように表示するのかを紹介するデモページを含みます。例としては[分類一覧]({{< ref "tags" >}})ページも参考になります。 + +_**サイドノート:** このページは一般的な Blowfish のリストで、 Hugo が生成した `samples` コンテンツタイプと記事の要約を表示する様に設定しています。_ + +--- From 11463f399268102ce907b9f8272da5e8a7fa08e0 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Thu, 21 Mar 2024 18:41:33 +0900 Subject: [PATCH 05/43] change: space --- exampleSite/content/_index.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exampleSite/content/_index.ja.md b/exampleSite/content/_index.ja.md index 0a056721..e70f3ca7 100755 --- a/exampleSite/content/_index.ja.md +++ b/exampleSite/content/_index.ja.md @@ -14,7 +14,7 @@ description: "このページは Hugo の Blowfish テーマを利用して構 id="switch-layout-button" class="px-4 !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700" > - レイアウトを変更する ↻ + レイアウトを変更する↻ From 12f6b5b77caa6f55c2770efa43359078c429a072 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Thu, 21 Mar 2024 20:14:38 +0900 Subject: [PATCH 06/43] translate: samples/emoji into japanese --- exampleSite/content/samples/emoji/index.ja.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100755 exampleSite/content/samples/emoji/index.ja.md diff --git a/exampleSite/content/samples/emoji/index.ja.md b/exampleSite/content/samples/emoji/index.ja.md new file mode 100755 index 00000000..a8d91e72 --- /dev/null +++ b/exampleSite/content/samples/emoji/index.ja.md @@ -0,0 +1,20 @@ +--- +title: "絵文字 :parachute:" +date: 2019-03-05 +description: "Blowfihs での絵文字の利用方法についてのガイド" +summary: "📖🏞️🧗🏽🐉🧙🏽‍♂️🧚🏽👸" +tags: ["emoji", "sample"] +type: 'sample' +--- + +絵文字は Blowfish を通してデフォルトでサポートされています。絵文字はタイトル、メニューアイテム、そして記事のコンテンツで利用可能です。 + +{{< alert >}} +**ノート:** これらの図形のレンダリングはブラウザとプラットフォームに依存します。絵文字をスタイルするには、サードパーティ製の絵文字フォントを利用するか、フォントスタックを利用します。 +{{< /alert >}} + +絵文字の置換は Blowfish 全体を通して自動的に行われるため、コンテンツや表で省略符号を利用しても、ビルド時に対応する記号に変換されます。 + +**例:** `see_no_evil` :see_no_evil:, `hear_no_evil` :hear_no_evil:, `speak_no_evil` :speak_no_evil: + +[絵文字チートシート](http://www.emoji-cheat-sheet.com/)は絵文字ショートハンドコードのための便利な参照ページです。 From 811a9b5c1c42d97c515d613b2258205ad10ca70d Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Thu, 21 Mar 2024 20:41:13 +0900 Subject: [PATCH 07/43] translate: samples/external into japanese --- exampleSite/content/samples/external/index.ja.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100755 exampleSite/content/samples/external/index.ja.md diff --git a/exampleSite/content/samples/external/index.ja.md b/exampleSite/content/samples/external/index.ja.md new file mode 100755 index 00000000..f71363ed --- /dev/null +++ b/exampleSite/content/samples/external/index.ja.md @@ -0,0 +1,15 @@ +--- +title: "外部の記事" +date: 2019-01-24 +externalUrl: "https://nunocoracao.com/projects/" +summary: "`externalUrl` 表示は任意の URL にリンクすることができます。" +showReadingTime: true +_build: + render: "false" + list: "local" +type: 'sample' +--- + +このページは、 `externalUrl` 表示パラメータを利用して、この Hugo ウェブサイト外の記事とリンクしています。 + +Medium の当校へのリンクや、サードパーティのウェブサイトでホストしている研究論文へのリンクなどに最適です。 From c3a6c2ca27395ea9be6bededf509dd75cf2e6a36 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Fri, 22 Mar 2024 12:29:44 +0900 Subject: [PATCH 08/43] tanslate: samples/rich-content into japanese --- .../content/samples/rich-content/index.ja.md | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100755 exampleSite/content/samples/rich-content/index.ja.md diff --git a/exampleSite/content/samples/rich-content/index.ja.md b/exampleSite/content/samples/rich-content/index.ja.md new file mode 100755 index 00000000..6192786a --- /dev/null +++ b/exampleSite/content/samples/rich-content/index.ja.md @@ -0,0 +1,36 @@ +--- +title: "リッチコンテンツ" +date: 2019-03-10 +description: "Hugo ショートコードの簡単な説明" +summary: "This is an _example_ of a **rich** content summary." +tags: ["shortcodes", "privacy", "sample", "gist", "twitter", "youtube", "vimeo"] +type: 'sample' +--- + +Hugo ships with several [built-in shortcodes](https://gohugo.io/content-management/shortcodes/#use-hugos-built-in-shortcodes) for rich content, along with a [privacy config](https://gohugo.io/about/hugo-and-gdpr/) and a set of _simple shortcodes_ that enable static and no-JS versions of various social media embeds. + +## YouTube + +下記のものは `youtube` ショートコードの組み込みを利用した例です。 + +{{< youtube ZJthWmvUzzc >}} + +## Twitter + +この例はツイートを `twitter_simple` ショートコードを利用して出力しています。こちらは `user` と `id` の二つのパラメータを必須としています。 + +{{< twitter_simple user="DesignReviewed" id="1085870671291310081" >}} + +代わりとして、 `tweet` ショートコードが完全にマークアップされた Twitter カードの埋め込みに利用できます、 + +## Gist + +`gist` ショートコードは GitHub Gist の埋め込みに利用できます。こちらは Gist のユーザー名と ID の二つのパラメータを必須としています。 + +{{< gist nunocoracao 2779792841f7ffa7c7e62dc4d38626d4 >}} + +## Vimeo + +`vimeo_simple` ショートコードは Vimeo 動画を埋め込むことができます。 + +{{< vimeo_simple 48912912 >}} From 22b51a2275f612129854366a58503f26cb7e7f66 Mon Sep 17 00:00:00 2001 From: Lemon73-Computing Date: Fri, 22 Mar 2024 12:48:20 +0900 Subject: [PATCH 09/43] translate: samples/markdown into japanese --- .../content/samples/markdown/index.ja.md | 146 ++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100755 exampleSite/content/samples/markdown/index.ja.md diff --git a/exampleSite/content/samples/markdown/index.ja.md b/exampleSite/content/samples/markdown/index.ja.md new file mode 100755 index 00000000..a1006832 --- /dev/null +++ b/exampleSite/content/samples/markdown/index.ja.md @@ -0,0 +1,146 @@ +--- +title: "Markdown" +date: 2019-03-11 +description: "基本的な Markdown 構文と HTML 要素のフォーマットを紹介するサンプル記事です。" +tags: ["markdown", "css", "html", "sample"] +type: 'sample' +--- + +この記事は Blowfish を利用した基本的な Markdown フォーマットのサンプルを提供し、また基本的な HTML 要素がどのように装飾できるのかを示しています。 + + + +## 見出し + +こちらは HTML の `

`—`

` 要素に相当する6種類の見出しを使用できます。 `

` が最大の見出しで、 `

` に近づくほど小さくなっていきます。 + +# H1 + +## H2 + +### H3 + +#### H4 + +##### H5 + +###### H6 + +## 段落 + +Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat. + +Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat. + +## ブロック引用 + +ブロック引用要素は、他の情報元から引用された内容を表します。 `footer` または `cite` 要素を使った引用や、注釈や省略形などの変更を伴うことも可能です。 + +### 出典なしのブロック引用 + +> Tiam, ad mint andaepu dandae nostion secatur sequo quae. +> **ノート** ブロック構文では、 _Markdown 構文_ を利用可能です。 + +### 出典ありのブロック引用 + +> Don't communicate by sharing memory, share memory by communicating.
+> — Rob Pike[^1] + +[^1]: 上記の引用は、2015年11月18日に開催された Gopherfest での Rob Pike’s の [`講演`](https://www.youtube.com/watch?v=PAAkCSZUG1c) からの抜粋です。 + +## テーブル + +テーブルは Markdown の仕様には含まれていません。しかし Hugp はテーブルをすぐに利用できるようサポートしています。 + +| 名前 | 年齢 | +| ----- | ---- | +| Bob | 27 | +| Alice | 23 | + +### テーブルないのインライン Markdown + +| 斜体 | 太字 | コード | +| ------ | -------- | -------- | +| _斜体_ | **太字** | `コード` | + +## コードブロック + +### バックチックによるコードブロック + +```html + + + + + HTML5 資料の例 + + +

テスト

+ + +``` + +### 4スペースのインデントによるコードブロック + + + + + + HTML5 資料の例 + + +

テスト

+ + + +### Hugo 内のショートコード・ハイライトを利用したコードブロック + +{{< highlight html "linenos=table,hl_lines=4 7-9" >}} + + + + + + HTML5 資料の例 + + +

テスト

+ + +{{< /highlight >}} + +## リスト形式 + +### 順序のあるリスト + +1. 1つ目のアイテム +2. 2つ目のアイテム +3. 3つ目のアイテム + +### 順序がないリスト + +- リストアイテム +- 他のアイテム +- 他のアイテム + +### 入れ子型リスト + +- 果実 + - りんご + - オレンジ + - バナナ +- 乳製品 + - 牛乳 + - チーズ + +## その他の要素 — abbr, sub, sup, kbd, mark + +GIF はビットマップ画像フォーマットです。 + +H2O + +Xn + Yn = Zn + +CTRL+ALT+Deleteを押すことでセッションを終了出来ます。 + +多くのサラマンダーは夜行性で、昆虫やミミズ、その他の生物を狩ります。 \ No newline at end of file From b90b91649321cdce626fb059a34d6b3a4cb59756 Mon Sep 17 00:00:00 2001 From: samsepi0l Date: Fri, 22 Mar 2024 12:16:30 +0100 Subject: [PATCH 10/43] Add player parameters https://github.com/paulirish/lite-youtube-embed?tab=readme-ov-file#custom-player-parameters --- layouts/shortcodes/youtubeLite.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/layouts/shortcodes/youtubeLite.html b/layouts/shortcodes/youtubeLite.html index 398f9f79..4375eb38 100644 --- a/layouts/shortcodes/youtubeLite.html +++ b/layouts/shortcodes/youtubeLite.html @@ -1,4 +1,5 @@ {{- $id := .Get "id" | default "SgXhGb-7QbU" -}} {{- $label := .Get "id" | default "Blowfish" -}} +{{- $params := .Get "params" -}} - + From cbbdbcf1a9c97a6f6a97c4b1f23931b7a1e0f72a Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Fri, 22 Mar 2024 15:43:43 +0100 Subject: [PATCH 11/43] First translation IT Working.... --- .../content/docs/installation/index.it.md | 57 ++++++++++--------- 1 file changed, 29 insertions(+), 28 deletions(-) diff --git a/exampleSite/content/docs/installation/index.it.md b/exampleSite/content/docs/installation/index.it.md index fd367e8b..fd3c41ee 100644 --- a/exampleSite/content/docs/installation/index.it.md +++ b/exampleSite/content/docs/installation/index.it.md @@ -1,77 +1,78 @@ --- -title: "Installation" +title: "Installazione" date: 2020-08-16 draft: false -description: "How to install the Blowfish theme." +description: "Come installare il tema Blowfish." slug: "installation" -tags: ["installation", "docs"] -series: ["Documentation"] +tags: ["installazione", "documenti"] +series: ["Documentazione"] series_order: 2 --- -Simply follow the standard Hugo [Quick Start](https://gohugo.io/getting-started/quick-start/) procedure to get up and running quickly. +Segui semplicemente la procedura standard [Avvio Rapido](https://gohugo.io/getting-started/quick-start/) di Hugo per iniziare subito. -Detailed installation instructions can be found below. Instructions for [updating the theme](#installing-updates) are also available. +Sono riportate le istruzioni dettagliate per l'installazione. Sono disponibili anche le istruzioni per [aggiornare il tema](#installazione-aggiornamenti). -## Installation +## Installazione These instructions will get you up and running using Hugo and Blowfish from a completely blank state. Most of the dependencies mentioned in this guide can be installed using the package manager of choice for your platform. -### Install Hugo +Queste istruzioni ti consentiranno di iniziare a utilizzare Hugo e Blowfish partendo da uno stato completamente vuoto. La maggior parte delle dipendenze menzionate in questa guida possono essere installate utilizzando il gestore pacchetti corretti per la tua piattaforma. -If you haven't used Hugo before, you will need to [install it onto your local machine](https://gohugo.io/getting-started/installing). You can check if it's already installed by running the command `hugo version`. +### Installare Hugo + +Se non hai mai utilizzato Hugo prima, dovrai [installarlo nella tua local machine] (https://gohugo.io/getting-started/installing). +Puoi verificare se hai già installato Hugo utilizzando il comando `hugo version`. {{< alert >}} -Make sure you are using **Hugo version 0.87.0** or later as the theme takes advantage of some of the latest Hugo features. +Assicurati di usare la **versione 0.87.0 di Hugo** o successiva, poiché il tema sfrutta alcune delle ultime caratteristiche di Hugo. {{< /alert >}} -You can find detailed installation instructions for your platform in the [Hugo docs](https://gohugo.io/getting-started/installing). +Puoi trovare le istruzioni dettagliate sull'installazione per la propria piattaforma in [Documenti Hugo](https://gohugo.io/getting-started/installing). -### Blowfish Tools (recommended) +### Strumenti Blowfish (raccomandato) -We just launched a new CLI tool to help you get started with Blowfish. It will create a new Hugo project, install the theme and set up the theme configuration files for you. It's still in beta so please [report any issues you find](https://github.com/nunocoracao/blowfish-tools). +Abbiamo appena lanciato un nuovo strumento CLI per aiutarti a iniziare con Blowfish. Questo ti permette di creare un nuovo progetto Hugo, di installare il tema e di impostare i file di configurazione del tema per te. È ancora in fase beta, quindi per favore [segnala qualsiasi problema che riscontri] (https://github.com/nunocoracao/blowfish-tools). -Install the CLI tool globally using npm (or other package manager): +Installa globalmente lo strumento CLI usando npm (o altri gestori di pacchetti): ```shell npx blowfish-tools ``` -or +oppure ```shell npm i -g blowfish-tools ``` -Then run the command `blowfish-tools` to start an interactive run which will guide you through creation and configuration use-cases. +Poi esegui il comando `blowfish-tools` per avviare un'esecuzione interattiva che ti guiderà attraverso la creazione e la configurazione dei casi d'uso. ```shell blowfish-tools ``` - -You can also run the command `blowfish-tools new` to create a new Hugo project and install the theme in one go. Check the CLI help for more information. +È anche possibile eseguire il comando `blowfish-tools new` per creare un nuovo progetto Hugo e installare il tema in una sola volta. Per ulteriori informazioni, consulta la guida del CLI. ```shell blowfish-tools new mynewsite ``` - -Here's a quick video of how fast it is to get started with Blowfish using the CLI tool: +Ecco un rapido video che ti mostra quanto sia veloce iniziare a utilizzare Blowfish con lo strumento CLI: -### Install Manually +### Installazione Manuale -#### Create a new site +#### Crea un novo sito -Run the command `hugo new site mywebsite` to create a new Hugo site in a directory named `mywebsite`. +Esegui il comando `hugo new site mywebsite` per creare un nuovo sito di Hugo in una cartella chiamata `mywebsite`. -Note that you can name the project directory whatever you choose, but the instructions below will assume it's named `mywebsite`. If you use a different name, be sure to substitute it accordingly. +La cartella del progetto può essere chiamata come si vuole, ma le istruzioni che seguono presuppongono che si chiami `mywebsite`. Se si usa un nome diverso, sostituiscilo di conseguenza. -#### Download the Blowfish theme +#### Scaricare il tema Blowfish -There several different ways to install the Blowfish theme into your Hugo website. From easiest to most difficult to install and maintain, they are: +Esistono diversi modi per installare il tema Blowfish nel proprio sito web Hugo. Dal più facile al più difficile da installare e mantenere, sono: - [Git submodule](#install-using-git) (recommended) - [Hugo module](#install-using-hugo) -- [Manual file copy](#install-manually) +- [Copia manuale dei file](#install-manually) -If you're unsure, choose the Git submodule method. +Se non sei sicuro, scegli il metodo Git submodule. ##### Install using git From e50e276f36c1c6a91222837d81371d8eaba82317 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Fri, 22 Mar 2024 22:12:34 +0100 Subject: [PATCH 12/43] Update index.it.md Install Update more text inside installation files --- exampleSite/content/docs/installation/index.it.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/exampleSite/content/docs/installation/index.it.md b/exampleSite/content/docs/installation/index.it.md index fd3c41ee..d39be2b4 100644 --- a/exampleSite/content/docs/installation/index.it.md +++ b/exampleSite/content/docs/installation/index.it.md @@ -15,8 +15,6 @@ Sono riportate le istruzioni dettagliate per l'installazione. Sono disponibili a ## Installazione -These instructions will get you up and running using Hugo and Blowfish from a completely blank state. Most of the dependencies mentioned in this guide can be installed using the package manager of choice for your platform. - Queste istruzioni ti consentiranno di iniziare a utilizzare Hugo e Blowfish partendo da uno stato completamente vuoto. La maggior parte delle dipendenze menzionate in questa guida possono essere installate utilizzando il gestore pacchetti corretti per la tua piattaforma. ### Installare Hugo @@ -74,11 +72,11 @@ Esistono diversi modi per installare il tema Blowfish nel proprio sito web Hugo. Se non sei sicuro, scegli il metodo Git submodule. -##### Install using git +##### Installazione usando Git -This method is the quickest and easiest for keeping the theme up-to-date. Besides **Hugo** and **Go**, you'll also need to ensure you have **Git** installed on your local machine. +Questo è il metodo piu facile e veloce per mantere il tema aggiornato. Oltre **Hugo** e **Go**, dovrai assicurarti di avere **Git** installato nel tuo local machine. -Change into the directory for your Hugo website (that you created above), initialise a new `git` repository and add Blowfish as a submodule. +cambia la directory del tuo sito web Hugo (che hai creato sopra), inizializza un nuovo repository `git` e aggiungi Blowfish come sottomodulo. ```bash cd mywebsite @@ -86,9 +84,9 @@ git init git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish ``` -Then continue to [set up the theme configuration files](#set-up-theme-configuration-files). +poi continua a [impostare i file di configurazione del tema](#set-up-theme-configuration-files). -##### Install using Hugo +##### Installazione usando Hugo For this method you'll use Hugo to manage your themes. Hugo uses **Go** to initialise and manage modules so you need to ensure you have `go` installed before proceeding. From a751c97dd9beb7217ef6540e9bb2826f52de1dc3 Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Sat, 23 Mar 2024 23:47:40 +0100 Subject: [PATCH 13/43] Update index.it.md installation Modify more content --- exampleSite/content/docs/installation/index.it.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/exampleSite/content/docs/installation/index.it.md b/exampleSite/content/docs/installation/index.it.md index d39be2b4..da4f737b 100644 --- a/exampleSite/content/docs/installation/index.it.md +++ b/exampleSite/content/docs/installation/index.it.md @@ -88,12 +88,12 @@ poi continua a [impostare i file di configurazione del tema](#set-up-theme-confi ##### Installazione usando Hugo -For this method you'll use Hugo to manage your themes. Hugo uses **Go** to initialise and manage modules so you need to ensure you have `go` installed before proceeding. +Per questo metodo utilizzerai Hugo per gestire i tuoi temi. Hugo utilizza **Go** per inizializzare e gestire i moduli, quindi assicurati di aver installato `go` prima di procedere. -1. [Download](https://golang.org/dl/) and install Go. You can check if it's already installed by using the command `go version`. +1. [Scarica](https://golang.org/dl/) e installa Go. Puoi verificare se l'hai già installato utilizzando il comando `go version`. {{< alert >}} - Make sure you are using **Go version 1.12** or later as Hugo requires this for modules to work correctly. + Assicurati di usare la **versione Go 1.12** o successive poiché Hugo lo richiede affinché i moduli funzionino correttamente. {{< /alert >}} 2. From your Hugo project directory (that you created above), initialise modules for your website: From 4df9af06ad8c5af6002ac96c0b48522e53bbad4a Mon Sep 17 00:00:00 2001 From: BabaRagnarok <123167756+BabaRagnarok@users.noreply.github.com> Date: Tue, 26 Mar 2024 16:58:11 +0100 Subject: [PATCH 14/43] Update index.it.md more translation --- .../content/docs/installation/index.it.md | 36 ++++++++++--------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/exampleSite/content/docs/installation/index.it.md b/exampleSite/content/docs/installation/index.it.md index da4f737b..37c40994 100644 --- a/exampleSite/content/docs/installation/index.it.md +++ b/exampleSite/content/docs/installation/index.it.md @@ -96,44 +96,46 @@ Per questo metodo utilizzerai Hugo per gestire i tuoi temi. Hugo utilizza **Go** Assicurati di usare la **versione Go 1.12** o successive poiché Hugo lo richiede affinché i moduli funzionino correttamente. {{< /alert >}} -2. From your Hugo project directory (that you created above), initialise modules for your website: +2. Dalla directory del tuo progetto Hugo (che hai creato sopra), inizializza i moduli per il tuo sito web: ```shell - # If you're managing your project on GitHub - hugo mod init github.com// + # Se gestisci il tuo progetto su GitHub + Hugo mod init github.com// - # If you're managing your project locally - hugo mod init my-project + # Se gestisci il tuo progetto localmente + Hugo mod init my-project ``` -3. Add the theme to your configuration by creating a new file `config/_default/module.toml` and adding the following: +3. Aggiungi il tema alla tua configurazione creando un nuovo file `config/_default/module.toml` e aggiungendo quanto segue: ```toml [[imports]] path = "github.com/nunocoracao/blowfish/v2" ``` -4. Start your server using `hugo server` and the theme will be downloaded automatically. -5. Continue to [set up the theme configuration files](#set-up-theme-configuration-files). +4. Avvia il tuo server utilizzando `hugo server` e il tema verrà scaricato automaticamente. +5. Continua con [impostare i file di configurazione del tema](#set-up-theme-configuration-files). -##### Install manually +##### Installazione manuale +1. Scarica l'ultima versione del codice sorgente del tema. -1. Download the latest release of the theme source code. + {{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Scarica da Github{{< /button >}} - {{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Download from Github{{< /button >}} + "blowfish" e "themes/" +2. Estrai l'archivio, rinomina la cartella in `blowfish` spostala nella directory `themes/` all'interno della cartella principale del tuo progetto Hugo. +3. Continua con [impostare i file di configurazione del tema](#set-up-theme-configuration-files). -2. Extract the archive, rename the folder to `blowfish` and move it to the `themes/` directory inside your Hugo project's root folder. -3. Continue to [set up the theme configuration files](#set-up-theme-configuration-files). +#### Imposta i file di configurazione del tema -#### Set up theme configuration files +Nella cartella principale del tuo sito web, elimina il file `config.toml` generato da Hugo. Copia i file di configurazione `*.toml` dal tema nella tua cartella `config/_default/`. Ciò ti garantirà di avere tutte le impostazioni corrette del tema e ti consentirà di personalizzare facilmente il tema in base alle tue esigenze. -In the root folder of your website, delete the `config.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder. This will ensure you have all the correct theme settings and will enable you to easily customise the theme to your needs. +Nella cartella principale del tuo sito web, elimina il file `config.toml` generato da Hugo. Copia i file di configurazione `*.toml` dal tema della tua cartella `config/_default/` folder. Ti garantirà di avere tutte le impostazioni corrette del tema e ti consentirà di personalizzare facilmente il tema in base alle tue esigenze. {{< alert >}} -**Note:** You should not overwrite the `module.toml` file if one already exists in your project! +**Note:** Non dovresti sovrascrivere il file `module.toml` se ne esiste già uno nel tuo progetto! {{< /alert >}} -Depending on how you installed the theme you will find the theme config files in different places: +A seconda di come hai installato il tema, troverai i file di configurazione del tema in posti diversi: - **Hugo Modules:** In the Hugo cache directory, or [download a copy](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/nunocoracao/blowfish/tree/main/config/_default) from GitHub - **Git submodule or Manual install:** `themes/blowfish/config/_default` From 2abca494c03dd2a9dd1eb1df82c40ecf155d7ab1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nuno=20Cora=C3=A7=C3=A3o?= Date: Tue, 26 Mar 2024 22:31:49 +0000 Subject: [PATCH 15/43] bump version --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index d2bc9170..fcd600ff 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "hugo-blowfish-theme", - "version": "2.63.0", + "version": "2.64.0", "description": "Blowfish theme for Hugo", "scripts": { "postinstall": "vendor-copy", From d4a45eb95181aef3853ab13f9a85da4e8206c3ff Mon Sep 17 00:00:00 2001 From: Weaxs <459312872@qq.com> Date: Wed, 27 Mar 2024 11:49:17 +0800 Subject: [PATCH 16/43] add umami docs --- .../content/docs/configuration/index.it.md | 7 ++ .../content/docs/configuration/index.ja.md | 7 ++ .../content/docs/configuration/index.md | 8 ++ .../content/docs/configuration/index.zh-cn.md | 14 +++- exampleSite/content/docs/partials/index.it.md | 13 +++ exampleSite/content/docs/partials/index.ja.md | 13 +++ exampleSite/content/docs/partials/index.md | 15 +++- .../content/docs/partials/index.zh-cn.md | 79 +++++++++++-------- layouts/partials/analytics/umami.html | 2 +- 9 files changed, 121 insertions(+), 37 deletions(-) diff --git a/exampleSite/content/docs/configuration/index.it.md b/exampleSite/content/docs/configuration/index.it.md index 0abe430a..1ab50b58 100644 --- a/exampleSite/content/docs/configuration/index.it.md +++ b/exampleSite/content/docs/configuration/index.it.md @@ -313,6 +313,13 @@ Many of the article defaults here can be overridden on a per article basis by sp | `fathomAnalytics.site` | _Not set_ | The site code generated by Fathom Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | | `fathomAnalytics.domain` | _Not set_ | If using a custom domain with Fathom Analytics, provide it here to serve `script.js` from the custom domain. | +### Umami Analytics + +| Name | Default | Description | +| ------------------------ | --------- |-----------------------------------------------------------------------------------------------------------------------------------------------| +| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | +| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. | + ### BuyMeACoffee | Name | Default | Description | diff --git a/exampleSite/content/docs/configuration/index.ja.md b/exampleSite/content/docs/configuration/index.ja.md index 0abe430a..1ab50b58 100644 --- a/exampleSite/content/docs/configuration/index.ja.md +++ b/exampleSite/content/docs/configuration/index.ja.md @@ -313,6 +313,13 @@ Many of the article defaults here can be overridden on a per article basis by sp | `fathomAnalytics.site` | _Not set_ | The site code generated by Fathom Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | | `fathomAnalytics.domain` | _Not set_ | If using a custom domain with Fathom Analytics, provide it here to serve `script.js` from the custom domain. | +### Umami Analytics + +| Name | Default | Description | +| ------------------------ | --------- |-----------------------------------------------------------------------------------------------------------------------------------------------| +| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | +| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. | + ### BuyMeACoffee | Name | Default | Description | diff --git a/exampleSite/content/docs/configuration/index.md b/exampleSite/content/docs/configuration/index.md index 0abe430a..52a8ce10 100644 --- a/exampleSite/content/docs/configuration/index.md +++ b/exampleSite/content/docs/configuration/index.md @@ -313,6 +313,14 @@ Many of the article defaults here can be overridden on a per article basis by sp | `fathomAnalytics.site` | _Not set_ | The site code generated by Fathom Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | | `fathomAnalytics.domain` | _Not set_ | If using a custom domain with Fathom Analytics, provide it here to serve `script.js` from the custom domain. | +### Umami Analytics + +| Name | Default | Description | +| ------------------------ | --------- |-----------------------------------------------------------------------------------------------------------------------------------------------| +| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | +| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. | + + ### BuyMeACoffee | Name | Default | Description | diff --git a/exampleSite/content/docs/configuration/index.zh-cn.md b/exampleSite/content/docs/configuration/index.zh-cn.md index e80b6b76..d854134e 100644 --- a/exampleSite/content/docs/configuration/index.zh-cn.md +++ b/exampleSite/content/docs/configuration/index.zh-cn.md @@ -313,10 +313,18 @@ Blowfish 提供了大量控制主题功能的配置参数，下面的表格中 ### Fathom Analytics -| 名称 | 默认值 | 描述 | -| ------------------------ | --------- |----------------------------------------------------------------------| +| 名称 | 默认值 | 描述 | +| ------------------------ | --------- |---------------------------------------------------------------------| | `fathomAnalytics.site` | 无 | 支持 Fathom 站点分析平台。更多详细内容请参考 [分析文档]({{< ref "partials#analytics" >}})。 | -| `fathomAnalytics.domain` | 无 | 如果使用自定义域名的 Fathom Analytics，请在此提供，以便从自定义域名获取 `script.js`】。 | +| `fathomAnalytics.domain` | 无 | 如果使用自定义域名的 Fathom Analytics，请在此提供，以便从自定义域名获取 `script.js`。 | + +### Umami Analytics + +| Name | Default | Description | +| ------------------------ | --------- |-------------------------------------------------------------------------------------------------------------| +| `umamiAnalytics.websiteid` | _Not set_ | 支持 Umami 站点分析平台。更多详细内容请参考 [分析文档]({{< ref "partials#analytics" >}})。 | +| `umamiAnalytics.domain` | _Not set_ | 如果使用自定义域名的 Umami Analytics，请在此提供，以便从自定义域名获取 `script.js`。 | + ### BuyMeACoffee diff --git a/exampleSite/content/docs/partials/index.it.md b/exampleSite/content/docs/partials/index.it.md index 4af2a536..66b6f8ba 100644 --- a/exampleSite/content/docs/partials/index.it.md +++ b/exampleSite/content/docs/partials/index.it.md @@ -40,6 +40,19 @@ googleAnalytics = "UA-PROPERTY_ID" googleAnalytics = "G-MEASUREMENT_ID" ``` +### Umami Analytics + +To enable Umami Analytics support, simply provide your [Umami tracking code](https://umami.is/docs/collect-data) in the `config/_default/params.toml` file. +If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is). + +```toml +# config/_default/params.toml + +[umamiAnalytics] + websiteid = "ABC12345" + domain = "llama.yoursite.com" +``` + ### Custom analytics providers If you wish to use a different analytics provider on your website you can also override the analytics partial and provide your own script. Simply create the file `layouts/partials/extend-head.html` in your project and it will automatically include it in the `` of the website. diff --git a/exampleSite/content/docs/partials/index.ja.md b/exampleSite/content/docs/partials/index.ja.md index 4af2a536..66b6f8ba 100644 --- a/exampleSite/content/docs/partials/index.ja.md +++ b/exampleSite/content/docs/partials/index.ja.md @@ -40,6 +40,19 @@ googleAnalytics = "UA-PROPERTY_ID" googleAnalytics = "G-MEASUREMENT_ID" ``` +### Umami Analytics + +To enable Umami Analytics support, simply provide your [Umami tracking code](https://umami.is/docs/collect-data) in the `config/_default/params.toml` file. +If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is). + +```toml +# config/_default/params.toml + +[umamiAnalytics] + websiteid = "ABC12345" + domain = "llama.yoursite.com" +``` + ### Custom analytics providers If you wish to use a different analytics provider on your website you can also override the analytics partial and provide your own script. Simply create the file `layouts/partials/extend-head.html` in your project and it will automatically include it in the `` of the website. diff --git a/exampleSite/content/docs/partials/index.md b/exampleSite/content/docs/partials/index.md index 4af2a536..43fe8d9f 100644 --- a/exampleSite/content/docs/partials/index.md +++ b/exampleSite/content/docs/partials/index.md @@ -11,7 +11,7 @@ series_order: 9 ## Analytics -Blowfish provides built-in support for Fathom Analytics and Google Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy. +Blowfish provides built-in support for Fathom Analytics, Google Analytics annd Umami Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy. ### Fathom Analytics @@ -40,6 +40,19 @@ googleAnalytics = "UA-PROPERTY_ID" googleAnalytics = "G-MEASUREMENT_ID" ``` +### Umami Analytics + +To enable Umami Analytics support, simply provide your [Umami tracking code](https://umami.is/docs/collect-data) in the `config/_default/params.toml` file. +If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is). + +```toml +# config/_default/params.toml + +[umamiAnalytics] + websiteid = "ABC12345" + domain = "llama.yoursite.com" +``` + ### Custom analytics providers If you wish to use a different analytics provider on your website you can also override the analytics partial and provide your own script. Simply create the file `layouts/partials/extend-head.html` in your project and it will automatically include it in the `` of the website. diff --git a/exampleSite/content/docs/partials/index.zh-cn.md b/exampleSite/content/docs/partials/index.zh-cn.md index 0f5c3f0c..73265d92 100644 --- a/exampleSite/content/docs/partials/index.zh-cn.md +++ b/exampleSite/content/docs/partials/index.zh-cn.md @@ -9,13 +9,14 @@ series: ["部署教程"] series_order: 9 --- -## Analytics +## 站点分析 -Blowfish provides built-in support for Fathom Analytics and Google Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy. +Blowfish 支持了 Fathom、Google 和 Umami。Fathom 和 Umami 都是开源、简单、且注重隐私的站点分析服务，他们可以很好地替代 Google 分析。Fathom 和 Umami 都有公有云的付费版本，当然你也可以自己手动部署开源版。 -### Fathom Analytics +### Fathom -To enable Fathom Analytics support, simply provide your Fathom site code in the `config/_default/params.toml` file. If you also use the custom domain feature of Fathom and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Fathom DNS. +只需要在 `config/_default/params.toml` 文件提供你的 Fathom 站点代码，就可以快速支持 Fathom 站点分析。 +如果你想使用自定义域名来获取跟踪脚本， 那么需要提供 `domain` 参数，否则会从 Fathom 云服务版的地址 (cdn.usefathom.com) 获取脚本。 ```toml # config/_default/params.toml @@ -25,38 +26,52 @@ To enable Fathom Analytics support, simply provide your Fathom site code in the domain = "llama.yoursite.com" ``` -### Google Analytics +### Google -Google Analytics support is provided through the internal Hugo partial. Simply provide the `googleAnalytics` key in the `config/_default/config.toml` file and the script will be added automatically. +Hugo partial 本身已经支持了 Google 站点分析。只需要在 `config/_default/config.toml` 文件添加 `googleAnalytics` 参数即可，跟踪脚本会自动添加。 -Both version 3 (analytics.js) and version 4 (gtag.js) are supported, based on the configuration value provided: +版本3 (analytics.js) 和版本4 (gtag.js) 都是支持的，参考如下示例： ```toml # config/_default/config.toml -# version 3 +# 版本 3 googleAnalytics = "UA-PROPERTY_ID" -# version 4 +# 版本 4 googleAnalytics = "G-MEASUREMENT_ID" ``` -### Custom analytics providers +### Umami -If you wish to use a different analytics provider on your website you can also override the analytics partial and provide your own script. Simply create the file `layouts/partials/extend-head.html` in your project and it will automatically include it in the `` of the website. +只需要在 `config/_default/params.toml` 文件提供你的 [Umami 跟踪代码](https://umami.is/docs/collect-data)，就可以快速支持 Umami 站点分析。 +如果你想使用自定义域名来获取跟踪脚本， 那么需要提供 `domain` 参数，否则会从 Umami 云服务版的地址 (analytics.umami.is) 获取脚本。 -## Comments +```toml +# config/_default/params.toml -To add comments to your articles, Blowfish includes support for a comments partial that is included at the base of each article page. Simply provide a `layouts/partials/comments.html` which contains the code required to display your chosen comments. +[umamiAnalytics] + websiteid = "ABC12345" + domain = "llama.yoursite.com" +``` -You can use either the built-in Hugo Disqus template, or provide your own custom code. Refer to the [Hugo docs](https://gohugo.io/content-management/comments/) for further information. +### 提供自定义站点分析 -Once the partial has been provided, finer control over where comments are displayed is then managed using the `showComments` parameter. This value can be set at the theme level in the `params.toml` [config file]({{< ref "configuration#theme-parameters" >}}), or on a per-article basis by including it in the [front matter]({{< ref "front-matter" >}}). The parameter defaults to `false` so it must be set to `true` in one of these locations in order for comments to be displayed. +如果你想在你的网站提供其他站点分析，你可以自己提供脚本，并覆盖 Blowfish 主题中内置的 partial。 +只需要创建 `layouts/partials/extend-head.html` 文件并在内容中提供脚本即可，Blowfish 主题会自动将 `extend-head.html` 中的内容添加到整个站点的 `` 中。 -## Favicons +## 评论 -Blowfish provides a default set of blank favicons to get started but you can provide your own assets to override them. The easiest way to obtain new favicon assets is to generate them using a third-party provider like [favicon.io](https://favicon.io). +Blowfish 支持了在每篇文章底部添加一个评论功能。只需要提供一个 `layouts/partials/comments.html` 文件，并在其中添加显示评论的代码即可。 -Icon assets should be placed directly in the `static/` folder of your website and named as per the listing below. If you use [favicon.io](https://favicon.io), these will be the filenames that are automatically generated for you, but you can provide your own assets if you wish. +你可以使用 Hugo 中内置的 Disqus 模板，也可以提供自定义代码。更多内容和细节可以参考 [Hugo 文档](https://gohugo.io/content-management/comments/). + +一旦提供了评论的 partial，你就可以使用 `showComments` 更细致地控制评论的显隐。此参数可以在 `params.toml` [配置文件]({{< ref "configuration#theme-parameters" >}}) 中全局设置，也可以在每篇文章的 [扉页参数]({{< ref "front-matter" >}}) 中单独针对特定文章设置。该参数默认为 `false`，因此需要在上面两个位置设置为 `true` 才能显示评论。 + +## 网站图标（Favicons） + +Blowfish 提供了一套空白网站图标以便快速上手，但你可以提供自己的资源来覆盖他们。想要获取新的图标资源最简单的方法是使用第三方提供商，如 [favicon.io](https://favicon.io)。 + +网站图标资源的位置在 `static/` 文件夹中，并务必按照如下的名称命名。如果你使用了[favicon.io](https://favicon.io)，那么下载下来的文件名和下面的示例完全一致；当然你也可以通过别的方式提供，记得重命名就行。 ```shell static/ @@ -69,34 +84,34 @@ static/ └─ site.webmanifest ``` -Alternatively, you can also completely override the default favicon behaviour and provide your own favicon HTML tags and assets. Simply provide a `layouts/partials/favicons.html` file in your project and this will be injected into the site `` in place of the default assets. +另外，你也可以完全覆盖 Blowfish 提供的这套网站图标逻辑，只需要在 `layouts/partials/favicons.html` 文件中，提供你自己的网站图标 HTML 和对应资源，`favicons.html`文件中的内容会自动添加到网站的 `` 中。 -## Icon +## 图标 -Similar to the [icon shortcode]({{< ref "shortcodes#icon" >}}), you can include icons in your own templates and partials by using Blowfish's `icon.html` partial. The partial takes one parameter which is the name of the icon to be included. +类似 [图标短代码]({{< ref "shortcodes#icon" >}})，Blowfish 提供了 `icon.html`，以便你在自己的模板和部分（partials）中包含图标。此 partials 只接收一个参数，即图标的名称，示例如下。 -**Example:** +**示例：** ```go {{ partial "icon.html" "github" }} ``` -Icons are populated using Hugo pipelines which makes them very flexible. Blowfish includes a number of built-in icons for social, links and other purposes. Check the [icon samples]({{< ref "samples/icons" >}}) page for a full list of supported icons. +图标会使用 Hugo 的管道进行填充，这会使它们非常灵活。Blowfish 内置了许多图标，用于社交、链接等其他目的。查看 [图标样本]({{< ref "samples/icons" >}}) 可以看到 Blowfish 内置的所有图标。 -Custom icons can be added by providing your own icon assets in the `assets/icons/` directory of your project. The icon can then be referenced in the partial by using the SVG filename without the `.svg` extension. +你也可以在 `assets/icons/` 目录中提供你自己的图标资源。在 `icon.html` 中也可以添加不是 `.svg` 后缀的图标资源。 -Icons can also be used in article content by calling the [icon shortcode]({{< ref "shortcodes#icon" >}}). +图标也可以通过[图标短代码]({{< ref "shortcodes#icon" >}})的方式使用在文章中。 -## Extensions +## 扩展 -Blowfish also provides for a number of extension partials that allow for expanding upon base functionality. +Blowfish 还提供了一些扩展部分，允许在基础功能上进行扩展。 -### Article link +### 文章链接 -If you wish to insert additional code after article links, create a `layouts/partials/extend-article-link.html` file. This is especially powerful when combined with the [`badge`]({{< ref "shortcodes#badge" >}}) shortcode which can be used to highlight metadata for certain articles. +如果你希望在文章链接中追加额外代码，可以创建 `layouts/partials/extend-article-link.html` 文件。 当与 [badge]({{< ref "shortcodes#badge" >}}) 短代码结合使用时尤其强大，可用于在链接中添加某些文章的元数据。 -### Head and Footer +### 头部和尾部 -The theme allows for inserting additional code directly into the `` and `