diff --git a/README.ja.md b/README.ja.md new file mode 100644 index 000000000..52b52a44e --- /dev/null +++ b/README.ja.md @@ -0,0 +1,179 @@ +[English](https://github.com/nunocoracao/blowfish/blob/main/README.md) | [简体中文](https://github.com/nunocoracao/blowfish/blob/main/README.zh-cn.md) | 日本語 +# Blowfish +[![Deploy Production to Firebase](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml) +[![Deploy Production to GitHub pages](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml) +[![Minimum Hugo Version](https://img.shields.io/static/v1?label=min-HUGO-version&message=0.87.0&color=blue&logo=hugo)](https://github.com/gohugoio/hugo/releases/tag/v0.87.0) +[![GitHub](https://img.shields.io/github/license/nunocoracao/blowfish)](https://github.com/nunocoracao/blowfish/blob/main/LICENSE) +[![Blowfish](https://img.shields.io/badge/Hugo--Themes-@Blowfish-blue)](https://themes.gohugo.io/themes/blowfish/) +![code-size](https://img.shields.io/github/languages/code-size/nunocoracao/blowfish) + +Blowfishは[Hugo](https://gohugo.io)のために設計された強力で軽量なテーマです。Tailwind CSS を使用し、コンテンツを優先したクリーンでミニマルなデザインでが特徴です。 + +![blowfish screenshot](https://github.com/nunocoracao/blowfish/blob/main/images/screenshot.png?raw=true) + + +🌏 [デモサイト](https://blowfish.page/) +📑 [ドキュメント](https://blowfish.page/docs/) +💎 [グッズストア](http://tee.pub/lic/qwSlWVBL5zc) +🐛 [バグ報告と問題点](https://github.com/nunocoracao/blowfish/issues) +💡 [質問と機能リクエスト](https://github.com/nunocoracao/blowfish/discussions) + + + +Buy Me A Coffee + + + + +## 機能 + +- Tailwind CSS 3.0 で構築された、完璧なレスポンシブデザイン +- 複数の配色 (または、自分で完全にカスタマイズ可能) +- ダークモード (強制オン/オフ か 自動選択・ユーザー切り替え) +- 高度なカスタマイズが可能な設定 +- Firebase 連携で動的データをサポート +- 閲覧数といいね機能 +- 関連記事 +- 複数のホームページレイアウト +- 複数人の著者 +- シリーズ記事 +- 日付と価値付けによる記事の並べ替え +- 記事を読むための Zen モード +- あらゆるコンテンツタイプ、分類、メニューに柔軟に対応 +- ヘッダー/フッターメニュー +- 階層化されたメニューとサブナビゲーションメニュー +- スクロール可能な目次 +- RTL 言語を含む多言語コンテンツのサポート +- サードパーティー ウェブサイトの投稿へのリンク +- ギャラリー、タイムライン、GitHub カード、カルーセルなど、複数のショートコードに対応 +- Buy Me a Coffee 連携 +- Fuse.js を利用したクライアントサイドのサイト内検索 +- Mermaid を使用したダイアグラムや視覚化 +- Chart.js を使用したグラフ表示 +- TypeIt 連携 +- パフォーマンスを改善した YouTube 埋め込み +- KaTeX を使用した数式表現 +- FontAwesome 6 の SVG アイコン +- Hugo Pipes を使用した画像の自動リサイズ +- アンカーリンク、目次、コードコピー、ボタン、バッジなど +- 記事内での HTML と絵文字のサポート 🎉 +- ソーシャルメディアへの共有リンクを備えた SEO フレンドリーな設計 +- Fathom Analytics と Google Analytics のサポート +- RSS フィード、ファビコン、コメント機能のサポート +- Tailwind の色定義とスタイルを使った高度なカスタマイズ +- Lighthouse で満点評価を獲得したパフォーマンスとアクセシビリティの最適化 +- 充実したドキュメントと定期的なアップデート + +--- + +![blowfish logo](https://github.com/nunocoracao/blowfish/blob/main/logo.png?raw=true) + +## ドキュメント + +Blowfish には、テーマのあらゆる側面を網羅した[詳細なドキュメント](https://blowfish.page/docs/)があります。テーマの使い方や機能を詳しく知るために、必ず[ドキュメントを読んで](https://blowfish.page/docs/)ください。 + +--- + +## インストール + +Blowfish は、git サブモジュール、Hugo モジュール、または完全な手動インストールなど、いくつかのインストール方法をサポートしています。 + +各方法の詳細な手順は、[インストール](https://blowfish.page/docs/installation)ドキュメントに記載されています。最も簡単なセットアップ方法については、ドキュメントを参照してください。以下にクイックスタートガイドを示します。git を使用している場合はサブモジュール、Hugo テーマのインストールに慣れている場合は Hugo モジュールを使用するのがおすすめです。 + +### Blowfish Tools を使ったクイックスタート + +> **注意:** **Node.js**、**Git**、**Go**、**Hugo** がインストールされていること、そして先に進む前に新しい Hugo プロジェクトが作成されていることを確認してください。 + +Blowfish を使い始めるのに役立つ新しい CLI ツールをリリースしました。このツールは、新しい Hugo プロジェクトを作成し、テーマをインストールし、テーマ設定ファイルをセットアップします。まだベータ版なので、[問題を見つけたら報告してください](https://github.com/nunocoracao/blowfish-tools)。 + +npm（または他のパッケージマネージャー）を使って CLI ツールをグローバルにインストールします: +```shell +npm i -g blowfish-tools +``` + +`blowfish-tools` コマンドを実行すると、対話形式でプロジェクトの作成と設定をガイドするツールが起動します。 +```shell +blowfish-tools +``` + +`blowfish-tools new` コマンドを実行すると、新しい Hugo プロジェクトを作成し、テーマを一度にインストールすることもできます。詳細については、CLI のヘルプを参照してください。 +```shell +blowfish-tools new mynewsite +``` + +### git サブモジュールを使ったクイックスタート + +> **注意:** **Git**、**Go**、**Hugo** がインストールされていること、そして先に進む前に新しい Hugo プロジェクトが作成されていることを確認してください。 + +1. プロジェクトディレクトリで、git を初期化します。 + + ```shell + git init + ``` + +2. Blowfish を git サブモジュールとして設定します。 + + ```shell + git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish + ``` + +3. ウェブサイトのルートフォルダで、Hugo によって生成された `config.toml` ファイルを削除します。テーマから `*.toml` 設定ファイルをコピーして、`config/_default/` フォルダに保存します。 + + これらのテーマ設定ファイルは、Hugo キャッシュディレクトリにあります。または、GitHub から[コピーをダウンロード](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip)できます。 + +4. [Getting Started](https://blowfish.page/docs/getting-started/) の手順に従って、ウェブサイトを設定します。 + +### Hugo を使ったクイックスタート + +> **注意:** **Go** と **Hugo** がインストールされていること、そして先に進む前に新しい Hugo プロジェクトが作成されていることを確認してください。 + +1. プロジェクトディレクトリから、Hugo Modules を初期化します。 + + ```shell + hugo mod init github.com// + ``` + +2. `config/_default/module.toml` を作成し、以下を追加します。 + + ```toml + [[imports]] + path = "github.com/nunocoracao/blowfish/v2" + ``` + +3. `hugo server` を使用してサーバーを起動すると、テーマが自動的にダウンロードされます。 + +4. ウェブサイトのルートフォルダにある、Hugo によって生成された `config.toml` ファイルを削除します。テーマの `*.toml` 設定ファイルを `config/_default/` フォルダにコピーします。 + + > **注意:** 上記で作成した `module.toml` ファイルを上書きしないでください！ + + これらのテーマ設定ファイルは、Hugo のキャッシュディレクトリにあります。または、GitHub から[コピーをダウンロード](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip)できます。 + +5. [Getting Started](https://blowfish.page/docs/getting-started/) の手順に従って、ウェブサイトを設定します。 + +### テーマのアップデートのインストール + +新しいリリースが公開されたら、Hugo を使ってテーマをアップデートできます。プロジェクトディレクトリから `hugo mod get -u` を実行するだけで、テーマは自動的に最新リリースにアップデートされます。 + +詳細な[アップデート手順](https://blowfish.page/docs/installation/#installing-updates)はドキュメントに記載されています。 + +--- + +## 貢献 + +Blowfish は時間とともに進化していく予定です。必要に応じて機能の追加や変更を続けていく予定です。 + +問題や追加してほしい新機能の提案があれば、お気軽にご連絡ください。 + +- 🐛 **バグ報告と問題点:** [GitHub Issues](https://github.com/nunocoracao/blowfish/issues) を使用してください +- 💡 **新機能のアイデア:** [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions) でディスカッションを開始してください +- 🙋‍♀️ **一般的な質問:** [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions) へ進んでください + +バグ修正や新機能の実装ができる方は、Pull Request を歓迎します。詳しくは[貢献ガイドライン](https://github.com/nunocoracao/blowfish/blob/main/CONTRIBUTING.md)をご覧ください。 + +--- + +## スター数の推移 + +[![Stargazers over time](https://starchart.cc/nunocoracao/blowfish.svg)](https://starchart.cc/nunocoracao/blowfish) + +Mastodon diff --git a/README.md b/README.md index 6c6359fa9..235723b0b 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -English | [简体中文](https://github.com/nunocoracao/blowfish/blob/main/README.zh-cn.md) +English | [简体中文](https://github.com/nunocoracao/blowfish/blob/main/README.zh-cn.md) | [日本語](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md) # Blowfish [![Deploy Production to Firebase](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml) [![Deploy Production to GitHub pages](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml) diff --git a/README.zh-cn.md b/README.zh-cn.md index e3e5619d3..7d652481d 100644 --- a/README.zh-cn.md +++ b/README.zh-cn.md @@ -1,4 +1,4 @@ -[English](https://github.com/nunocoracao/blowfish/blob/main/README.md) | 简体中文 +[English](https://github.com/nunocoracao/blowfish/blob/main/README.md) | 简体中文 | [日本語](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md) # Blowfish [![Deploy Production to Firebase](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml) [![Deploy Production to GitHub pages](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml) diff --git a/exampleSite/config/_default/languages.ja.toml b/exampleSite/config/_default/languages.ja.toml index 599f4b187..396625bd7 100644 --- a/exampleSite/config/_default/languages.ja.toml +++ b/exampleSite/config/_default/languages.ja.toml @@ -13,10 +13,11 @@ title = "Blowfish" [params.author] name = "Blowfish" + email = "nuno@n9o.xyz" image = "img/blowfish_logo.png" headline = "強力で、軽量な Hugo のテーマです。" bio = "強力で、軽量な Hugo のテーマです。" links = [ { x-twitter = "https://twitter.com/burufugu" }, { github = "https://github.com/nunocoracao/blowfish" }, - ] + ] \ No newline at end of file diff --git a/exampleSite/config/_default/menus.ja.toml b/exampleSite/config/_default/menus.ja.toml index 930c6aa90..6d8e89e1e 100644 --- a/exampleSite/config/_default/menus.ja.toml +++ b/exampleSite/config/_default/menus.ja.toml @@ -11,7 +11,7 @@ # このメニューは weight が低い値から高い値に順に表示されます。 [[main]] - name = "資料" + name = "ドキュメント" pageRef = "docs" weight = 10 diff --git a/exampleSite/content/authors/_index.ja.md b/exampleSite/content/authors/_index.ja.md index f8134a16b..82eb7f4bf 100644 --- a/exampleSite/content/authors/_index.ja.md +++ b/exampleSite/content/authors/_index.ja.md @@ -1,5 +1,5 @@ --- -title: "著者の分類リストの例" +title: "著者のタクソノミーリストの例" --- -あなたの記事でどのように著者の分類を開始するかの簡単な例です。 +あなたの記事で著者のタクソノミーを使う方法の簡単な例です。 diff --git a/exampleSite/content/docs/_index.ja.md b/exampleSite/content/docs/_index.ja.md index 8539f03e9..d1a07ba66 100755 --- a/exampleSite/content/docs/_index.ja.md +++ b/exampleSite/content/docs/_index.ja.md @@ -1,5 +1,5 @@ --- -title: "資料" +title: "ドキュメント" description: "Blowfish の利用方法と特徴について学ぶ。" cascade: @@ -12,6 +12,6 @@ cascade: シンプル、それでいて強力。 Blowfish の利用方法と特徴について学ぶ。 {{< /lead >}} -このセクションは Blowfish について知る必要のある全てのことが含まれています。新しく作成する場合は、開始するために[インストール]({{< ref "docs/installation" >}})ガイド、または Blowfish が何が出来るか[サンプル]({{< ref "samples" >}})セクションに訪れてください。 +このセクションでは、Blowfish について知っておくべきことをすべて網羅しています。初めての方は、まず[インストール]({{< ref "docs/installation" >}})ガイドをご覧いただくか、[サンプル]({{< ref "samples" >}})セクションで Blowfish で何ができるかを確認してみてください。 --- diff --git a/exampleSite/content/docs/advanced-customisation/index.ja.md b/exampleSite/content/docs/advanced-customisation/index.ja.md index 5ea6cd251..fda2c53ed 100644 --- a/exampleSite/content/docs/advanced-customisation/index.ja.md +++ b/exampleSite/content/docs/advanced-customisation/index.ja.md @@ -1,41 +1,42 @@ --- -title: "Advanced Customisation" +title: "高度なカスタマイズ" weight: 13 draft: false -description: "Learn how to build Blowfish manually." +description: "Blowfishを手動でビルドする方法を学びましょう。" slug: "advanced-customisation" tags: ["advanced", "css", "docs"] series: ["Documentation"] series_order: 13 --- -There are many ways you can make advanced changes to Blowfish. Read below to learn more about what can be customised and the best way of achieving your desired result. +Blowfish には高度な変更を加えるための多くの方法があります。カスタマイズできる内容や、希望する結果を得るための最良の方法については、以下をご覧ください。 -If you need further advice, post your questions on [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions). +さらにアドバイスが必要な場合は、 [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions) に質問を投稿してください。 -## Hugo project structure +## Hugo プロジェクトの構造 -Before leaping into it, first a quick note about [Hugo project structure](https://gohugo.io/getting-started/directory-structure/) and best practices for managing your content and theme customisations. +始める前に、[Hugo プロジェクトの構造](https://gohugo.io/getting-started/directory-structure/)と、コンテンツとテーマのカスタマイズを管理するためのベストプラクティスについて簡単に説明します。 {{< alert >}} -**In summary:** Never directly edit the theme files. Only make customisations in your Hugo project's sub-directories, not in the themes directory itself. +**簡単に言うと:** テーマファイルを直接編集してはいけません。カスタマイズは、テーマディレクトリ自体ではなく、Hugoプロジェクトのサブディレクトリ内でのみ行います。 {{< /alert >}} -Blowfish is built to take advantage of all the standard Hugo practices. It is designed to allow all aspects of the theme to be customised and overridden without changing any of the core theme files. This allows for a seamless upgrade experience while giving you total control over the look and feel of your website. -In order to achieve this, you should never manually adjust any of the theme files directly. Whether you install using Hugo modules, as a git submodule or manually include the theme in your `themes/` directory, you should always leave these files intact. +Blowfish は、Hugo の標準的な実装をすべて活用できるように構築されています。コアのテーマファイルを変更することなく、テーマのあらゆる側面をカスタマイズしたりオーバーライドしたりできるように設計されています。これにより、ウェブサイトの見た目を完全にコントロールしながら、シームレスな改善が可能になります。 -The correct way to adjust any theme behaviour is by overriding files using Hugo's powerful [file lookup order](https://gohugo.io/templates/lookup-order/). In summary, the lookup order ensures any files you include in your project directory will automatically take precedence over any theme files. +そのために、テーマファイルを手動で直接編集するのは避けてください。Hugo モジュール、git サブモジュール、または手動でテーマを `themes/` ディレクトリに格納するなど、どのインストール方法を使用する場合でも、これらのファイルは常にそのままにしておく必要があります。 -For example, if you wanted to override the main article template in Blowfish, you can simply create your own `layouts/_default/single.html` file and place it in the root of your project. This file will then override the `single.html` from the theme without ever changing the theme itself. This works for any theme files - HTML templates, partials, shortcodes, config files, data, assets, etc. +テーマの動作を調整する正しい方法は、Hugo の強力な[ファイル優先順位](https://gohugo.io/templates/lookup-order/)を使用してファイルをオーバーライドすることです。要約すると、優先順位により、プロジェクトディレクトリに含めたファイルは、すべてのテーマファイルよりも自動的に優先されます。 -As long as you follow this simple practice, you will always be able to update the theme (or test different theme versions) without worrying that you will lose any of your custom changes. +たとえば、Blowfish のメイン記事テンプレートをオーバーライドしたい場合は、独自の `layouts/_default/single.html` ファイルを作成してプロジェクトのルートに配置するだけです。このファイルは、テーマ自体を変更することなく、テーマの `single.html` をオーバーライドします。これは、HTML テンプレート、パーシャル、ショートコード、設定ファイル、データ、アセットなど、すべてのテーマファイルで機能します。 -## Change image optimization settings +この簡単なプラクティスに従う限り、カスタム変更が失われることを心配することなく、いつでもテーマを更新したり（または異なるテーマバージョンをテストしたり）することができます。 -Hugo has various builtin methods to resize, crop and optimize images. +## 画像最適化設定の変更 -As an example - in `layouts/partials/article-link/card.html`, you have the following code: +Hugo には、画像のサイズ変更、トリミング、最適化を行うためのさまざまな組み込みメソッドがあります。 + +例として - `layouts/partials/article-link/card.html` には、次のコードがあります。 ```go {{ with .Resize "600x" }} @@ -43,26 +44,26 @@ As an example - in `layouts/partials/article-link/card.html`, you have the follo {{ end }} ``` -The default behavior of Hugo here is to resize the image to 600px keeping the ratio. +ここでの Hugo のデフォルトの動作は、比率を維持しながら画像のサイズを 600px に変更することです。 -It is worth noting here that default image configurations such as [anchor point](https://gohugo.io/content-management/image-processing/#anchor) can also be set in your [site configuration](https://gohugo.io/content-management/image-processing/#processing-options) as well as in the template itself. +ここで、[アンカーポイント](https://gohugo.io/content-management/image-processing/#anchor)のようなデフォルトの画像設定は、テンプレート自体だけでなく、[サイト設定](https://gohugo.io/content-management/image-processing/#processing-options)でも設定できることに注意してください。 -See the [Hugo docs on image processing](https://gohugo.io/content-management/image-processing/#image-processing-methods) for more info. +詳細については、[画像処理に関する Hugo ドキュメント](https://gohugo.io/content-management/image-processing/#image-processing-methods)を参照してください。 -## Colour schemes +## カラースキーム -Blowfish ships with a number of colour schemes out of the box. To change the basic colour scheme, you can set the `colorScheme` theme parameter. Refer to the [Getting Started]({{< ref "getting-started#colour-schemes" >}}) section to learn more about the built-in schemes. +Blowfish には、すぐに使用できる多数のカラースキームが付属しています。基本的なカラースキームを変更するには、`colorScheme` テーマパラメータを設定します。 組み込みのスキームの詳細については、[はじめに]({{< ref "getting-started#カラースキーム" >}})セクションを参照してください。 -In addition to the default schemes, you can also create your own and re-style the entire website to your liking. Schemes are created by by placing a `.css` file in the `assets/css/schemes/` folder. Once the file is created, simply refer to it by name in the theme configuration. +デフォルトのスキームに加えて、独自のスキームを作成し、ウェブサイト全体を好みに合わせて再スタイルすることもできます。 スキームは、`assets/css/schemes/` フォルダに `.css` ファイルを配置することで作成されます。ファイルが作成されたら、テーマ設定で名前で参照するだけです。 {{< alert "github">}} -**Note:** generating these files manually can be hard, I've built a `nodejs` terminal tool to help with that, [Fugu](https://github.com/nunocoracao/fugu). In a nutshell, you pass the main three `hex` values of your color palette and the program will output a css file that can be imported directly into Blowfish. +**注:** これらのファイルを手動で生成するのは難しい場合があるため、それを支援する `nodejs` ターミナルツール [Fugu](https://github.com/nunocoracao/fugu) を作成しました。これは、カラーパレットの主要な3つの `hex` 値を渡すと、プログラムは Blowfish に直接インポートできる css ファイルを出力します。 {{< /alert >}} -Blowfish defines a three-colour palette that is used throughout the theme. The three colours are defined as `neutral`, `primary` and `secondary` variants, each containing ten shades of colour. +Blowfish は、テーマ全体で使用される3色のパレットを定義します。3色は `neutral`、`primary`、`secondary` のバリエーションとして定義され、それぞれに10の色合いが含まれています。 -Due to the way Tailwind CSS 3.0 calculates colour values with opacity, the colours specified in the scheme need to [conform to a particular format](https://github.com/adamwathan/tailwind-css-variable-text-opacity-demo) by providing the red, green and blue colour values. +Tailwind CSS 3.0 が不透明度で色の値を計算する方式のため、スキームで指定された色は、赤、緑、青の色の値を提供することにより、[特定の形式に準拠](https://github.com/adamwathan/tailwind-css-variable-text-opacity-demo)する必要があります。 ```css :root { @@ -70,19 +71,19 @@ Due to the way Tailwind CSS 3.0 calculates colour values with opacity, the colou } ``` -This example defines a CSS variable for the `primary-500` colour with a red value of `139`, green value of `92` and blue value of `246`. +この例では、赤の値が `139`、緑の値が `92`、青の値が `246` の `primary-500` カラーの CSS 変数を定義しています。 -Use one of the existing theme stylesheets as a template. You are free to define your own colours, but for some inspiration, check out the official [Tailwind colour palette reference](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). +既存のテーマスタイルシートの1つをテンプレートとして使用します。独自の色を自由に定義できますが、インスピレーションが必要な場合は、公式の [Tailwind カラーパレットリファレンス](https://tailwindcss.com/docs/customizing-colors#color-palette-reference)を確認してください。 -## Overriding the stylesheet +## スタイルシートのオーバーライド -Sometimes you need to add a custom style to style your own HTML elements. Blowfish provides for this scenario by allowing you to override the default styles in your own CSS stylesheet. Simply create a `custom.css` file in your project's `assets/css/` folder. +独自の HTML 要素をスタイルするために、カスタムスタイルを追加する必要がある場合があります。Blowfish は、独自の CSS スタイルシートでデフォルトのスタイルをオーバーライドできるようにすることで、このシナリオに対応します。プロジェクトの `assets/css/` フォルダに `custom.css` ファイルを作成するだけです。 -The `custom.css` file will be minified by Hugo and loaded automatically after all the other theme styles which means anything in your custom file will take precedence over the defaults. +`custom.css` ファイルは Hugo によって縮小され、他のすべてのテーマスタイルの後に自動的にロードされます。つまり、カスタムファイルの内容はデフォルトよりも優先されます。 -### Using additional fonts +### 追加フォントの使用 -Blowfish allows you to easily change the font for your site. After creating a `custom.css` file in your project's `assets/css/` folder, place you font file inside a `fonts` folder within the `static` root folder. +Blowfishでは、サイトのフォントを簡単に変更することができます。プロジェクトの`assets/css/`フォルダ内に`custom.css`ファイルを作成した後、`static`ルートフォルダ内の`fonts`フォルダ内にフォントファイルを配置するだけです。 ```shell . @@ -96,7 +97,7 @@ Blowfish allows you to easily change the font for your site. After creating a `c ``` -This makes the font available to the website. Now, the font can just import it in your `custom.css` and replaced wherever you see fit. The example below shows what replacing the font for the entire `html` would look like. +これにより、フォントをウェブサイトで使用できるようになります。すると、フォントを `custom.css` にインポートし、適切と思われる場所で置き換えることができます。以下の例は、`html` 全体のフォントを置き換える方法を示しています。 ```css @font-face { @@ -109,34 +110,34 @@ html { } ``` -### Adjusting the font size +### フォントサイズの調整 -Changing the font size of your website is one example of overriding the default stylesheet. Blowfish makes this simple as it uses scaled font sizes throughout the theme which are derived from the base HTML font size. By default, Tailwind sets the default size to `12pt`, but it can be changed to whatever value you prefer. +ウェブサイトのフォントサイズを変更することは、デフォルトのスタイルシートをオーバーライドする1つの例です。Blowfish は、テーマ全体で基本 HTML フォントサイズから派生したスケーリングされたフォントサイズを使用するため、これを簡単にします。デフォルトでは、Tailwind はデフォルトサイズを `12pt` に設定していますが、任意の値に変更できます。 -Create a `custom.css` file using the [instructions above]({{< ref "#overriding-the-stylesheet" >}}) and add the following CSS declaration: +[上記の手順]({{< ref "#スタイルシートのオーバーライド" >}}) を使用して `custom.css` ファイルを作成し、次の CSS 宣言を追加します。 ```css -/* Increase the default font size */ +/* デフォルトのフォントサイズを大きくする */ html { font-size: 13pt; } ``` -Simply by changing this one value, all the font sizes on your website will be adjusted to match this new size. Therefore, to increase the overall font sizes used, make the value greater than `12pt`. Similarly, to decrease the font sizes, make the value less than `12pt`. +この1つの値を変更するだけで、ウェブサイトのすべてのフォントサイズがこの新しいサイズに合わせて調整されます。なので、使用されるフォントサイズ全体を大きくするには、値を `12pt` より大きくすれば良いです。同様に、フォントサイズを小さくするには、値を `12pt` より小さくすれば良いです。 -## Building the theme CSS from source +## ソースからテーマ CSS をビルドする -If you'd like to make a major change, you can take advantage of Tailwind CSS's JIT compiler and rebuild the entire theme CSS from scratch. This is useful if you want to adjust the Tailwind configuration or add extra Tailwind classes to the main stylesheet. +大幅な変更を加えたい場合は、Tailwind CSS の JIT コンパイラを利用して、テーマ CSS 全体を最初から再構築できます。これは、Tailwind 設定を調整したり、メインスタイルシートに追加の Tailwind クラスを追加したりする場合に便利です。 {{< alert >}} -**Note:** Building the theme manually is intended for advanced users. +**注:** テーマの手動ビルドは上級者向けです。 {{< /alert >}} -Let's step through how building the Tailwind CSS works. +Tailwind CSS のビルド方法を順番に説明します。 -### Tailwind configuration +### Tailwind 設定 -In order to generate a CSS file that only contains the Tailwind classes that are actually being used the JIT compiler needs to scan through all the HTML templates and Markdown content files to check which styles are present in the markup. The compiler does this by looking at the `tailwind.config.js` file which is included in the root of the theme directory: +実際に使用されている Tailwind クラスのみを含む CSS ファイルを生成するために、JIT コンパイラはすべての HTML テンプレートと Markdown コンテンツファイルをスキャンして、マークアップにどのスタイルが存在するかを確認する必要があります。コンパイラは、テーマディレクトリのルートに含まれる `tailwind.config.js` ファイルを調べてこれを行います。 ```js // themes/blowfish/tailwind.config.js @@ -149,31 +150,31 @@ module.exports = { "./themes/blowfish/content/**/*.{html,md}", ], - // and more... + // その他... }; ``` -This default configuration has been included with these content paths so that you can easily generate your own CSS file without needing to modify it, provided you follow a particular project structure. Namely, **you have to include Blowfish in your project as a subdirectory at `themes/blowfish/`**. This means you cannot easily use Hugo Modules to install the theme and you must go down either the git submodule (recommended) or manual install routes. The [Installation docs]({{< ref "installation" >}}) explain how to install the theme using either of these methods. +このデフォルト設定には、これらのコンテンツパスが含まれているため、特定のプロジェクト構造に従う限り、変更することなく独自の CSS ファイルを簡単に生成できます。つまり、**Blowfish を `themes/blowfish/` のサブディレクトリとしてプロジェクトに含める必要があります**。これは、Hugo Modules を使用してテーマを簡単にインストールできないことを意味し、git サブモジュール（推奨）または手動インストールルートのいずれかを選択する必要があります。[インストールドキュメント]({{< ref "installation" >}}) では、これらのいずれかの方法を使用してテーマをインストールする方法について説明しています。 -### Project structure +### プロジェクト構造 -In order to take advantage of the default configuration, your project should look something like this... +デフォルト設定を利用するために、プロジェクトは次のようになります... ```shell . ├── assets │ └── css │ └── compiled -│ └── main.css # this is the file we will generate -├── config # site config +│ └── main.css # これが生成するファイル +├── config # サイト設定 │ └── _default -├── content # site content +├── content # サイトコンテンツ │ ├── _index.md │ ├── projects │ │ └── _index.md │ └── blog │ └── _index.md -├── layouts # custom layouts for your site +├── layouts # サイトのカスタムレイアウト │ ├── partials │ │ └── extend-article-link/simple.html │ ├── projects @@ -181,38 +182,38 @@ In order to take advantage of the default configuration, your project should loo │ └── shortcodes │ └── disclaimer.html └── themes - └── blowfish # git submodule or manual theme install + └── blowfish # git サブモジュールまたは手動テーマインストール ``` -This example structure adds a new `projects` content type with its own custom layout along with a custom shortcode and extended partial. Provided the project follows this structure, all that's required is to recompile the `main.css` file. +この例の構造では、独自のカスタムレイアウトを持つ新しい `projects` コンテンツタイプと、カスタムショートコードと拡張パーシャルが追加されています。プロジェクトがこの構造に従っている場合、必要なのは `main.css` ファイルを再コンパイルすることだけです。 -### Install dependencies +### 依存関係のインストール -In order for this to work you'll need to change into the `themes/blowfish/` directory and install the project dependencies. You'll need [npm](https://docs.npmjs.com/cli/v7/configuring-npm/install) on your local machine for this step. +これが機能するには、`themes/blowfish/` ディレクトリに移動し、プロジェクトの依存関係をインストールする必要があります。この手順では、ローカルマシンに [npm](https://docs.npmjs.com/cli/v7/configuring-npm/install) が必要になります。 ```shell cd themes/blowfish npm install ``` -### Run the Tailwind compiler +### Tailwind コンパイラを実行する -With the dependencies installed all that's left is to use [Tailwind CLI](https://v2.tailwindcss.com/docs/installation#using-tailwind-cli) to invoke the JIT compiler. Navigate back to the root of your Hugo project and issue the following command: +依存関係がインストールされたら、あとは [Tailwind CLI](https://v2.tailwindcss.com/docs/installation#using-tailwind-cli) を使用して JIT コンパイラを呼び出すだけです。Hugo プロジェクトのルートに戻り、次のコマンドを実行します。 ```shell cd ../.. ./themes/blowfish/node_modules/tailwindcss/lib/cli.js -c ./themes/blowfish/tailwind.config.js -i ./themes/blowfish/assets/css/main.css -o ./assets/css/compiled/main.css --jit ``` -It's a bit of an ugly command due to the paths involved but essentially you're calling Tailwind CLI and passing it the location of the Tailwind config file (the one we looked at above), where to find the theme's `main.css` file and then where you want the compiled CSS file to be placed (it's going into the `assets/css/compiled/` folder of your Hugo project). +関係するパスのため少し見苦しいコマンドですが、基本的に Tailwind CLI を呼び出し、Tailwind 設定ファイルの場所（上で見たもの）、テーマの `main.css` ファイルの場所、そしてコンパイル済み CSS ファイルを配置する場所（Hugo プロジェクトの `assets/css/compiled/` フォルダ）を渡しています。 -The config file will automatically inspect all the content and layouts in your project as well as all those in the theme and build a new CSS file that contains all the CSS required for your website. Due to the way Hugo handles file hierarchy, this file in your project will now automatically override the one that comes with the theme. +設定ファイルは、プロジェクト内のすべてのコンテンツとレイアウト、およびテーマ内のすべてのコンテンツとレイアウトを自動的にスキャンし、ウェブサイトに必要なすべての CSS を含む新しい CSS ファイルを作ります。Hugo のファイル階層を処理する方法のため、プロジェクト内のこのファイルは、テーマに付属のファイルを自動的にオーバーライドするようになります。 -Each time you make a change to your layouts and need new Tailwind CSS styles, you can simply re-run the command and generate the new CSS file. You can also add `-w` to the end of the command to run the JIT compiler in watch mode. +レイアウトに変更を加え、新しい Tailwind CSS スタイルが必要になるたびに、コマンドを再実行して新しい CSS ファイルを生成するだけです。 コマンドの最後に `-w` を追加して、JIT コンパイラをウォッチモードで実行することもできます。 -### Make a build script +### ビルドスクリプトを作成する -To fully complete this solution, you can simplify this whole process by adding aliases for these commands, or do what I do and add a `package.json` to the root of your project which contains the necessary scripts... +このソリューションを完全に完了するには、これらのコマンドのエイリアスを追加するか、私が行っているように、必要なスクリプトを含む `package.json` をプロジェクトのルートに追加することで、このプロセス全体を簡素化できます... ```js // package.json @@ -226,10 +227,10 @@ To fully complete this solution, you can simplify this whole process by adding a "dev": "NODE_ENV=development ./themes/blowfish/node_modules/tailwindcss/lib/cli.js -c ./themes/blowfish/tailwind.config.js -i ./themes/blowfish/assets/css/main.css -o ./assets/css/compiled/main.css --jit -w", "build": "NODE_ENV=production ./themes/blowfish/node_modules/tailwindcss/lib/cli.js -c ./themes/blowfish/tailwind.config.js -i ./themes/blowfish/assets/css/main.css -o ./assets/css/compiled/main.css --jit" }, - // and more... + // その他... } ``` -Now when you want to work on designing your site, you can invoke `npm run dev` and the compiler will run in watch mode. When you're ready to deploy, run `npm run build` and you'll get a clean Tailwind CSS build. +これで、サイトの設計に取り組むときは、 `npm run dev` を呼び出すと、コンパイラがウォッチモードで実行されます。デプロイの準備ができたら、`npm run build` を実行すると、クリーンな Tailwind CSS ビルドが得られます。 -🙋‍♀️ If you need help, feel free to ask a question on [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions). +🙋‍♀️ ご不明な点がありましたら、[GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions) で気軽に質問してください。 diff --git a/exampleSite/content/docs/configuration/index.ja.md b/exampleSite/content/docs/configuration/index.ja.md index 6d090ffb8..0630f6f48 100644 --- a/exampleSite/content/docs/configuration/index.ja.md +++ b/exampleSite/content/docs/configuration/index.ja.md @@ -1,20 +1,20 @@ --- -title: "Configuration" +title: "設定" weight: 4 draft: false -description: "All the configuration variables available in Blowfish." +description: "Blowfish で使えるすべての設定変数" slug: "configuration" tags: ["config", "docs"] series: ["Documentation"] series_order: 4 --- -Blowfish is a highly customisable theme and uses some of the latest Hugo features to simplify how it is configured. +Blowfish は高度にカスタマイズ可能なテーマであり、最新の Hugo 機能を使用して設定方法をシンプルにしています。 -The theme ships with a default configuration that gets you up and running with a basic blog or static website. +このテーマには、基本的なブログまたは静的サイトをすぐに立ち上げて実行できるデフォルト設定が付属しています。 {{< alert "fire" >}} -We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using: +Blowfish を簡単に使い始められるように、新しい CLI ツールをリリースしました。インストールと設定に役立ちます。 グローバルに CLI ツールをインストールするには、以下を使用します。 ```bash npx blowfish-tools @@ -22,351 +22,353 @@ npx blowfish-tools {{< /alert >}} -> Configuration files bundled with the theme are provided in TOML format as this is the default Hugo syntax. Feel free to convert your config to YAML or JSON if you wish. +> テーマにバンドルされている設定ファイルは、デフォルトの Hugo 構文である TOML 形式で提供されています。必要に応じて、設定を YAML または JSON に変換できます。 -The default theme configuration is documented in each file so you can freely adjust the settings to meet your needs. +デフォルトのテーマ設定は各ファイルに記載されているため、必要に応じて設定を自由に調整できます。 {{< alert >}} -As outlined in the [installation instructions]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}), you should adjust your theme configuration by modifying the files in the `config/_default/` folder of your Hugo project and delete the `config.toml` file in your project root. +[インストール手順]({{< ref "/docs/installation#set-up-theme-configuration-files" >}})で概説されているように、Hugo プロジェクトの `config/_default/` フォルダ内のファイルを修正し、プロジェクトルートの `config.toml` ファイルを削除することで、テーマ設定を調整する必要があります。 {{< /alert >}} -## Site configuration +## サイト設定 -Standard Hugo configuration variables are respected throughout the theme, however there are some specific things that should be configured for the best experience. +テーマ全体で標準の Hugo 設定変数が適用されますが、最適なエクスペリエンスを得るために設定する必要がある特定の事項があります。 -The site configuration is managed through the `config/_default/config.toml` file. The table below outlines all the settings that the Blowfish takes advantage of. +サイト設定は `config/_default/config.toml` ファイルで管理されます。 下の表は、Blowfish が活用するすべての設定の概要を示しています。 -Note that the variable names provided in this table use dot notation to simplify the TOML data structure (ie. `outputs.home` refers to `[outputs] home`). +この表で提供されている変数名は、TOML データ構造を簡素化するためにドット表記を使用していることに注意してください（つまり、 `outputs.home` は `[outputs] home` を指します）。 -| Name | Default | Description | -| ------------------------ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `theme` | `"blowfish"` | When using Hugo Modules this config value should be removed. For all other installation types, this must be set to `blowfish` for the theme to function. | -| `baseURL` | _Not set_ | The URL to the root of the website. | -| `defaultContentLanguage` | `"en"` | This value determines the default language of theme components and content. Refer to the [language and i18n](#language-and-i18n) section below for supported language codes. | -| `enableRobotsTXT` | `true` | When enabled, a `robots.txt` file will be created in the site root that allows search engines to crawl the entire site. If you prefer to provide your own pre-made `robots.txt`, set to `false` and place your file in the `static` directory. For complete control, you may provide a [custom layout]({{< ref "content-examples#custom-layouts" >}}) to generate this file. | -| `pagination.pagerSize` | `10` | The number of articles listed on each page of the article listing. | -| `summaryLength` | `0` | The number of words that are used to generate the article summary when one is not provided in the [front matter]({{< ref "front-matter" >}}). A value of `0` will use the first sentence. This value has no effect when summaries are hidden. | -| `outputs.home` | `["HTML", "RSS", "JSON"]` | The output formats that are generated for the site. Blowfish requires HTML, RSS and JSON for all theme components to work correctly. | -| `permalinks` | _Not set_ | Refer to the [Hugo docs](https://gohugo.io/content-management/urls/#permalinks) for permalink configuration. | -| `taxonomies` | _Not set_ | Refer to the [Organising content]({{< ref "getting-started#organising-content" >}}) section for taxonomy configuration. | +| 名前 | デフォルト | 説明 | +|---|---|---| +| `theme` | `"blowfish"` | Hugo Modules を使用している場合は、この設定値を削除する必要があります。 他のすべてのインストールタイプでは、テーマが機能するためにこれを `blowfish` に設定する必要があります。 | +| `baseURL` | _未設定_ | ウェブサイトのルートへの URL です。 | +| `defaultContentLanguage` | `"en"` | この値は、テーマコンポーネントとコンテンツのデフォルト言語を決定します。 サポートされている言語コードについては、以下の[言語と i18n](#言語と-i18n) セクションを参照してください。 | +| `enableRobotsTXT` | `true` | 有効にすると、検索エンジンがサイト全体をクロールできるようにする `robots.txt` ファイルがサイトルートに作成されます。 あらかじめ作成した独自の `robots.txt` を提供する場合は、`false` に設定し、ファイルを `static` ディレクトリに配置します。 完全に制御するには、このファイルを生成するための[カスタムレイアウト]({{< ref "content-examples#カスタムレイアウト" >}})を提供できます。 | +| `pagination.pagerSize` | `10` | 記事リストの各ページにリストされる記事の数です。 | +| `summaryLength` | `0` | [フロントマター]({{< ref "front-matter" >}})で提供されていない場合に、記事の概要を生成するために使用される単語の数です。 値 `0` は最初の文を使用します。 概要が非表示になっている場合、この値は効果がありません。 | +| `outputs.home` | `["HTML", "RSS", "JSON"]` | サイト用に生成される出力形式です。 Blowfish では、すべてのテーマコンポーネントが正しく機能するために HTML、RSS、JSON が必要です。 | +| `permalinks` | _未設定_ | パーマリンクの設定については、[Hugo ドキュメント](https://gohugo.io/content-management/urls/#permalinks)を参照してください。 | +| `taxonomies` | _未設定_ | 分類の設定については、[コンテンツの整理]({{< ref "getting-started#コンテンツの整理" >}})セクションを参照してください。 | -## Thumbnails - -Blowfish was built so it would be easy to add visual support to your articles. If your familiar with Hugo article structure, you just need to place an image file (almost all formats are supported but we recommend `.png` or `.jpg`) that starts with `feature*` inside your article folder. And that's it, Blowfish will then able to both use the image as a thumbnail within your website as well as for oEmbed cards across social platforms. - -[Here]({{< ref "thumbnails" >}}) is also a guide with more info and a [sample]({{< ref "thumbnail_sample" >}}) if you want to see how you can do it. - -## Language and i18n - -Blowfish is optimised for full multilingual websites and theme assets are translated into several languages out of the box. The language configuration allows you to generate multiple versions of your content to provide a customised experience to your visitors in their native language. - -The theme currently supports the following languages by default: - -| Language | Code | -| ---------------------------- | ------- | -| Arabic | `ar` | -| Bulgarian | `bg` | -| Bengali | `bn` | -| Catalan | `ca` | -| Czech | `cs` | -| German | `de` | -| English | `en` | -| Esperanto | `eo` | -| Spanish (Spain) | `es` | -| Finnish | `fi` | -| French | `fr` | -| Hebrew | `he` | -| Croatian | `hr` | -| Hungarian | `hu` | -| Indonesian | `id` | -| Italian | `it` | -| Japanese | `ja` | -| Korean | `ko` | -| Dutch | `nl` | -| Polish | `pl` | -| Portuguese (Brazil) | `pt-br` | -| Portuguese (Portugal) | `pt-pt` | -| Romanian | `ro` | -| Russian | `ru` | -| Turkish | `tr` | -| Vietnamese | `vi` | -| Simplified Chinese (China) | `zh-cn` | -| Traditional Chinese (Taiwan) | `zh-tw` | - -The default translations can be overridden by creating a custom file in `i18n/[code].yaml` that contains the translation strings. You can also use this method to add new languages. If you'd like to share a new translation with the community, please [open a pull request](https://github.com/nunocoracao/blowfish/pulls). - -### Configuration - -In order to be as flexible as possible, a language configuration file needs to be created for each language on the website. By default Blowfish includes an English language configuration at `config/_default/languages.en.toml`. - -The default file can be used as a template to create additional languages, or renamed if you wish to author your website in a language other than English. Simply name the file using the format `languages.[language-code].toml`. + +## サムネイル + +Blowfish は、記事に視覚的なサポートを簡単に追加できるように構築されています。Hugo の記事構造に慣れている場合は、記事フォルダ内に `feature*` で始まる画像ファイル（ほとんどすべての形式がサポートされていますが、`.png` または `.jpg` をお勧めします）を配置するだけです。これで、Blowfish はサイト内でサムネイルとして画像を使用したり、ソーシャルプラットフォーム全体で oEmbed カードに使用したりできます。 + +[こちら]({{< ref "thumbnails" >}})には、より詳細な情報と、どのように設定できるかを確認したい場合の[サンプル]({{< ref "thumbnail_sample" >}})を含むガイドもあります。 + +## 言語と i18n + +Blowfish は多言語ウェブサイト向けに最適化されており、テーマアセットはすぐに使えるように複数の言語に翻訳されています。 言語設定を使用すると、コンテンツの複数のバージョンを生成して、訪問者に母国語でカスタマイズされたエクスペリエンスを提供できます。 + +このテーマは現在、デフォルトで次の言語をサポートしています: + +| 言語 | コード | +|---|---| +| アラビア語 | `ar` | +| ブルガリア語 | `bg` | +| ベンガル語 | `bn` | +| カタロニア語 | `ca` | +| チェコ語 | `cs` | +| ドイツ語 | `de` | +| 英語 | `en` | +| エスペラント語 | `eo` | +| スペイン語（スペイン） | `es` | +| フィンランド語 | `fi` | +| フランス語 | `fr` | +| ヘブライ語 | `he` | +| クロアチア語 | `hr` | +| ハンガリー語 | `hu` | +| インドネシア語 | `id` | +| イタリア語 | `it` | +| 日本語 | `ja` | +| 韓国語 | `ko` | +| オランダ語 | `nl` | +| ポーランド語 | `pl` | +| ポルトガル語（ブラジル） | `pt-br` | +| ポルトガル語（ポルトガル） | `pt-pt` | +| ルーマニア語 | `ro` | +| ロシア語 | `ru` | +| トルコ語 | `tr` | +| ベトナム語 | `vi` | +| 中国語（簡体字） | `zh-cn` | +| 中国語（繁体字） | `zh-tw` | + +デフォルトの翻訳は、翻訳文字列を含むカスタムファイル `i18n/[言語コード].yaml` を作成することでオーバーライドできます。 この方法を使用して新しい言語を追加することもできます。 新しい翻訳をコミュニティと共有したい場合は、[プルリクエストを開いて](https://github.com/nunocoracao/blowfish/pulls)ください。 + +### 設定 + +可能な限り柔軟に対応するために、ウェブサイトの各言語の言語設定ファイルを作成する必要があります。デフォルトでは、Blowfish には `config/_default/languages.en.toml` に英語の言語設定が含まれています。 + +デフォルトのファイルは、追加の言語を作成するためのテンプレートとして使用することも、英語以外の言語でウェブサイトを作成する場合は名前を変更することもできます。`languages.[言語コード].toml` 形式を使用してファイルに名前を付けるだけです。 {{< alert >}} -**Note:** Ensure the `defaultContentLanguage` parameter in the [site configuration](#site-configuration) matches the language code in your language config filename. +**注:** [サイト設定](#サイト設定)の `defaultContentLanguage` パラメータが、言語設定ファイル名の言語コードと一致していることを確認してください。 {{< /alert >}} -#### Global +#### グローバル -| Name | Default | Description | -| -------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `languageCode` | `"en"` | The Hugo language code for this file. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-au`) and should match the language code in the filename. Hugo expects this value to always be in lowercase. For proper HTML compliance, set the `isoCode` parameter which is case-sensitive. | -| `languageName` | `"English"` | The name of the language. | -| `weight` | `1` | The weight determines the order of languages when building multilingual sites. | -| `title` | `"Blowfish"` | The title of the website. This will be displayed in the site header and footer. | +| 名前 | デフォルト | 説明 | +|---|---|---| +| `languageCode` | `"en"` | このファイルの Hugo 言語コードです。トップレベル言語（例： `en`）またはサブバリアント（例： `en-au`）にすることができ、ファイル名の言語コードと一致する必要があります。Hugo はこの値が常に小文字であることを想定しています。適切な HTML 準拠のために、大文字と小文字を区別する `isoCode` パラメータを設定します。 | +| `languageName` | `"English"` | 言語の名前です。 | +| `weight` | `1` | 重みは、多言語サイトを構築するときの言語の順序を決定します。 | +| `title` | `"Blowfish"` | ウェブサイトのタイトルです。これは、サイトのヘッダーとフッターに表示されます。 | -#### Params +#### パラメーター -| Name | Default | Description | -| ---------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `params.displayName` | `"EN"` | The name used when the language appears on the website. | -| `params.isoCode` | `"en"` | The ISO language code for HTML metadata purposes. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-AU`). | -| `params.rtl` | `false` | Whether or not this is a RTL language. Set to `true` to reflow content from right-to-left. Blowfish fully supports using RTL and LTR languages at the same time and will dynamically adjust to both. | -| `params.dateFormat` | `"2 January 2006"` | How dates are formatted in this language. Refer to the [Hugo docs](https://gohugo.io/functions/format/#gos-layout-string) for acceptable formats. | -| `params.logo` | _Not set_ | The relative path to the site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions. | -| `params.secondaryLogo` | _Not set_ | The relative path to the secondary site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions. This should have an inverted/contrasting colour scheme to `logo`. If set, this logo will be shown when users toggle from the `defaultAppearance` mode. | -| `params.description` | _Not set_ | The website description. This will be used in the site metadata. | -| `params.copyright` | _Not set_ | A Markdown string for the site footer copyright message can include the placeholder { year } to dynamically insert the current year. If none is provided, Blowfish will automatically generate a copyright string using the site `title`. | +| 名前 | デフォルト | 説明 | +|---|---|---| +| `params.displayName` | `"EN"` | ウェブサイトに言語が表示されるときに使用される名前です。 | +| `params.isoCode` | `"en"` | HTML メタデータ用の ISO 言語コードです。トップレベル言語（例： `en`）またはサブバリアント（例： `en-AU`）にすることができます。 | +| `params.rtl` | `false` | これが RTL 言語かどうかです。`true` に設定すると、コンテンツが右から左に並べ替えられます。 Blowfish は RTL 言語と LTR 言語の同時使用を完全にサポートしており、両方に動的に調整されます。 | +| `params.dateFormat` | `"2 January 2006"` | この言語での日付のフォーマット方法です。使用できる形式については、[Hugo ドキュメント](https://gohugo.io/functions/format/#gos-layout-string)を参照してください。 | +| `params.logo` | _未設定_ | `assets/` フォルダ内のサイトロゴファイルへの相対パスです。ロゴファイルは2倍の解像度で提供する必要があり、あらゆる画像サイズをサポートしています。 | +| `params.secondaryLogo` | _未設定_ | `assets/` フォルダ内のセカンダリサイトロゴファイルへの相対パスです。 ロゴファイルは2倍の解像度で提供する必要があり、あらゆる画像サイズをサポートしています。 これは、`logo` とは反転/対照的なカラースキームである必要があります。設定されている場合、このロゴは、ユーザーが `defaultAppearance` モードから切り替えたときに表示されます。 | +| `params.description` | _未設定_ | ウェブサイトの説明です。これはサイトのメタデータで使用されます。 | +| `params.copyright` | _未設定_ | サイトフッターの著作権メッセージの Markdown 文字列には、プレースホルダ { year } を含めて現在の年を動的に挿入できます。指定されていない場合、Blowfish はサイト `title` を使用して著作権文字列を自動的に生成します。 | -#### Author +#### 著者(Author) -| Name | Default | Description | -| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `author.name` | _Not set_ | The author's name. This will be displayed in article footers, and on the homepage when the profile layout is used. | -| `author.image` | _Not set_ | Path to the image file of the author. The image should be a 1:1 aspect ratio. The image can be placed in the site's `assets/` folder or can be external url. | -| `author.headline` | _Not set_ | A Markdown string containing the author's headline. It will be displayed on the profile homepage under the author's name. | -| `author.bio` | _Not set_ | A Markdown string containing the author's bio. It will be displayed in article footers. | -| `author.links` | _Not set_ | The links to display alongside the author's details. The config file contains example links which can simply be uncommented to enable. The order that the links are displayed is determined by the order they appear in the array. Custom links can be added by providing corresponding SVG icon assets in `assets/icons/`. | + +| 名前 | デフォルト　　　 | 説明 | +|---|---|---| +| `author.name` | _未設定_ | 著者の名前です。これは、記事のフッターと、プロフィールレイアウトが使用されている場合はホームページに表示されます。 | +| `author.image` | _未設定_ | 著者の画像ファイルへのパスです。画像は縦横比 1:1 である必要があります。画像は、サイトの `assets/` フォルダに配置することも、外部 URL にすることもできます。 | +| `author.headline` | _未設定_ | 著者の見出しを含む Markdown 文字列です。プロフィールホームページの著者の名前に下に表示されます。 | +| `author.bio` | _未設定_ | 著者の略歴を含む Markdown 文字列です。記事のフッターに表示されます。 | +| `author.links` | _未設定_ | 著者の詳細と一緒に表示するリンクです。設定ファイルには、コメントを外すだけで有効になるリンクの例が含まれています。リンクが表示される順序は、配列に表示される順序によって決まります。`assets/icons/` に対応する SVG アイコンアセットを提供することで、カスタムリンクを追加できます。 | -### Menus +### メニュー(Menus) -Blowfish also supports language-specific menu configurations. Menu config files follow the same naming format as the languages file. Simply provide the language code in the file name to tell Hugo which language the file relates to. +Blowfish は、言語固有のメニュー設定もサポートしています。メニュー設定ファイルは、言語ファイルと同じ命名形式に従います。ファイル名に言語コードを指定するだけで、Hugo はファイルがどの言語に関連しているかを認識します。 -Menu config files are named with the format `menus.[language-code].toml`. Always ensure that the language code used in the menus configuration matches the languages configuration. +メニュー設定ファイルの名前は、 `menus.[language-code].toml` 形式です。メニュー設定で使用される言語コードが言語設定と一致していることを常に確認してください。 -The [Getting Started]({{< ref "getting-started#menus" >}}) section explains more about the structure of this file. You can also refer to the [Hugo menu docs](https://gohugo.io/content-management/menus/) for more configuration examples. +[はじめに]({{< ref "getting-started#menus" >}})セクションでは、このファイルの構造について詳しく説明しています。詳細な設定例については、[Hugo メニュー ドキュメント](https://gohugo.io/content-management/menus/)も参照できます。 -## Theme parameters +## テーマパラメーター(Theme parameters) -Blowfish provides a large number of configuration parameters that control how the theme functions. The table below outlines every available parameter in the `config/_default/params.toml` file. +Blowfish は、テーマの機能を制御する多数の設定パラメータを提供します。下の表は、`config/_default/params.toml` ファイルで使用可能なすべてのパラメータの概要を示しています。 -Many of the article defaults here can be overridden on a per article basis by specifying it in the front matter. Refer to the [Front Matter]({{< ref "front-matter" >}}) section for further details. +ここにある記事のデフォルトの多くは、フロントマターで指定することで、記事ごとにオーバーライドできます。詳細については、[フロントマター]({{< ref "front-matter" >}})セクションを参照してください。 -### Global - -| Name | Default | Description | -| ------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `colorScheme` | `"blowfish"` | The theme colour scheme to use. Valid values are `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, and`slate`. Refer to the [Colour Schemes]({{< ref "getting-started#colour-schemes" >}}) section for more details. | -| `defaultAppearance` | `"light"` | The default theme appearance, either `light` or `dark`. | -| `autoSwitchAppearance` | `true` | Whether the theme appearance automatically switches based upon the visitor's operating system preference. Set to `false` to force the site to always use the `defaultAppearance`. | -| `enableSearch` | `false` | Whether site search is enabled. Set to `true` to enable search functionality. Note that the search feature depends on the `outputs.home` setting in the [site configuration](#site-configuration) being set correctly. | -| `enableCodeCopy` | `false` | Whether copy-to-clipboard buttons are enabled for `` blocks. The `highlight.noClasses` parameter must be set to `false` for code copy to function correctly. Read more about [other configuration files](#other-configuration-files) below. | -| `mainSections` | _Not set_ | The sections that should be displayed in the recent articles list. If not provided the section with the greatest number of articles is used. | -| `showViews` | _Not set_ | Whether or not articles and list views are displayed. This requires firebase integrations to be enabled, look below. | -| `showLikes` | _Not set_ | Whether or not articles and list likes are displayed. This requires firebase integrations to be enabled, look below. | -| `robots` | _Not set_ | String that indicates how robots should handle your site. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values. | -| `disableImageZoom` | `false` | Disables image zoom feature across all the images in the site. | -| `disableImageOptimization` | `false` | Disables image resize and optimization features across all the images in the site. | -| `disableTextInHeader` | `false` | Disables text in header, useful for logo based headers. | -| `defaultBackgroundImage` | _Not set_ | Default background image for both `background` homepage layout and `background` hero style | -| `defaultFeaturedImage` | _Not set_ | Default background image for all `featured` images across articles, will be overridden by a local `featured` image. | -| `highlightCurrentMenuArea` | _Not set_ | Marks menu entries in the main menu when selected | -| `smartTOC` | _Not set_ | Activate smart Table of Contents, items in view will be highlighted. | -| `smartTOCHideUnfocusedChildren` | _Not set_ | When smart Table of Contents is turned on, this will hide deeper levels of the table when they are not in focus. | - -### Header - -| Name | Default | Description | -| --------------- | --------- | ------------------------------------------------------------------------------------------------------------------- | -| `header.layout` | `"basic"` | Defines the header for the entire site, supported values are `basic`, `fixed`, `fixed-fill`, and `fixed-fill-blur`. | - -### Footer - -| Name | Default | Description | -| ------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `footer.showMenu` | `true` | Show/hide the footer menu, which can be configured in the `[[footer]]` section of the `config/_default/menus.en.toml` file. | -| `footer.showCopyright` | `true` | Whether or not to show the copyright string in the site footer. Note that the string itself can be customised using the `copyright` parameter in the [languages configuration](#language-and-i18n). | -| `footer.showThemeAttribution` | `true` | Whether or not to show the "powered by" theme attribution in the site footer. If you choose to disable this message, please consider attributing the theme somewhere else on your site (for example, on your about page). | -| `footer.showAppearanceSwitcher` | `false` | Whether or not to show the appearance switcher in the site footer. The browser's local storage is used to persist the visitor's preference. | -| `footer.showScrollToTop` | `true` | When set to `true` the scroll to top arrow is displayed. | - -### Homepage - -| Name | Default | Description | -| ------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `homepage.layout` | `"profile"` | The layout of the homepage. Valid values are `page`, `profile`, `hero`, `card`, `background`, or `custom`. When set to `custom`, you must provide your own layout by creating a `/layouts/partials/home/custom.html` file. Refer to the [Homepage Layout]({{< ref "homepage-layout" >}}) section for more details. | -| `homepage.homepageImage` | _Not set_ | Image to be used in `hero` and `card` layouts. Can be set as local image from asset directory or external image url. Refer to the [Homepage Layout]({{< ref "homepage-layout" >}}) section for more details. | -| `homepage.showRecent` | `false` | Whether or not to display the recent articles list on the homepage. | -| `homepage.showRecentItems` | 5 | How many articles to display if showRecent is true. If variable is set to 0 or if it isn't defined the system will default to 5 articles. | -| `homepage.showMoreLink` | `false` | Whether or not to display a show more link at the end of your posts that takes the user to a predefined place. | -| `homepage.showMoreLinkDest` | `/posts` | The destination of the show more button. | -| `homepage.cardView` | `false` | Display recent articles as a gallery of cards. | -| `homepage.cardViewScreenWidth` | `false` | Enhance the width of the recent articles card gallery to take the full width available. | -| `homepage.layoutBackgroundBlur` | `false` | Makes the background image in the homepage layout blur with the scroll | - -### Article - -| Name | Default | Description | -| ------------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `article.showDate` | `true` | Whether or not article dates are displayed. | -| `article.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | -| `article.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | -| `article.showDateOnlyInArticle` | `false` | Show date within article even if not displayed in article listings/cards. | -| `article.showDateUpdated` | `false` | Whether or not the dates articles were updated are displayed. | -| `article.showAuthor` | `true` | Whether or not the author box is displayed in the article footer. | -| `article.showAuthorBottom` | `false` | Author boxes are displayed at the bottom of each page instead of the top. | -| `article.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each article page. | -| `article.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | -| `article.layoutBackgroundBlur` | `true` | Makes the background image in the background article heroStyle blur with the scroll | -| `article.layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | -| `article.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the article header. | -| `article.showDraftLabel` | `true` | Whether or not the draft indicator is shown next to articles when site is built with `--buildDrafts`. | -| `article.showEdit` | `false` | Whether or not the link to edit the article content should be displayed. | -| `article.editURL` | _Not set_ | When `article.showEdit` is active, the URL for the edit link. | -| `article.editAppendPath` | `true` | When `article.showEdit` is active, whether or not the path to the current article should be appended to the URL set at `article.editURL`. | -| `article.seriesOpened` | `false` | Whether or not the series module will be displayed open by default or not. | -| `article.showHeadingAnchors` | `true` | Whether or not heading anchor links are displayed alongside headings within articles. | -| `article.showPagination` | `true` | Whether or not the next/previous article links are displayed in the article footer. | -| `article.invertPagination` | `false` | Whether or not to flip the direction of the next/previous article links. | -| `article.showReadingTime` | `true` | Whether or not article reading times are displayed. | -| `article.showTableOfContents` | `false` | Whether or not the table of contents is displayed on articles. | -| `article.showRelatedContent` | `false` | Display related content for each post. Might required additional configuration to your `config.toml`. Please check the theme `config.toml` if you want to enable this feature and copy all the relevant _related_ entries. Also check [Hugo's docs](https://gohugo.io/content-management/related/) on related content. | -| `article.relatedContentLimit` | `3` | Limit of related articles to display if `showRelatedContent` is turned on. | -| `article.showTaxonomies` | `false` | Whether or not the taxonomies related to this article are displayed. | -| `article.showAuthorsBadges` | `false` | Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | -| `article.showWordCount` | `false` | Whether or not article word counts are displayed. | -| `article.showComments` | `false` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | -| `article.sharingLinks` | _Not set_ | Which sharing links to display at the end of each article. When not provided, or set to `false` no links will be displayed. Available values are: "linkedin", "bluesky", "mastodon", "twitter", "reddit", "pinterest", "facebook", "email", "whatsapp", and "telegram" | -| `article.showZenMode` | `false` | Flag to activate Zen Mode reading feature for articles. | - -### List - -| Name | Default | Description | -| ---------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `list.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each list page. | -| `list.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | -| `list.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the header on list pages. | -| `list.layoutBackgroundBlur` | `true` | Makes the background image in the background list heroStyle blur with the scroll | -| `list.layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | -| `list.showTableOfContents` | `false` | Whether or not the table of contents is displayed on list pages. | -| `list.showSummary` | `false` | Whether or not article summaries are displayed on list pages. If a summary is not provided in the [front matter]({{< ref "front-matter" >}}), one will be auto generated using the `summaryLength` parameter in the [site configuration](#site-configuration). | -| `list.showViews` | `false` | Whether or not list views are displayed. This requires firebase integrations to be enabled, look below. | -| `list.showLikes` | `false` | Whether or not list likes are displayed. This requires firebase integrations to be enabled, look below. | -| `list.showCards` | `false` | Whether or not each article is displayed as a card or as simple inline text. | -| `list.orderByWeight` | `false` | Whether or not articles are sorted by [weights](https://gohugo.io/methods/page/weight/). | -| `list.groupByYear` | `true` | Whether or not articles are grouped by year on list pages. | -| `list.cardView` | `false` | Display lists as a gallery of cards. | -| `list.cardViewScreenWidth` | `false` | Enhance the width of card galleries in lists to take the full width available. | -| `list.constrainItemsWidth` | `false` | Limit item width to `prose` to increase readability. Useful when no feature images are available. | -| `list.showTableOfContents` | `false` | Whether or not the table of contents is displayed on articles. | - -### Sitemap - -| Name | Default | Description | +### グローバル + +| 名前 | デフォルト | 説明 | +|---|---|---| +| `colorScheme` | `"blowfish"` | 使用するテーマのカラースキームです。有効な値は、`blowfish`（デフォルト）、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate` です。詳細については、[カラースキーム]({{< ref "getting-started#カラースキーム" >}})セクションを参照してください。 | +| `defaultAppearance` | `"light"` | デフォルトのテーマの外観です。`light` または `dark` のいずれかです。 | +| `autoSwitchAppearance` | `true` | 訪問者のオペレーティングシステムの設定に基づいてテーマの外観を自動的に切り替えるかどうかです。`false` に設定すると、サイトは常に `defaultAppearance` を使用します。 | +| `enableSearch` | `false` | サイト内検索が有効かどうかです。`true` に設定すると、検索機能が有効になります。検索機能は、[サイト設定](#サイト設定)の `outputs.home` 設定が正しく設定されているかどうかに依存することに注意してください。 | +| `enableCodeCopy` | `false` | `` ブロックのクリップボードへのコピーボタンを有効にするかどうかです。コードコピーが正しく機能するには、`highlight.noClasses` パラメータを `false` に設定する必要があります。以下の[その他の設定ファイル](#その他の設定ファイル)について読んでください。 | +| `mainSections` | _未設定_ | 最近の記事リストに表示するセクションです。指定しない場合は、記事数が最も多いセクションが使用されます。 | +| `showViews` | _未設定_ | 記事とリストの表示回数を表示するかどうかです。これには Firebase 統合を有効にする必要があります。以下をご覧ください。 | +| `showLikes` | _未設定_ | 記事とリストのいいねを表示するかどうかです。これには Firebase 統合を有効にする必要があります。以下をご覧ください。 | +| `robots` | _未設定_ | ロボットがサイトをどのように処理するかを示す文字列です。設定されている場合、ページヘッダーに出力されます。有効な値については、[Google のドキュメント](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives)を参照してください。 | +| `disableImageZoom` | `false` | サイト内のすべての画像の画像ズーム機能を無効にします。 | +| `disableImageOptimization` | `false` | サイト内のすべての画像の画像サイズ変更と最適化機能を無効にします。 | +| `disableTextInHeader` | `false` | ヘッダーのテキストを無効にします。ロゴベースのヘッダーに役立ちます。 | +| `defaultBackgroundImage` | _未設定_ | `background` ホームページレイアウトと `background` ヒーロースタイルの両方のデフォルトの背景画像です。 | +| `defaultFeaturedImage` | _未設定_ | 記事全体のすべての `featured` 画像のデフォルトの背景画像です。ローカルの `featured` 画像によってオーバーライドされます。 | +| `highlightCurrentMenuArea` | _未設定_ | メインメニューのメニュー項目が選択されているときにマークを付けます。 | +| `smartTOC` | _未設定_ | スマート目次をアクティブにします。表示されている項目が強調表示されます。 | +| `smartTOCHideUnfocusedChildren` | _未設定_ | スマート目次がオンになっている場合、フォーカスされていないときに、テーブルのより深いレベルが非表示になります。 | + +### ヘッダー(Header) + +| 名前 | デフォルト | 説明 | +|---|---|---| +| `header.layout` | `"basic"` | サイト全体のヘッダーを定義します。サポートされている値は、`basic`、`fixed`、`fixed-fill`、`fixed-fill-blur` です。 | + +### フッター(Footer) + +| 名前 | デフォルト　　　 | 説明 | +|---|---|---| +| `footer.showMenu` | `true` | フッターメニューを表示/非表示にします。これは、`config/_default/menus.en.toml` ファイルの `[[footer]]` セクションで設定できます。 | +| `footer.showCopyright` | `true` | サイトのフッターに著作権文字列を表示するかどうかです。文字列自体は、[言語設定](#言語と-i18n) の `copyright` パラメータを使用してカスタマイズできることに注意してください。 | +| `footer.showThemeAttribution` | `true` | サイトのフッターに「powered by」というテーマの帰属を表示するかどうかです。このメッセージを無効にする場合は、サイトの他の場所（たとえば、about ページ）でテーマの帰属を検討してください。 | +| `footer.showAppearanceSwitcher` | `false` | サイトのフッターに外観スイッチャーを表示するかどうかです。 ブラウザのローカルストレージを使用して、訪問者の設定が保持されます。 | +| `footer.showScrollToTop` | `true` | `true` に設定すると、トップへスクロールの矢印が表示されます。 | + +### ホームページ(Homepage) + +| 名前 | デフォルト | 説明 | +|---|---|---| +| `homepage.layout` | `"profile"` | ホームページのレイアウトです。有効な値は、`page`、`profile`、`hero`、`card`、`background`、`custom` です。`custom` に設定した場合、`/layouts/partials/home/custom.html` ファイルを作成して独自のレイアウトを提供する必要があります。詳細については、[ホームページレイアウト]({{< ref "homepage-layout" >}}) セクションを参照してください。 | +| `homepage.homepageImage` | _未設定_ | `hero` レイアウトと `card` レイアウトで使用される画像です。アセットディレクトリからのローカル画像または外部画像 URL として設定できます。詳細については、[ホームページレイアウト]({{< ref "homepage-layout" >}}) セクションを参照してください。 | +| `homepage.showRecent` | `false` | ホームページに最近の記事リストを表示するかどうかです。 | +| `homepage.showRecentItems` | 5 | showRecent が true の場合に表示する記事の数です。変数が0に設定されている場合、または定義されていない場合は、システムはデフォルトで5つの記事に設定されます。 | +| `homepage.showMoreLink` | `false` | ユーザーを事前に定義された場所に移動する「もっと見る」リンクを投稿の最後に表示するかどうかです。 | +| `homepage.showMoreLinkDest` | `/posts` | 「もっと見る」ボタンの移動先です。 | +| `homepage.cardView` | `false` | 最近の記事をカードのギャラリーとして表示します。 | +| `homepage.cardViewScreenWidth` | `false` | 最近の記事カードギャラリーの幅を拡張して、利用可能な幅全体を使用します。 | +| `homepage.layoutBackgroundBlur` | `false` | ホームページレイアウトの背景画像をスクロールに合わせてぼかします。 | + +### 記事(Article) + +| 名前 | デフォルト　　　　 | 説明 | +|---|---|---| +| `article.showDate` | `true` | 記事の日付を表示するかどうかです。 | +| `article.showViews` | `false` | 記事の表示回数を表示するかどうかです。これには Firebase 統合を有効にする必要があります。以下をご覧ください。 | +| `article.showLikes` | `false` | 記事のいいねを表示するかどうかです。これには Firebase 統合を有効にする必要があります。以下をご覧ください。 | +| `article.showDateOnlyInArticle` | `false` | 記事リスト/カードに表示されていない場合でも、記事内に日付を表示します。 | +| `article.showDateUpdated` | `false` | 記事が更新された日付を表示するかどうかです。 | +| `article.showAuthor` | `true` | 記事のフッターに著者ボックスを表示するかどうかです。 | +| `article.showAuthorBottom` | `false` | 著者ボックスは、各ページの上部ではなく下部に表示されます。 | +| `article.showHero` | `false` | サムネイル画像を各記事ページ内でヒーロー画像として表示するかどうかです。 | +| `article.heroStyle` | _未設定_ | ヒーロー画像を表示するスタイルです。有効なオプションは、`basic`、`big`、`background`、`thumbAndBackground` です。 | +| `article.layoutBackgroundBlur` | `true` | 背景記事 heroStyle の背景画像をスクロールに合わせてぼかします。 | +| `article.layoutBackgroundHeaderSpace` | `true` | ヘッダーと本文の間にスペースを追加します。 | +| `article.showBreadcrumbs` | `false` | 記事のヘッダーにパンくずリストを表示するかどうかです。 | +| `article.showDraftLabel` | `true` | サイトが `--buildDrafts` でビルドされたときに、記事の横にドラフトインジケータを表示するかどうかです。 | +| `article.showEdit` | `false` | 記事コンテンツを編集するためのリンクを表示するかどうかです。 | +| `article.editURL` | _未設定_ | `article.showEdit` がアクティブな場合、編集リンクの URL です。 | +| `article.editAppendPath` | `true` | `article.showEdit` がアクティブな場合、現在の記事へのパスを `article.editURL` で設定された URL に追加するかどうかです。 | +| `article.seriesOpened` | `false` | シリーズモジュールがデフォルトで開いた状態で表示されるかどうかです。 | +| `article.showHeadingAnchors` | `true` | 記事内の見出しの横にアンカーリンク見出しを表示するかどうかです。 | +| `article.showPagination` | `true` | 記事のフッターに次/前の記事リンクを表示するかどうかです。 | +| `article.invertPagination` | `false` | 次/前の記事リンクの方向を反転するかどうかです。 | +| `article.showReadingTime` | `true` | 記事の読了時間を表示するかどうかです。 | +| `article.showTableOfContents` | `false` | 記事に目次を表示するかどうかです。 | +| `article.showRelatedContent` | `false` | 各投稿の関連記事を表示します。`config.toml` に追加の設定が必要になる場合があります。この機能を有効にする場合は、テーマの `config.toml` を確認し、関連するすべての _related_ エントリをコピーしてください。また、関連記事については [Hugo のドキュメント](https://gohugo.io/content-management/related/) も確認してください。 | +| `article.relatedContentLimit` | `3` | `showRelatedContent` がオンになっている場合に表示する関連記事の上限です。 | +| `article.showTaxonomies` | `false` | この記事に関連するタクソノミーを表示するかどうかです。 | +| `article.showAuthorsBadges` | `false` | `authors` タクソノミーを記事またはリストのヘッダーに表示するかどうかです。これには、「複数の著者」と `authors` タクソノミーの設定が必要です。この機能の設定方法の詳細については、[このページ]({{< ref "multi-author" >}}) を確認してください。 | +| `article.showWordCount` | `false` | 記事の単語数を表示するかどうかです。 | +| `article.showComments` | `false` | 記事のフッターの後に [コメントパーシャル]({{< ref "partials#コメント" >}}) を含めるかどうかです。 | +| `article.sharingLinks` | _未設定_ | 各記事の最後に表示する共有リンクです。指定されていないか、`false` に設定されている場合、リンクは表示されません。使用可能な値は、
"linkedin"、"bluesky"、
"mastodon"、"twitter"、"reddit"、
"pinterest"、"facebook"、"email"、
"whatsapp"、"telegram" です。 | +| `article.showZenMode` | `false` | 記事のZenモードリーダー機能を有効にするフラグです。 | + +### リスト(List) + +| 名前 | デフォルト　　　 | 説明 | +| ---------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `list.showHero` | `false` | 各リストページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | +| `list.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 | +| `list.showBreadcrumbs` | `false` | リストページのヘッダーにパンくずリストを表示するかどうか。 | +| `list.layoutBackgroundBlur` | `true` | `background` リストの heroStyle の背景画像をスクロールでぼかします。 | +| `list.layoutBackgroundHeaderSpace` | `true` | ヘッダーと本文の間にスペースを追加します。 | +| `list.showTableOfContents` | `false` | リストページに目次を表示するかどうか。 | +| `list.showSummary` | `false` | リストページに記事の要約を表示するかどうか。[フロントマター]({{< ref "front-matter" >}}) で要約が提供されていない場合、[サイト設定](#site-configuration) の `summaryLength` パラメータを使用して自動的に生成されます。 | +| `list.showViews` | `false` | リストの閲覧数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | +| `list.showLikes` | `false` | リストのいいね数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | +| `list.showCards` | `false` | 各記事をカードとして表示するか、シンプルなインラインテキストとして表示するかどうか。 | +| `list.orderByWeight` | `false` | 記事を[重み](https://gohugo.io/methods/page/weight/)で並べ替えるかどうか。 | +| `list.groupByYear` | `true` | リストページで記事を年別にグループ化するかどうか。 | +| `list.cardView` | `false` | リストをカードのギャラリーとして表示します。 | +| `list.cardViewScreenWidth` | `false` | リスト内のカードギャラリーの幅を、利用可能な全幅を使用するように拡張します。 | +| `list.constrainItemsWidth` | `false` | 読みやすくするために、アイテムの幅を `prose` に制限します。フィーチャー画像が利用できない場合に役立ちます。 | +| `list.showTableOfContents` | `false` | 記事に目次を表示するかどうか。 | + +### サイトマップ(Sitemap) + +| 名前 | デフォルト | 説明 | | ----------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `sitemap.excludedKinds` | `["taxonomy", "term"]` | Kinds of content that should be excluded from the generated `/sitemap.xml` file. Refer to the [Hugo docs](https://gohugo.io/templates/section-templates/#page-kinds) for acceptable values. | - -### Taxonomy - -| Name | Default | Description | -| ------------------------------ | --------- | ---------------------------------------------------------------------------------------------------------- | -| `taxonomy.showTermCount` | `true` | Whether or not the number of articles within a taxonomy term is displayed on the taxonomy listing. | -| `taxonomy.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each taxonomy page. | -| `taxonomy.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | -| `taxonomy.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the taxonomy header. | -| `taxonomy.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | -| `taxonomy.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | -| `taxonomy.showTableOfContents` | `false` | Whether or not the table of contents is displayed on taxonomies. | -| `taxonomy.cardView` | `false` | Display lists as a gallery of cards. | - -### Term - -| Name | Default | Description | -| -------------------------- | --------- | ---------------------------------------------------------------------------------------------------------- | -| `term.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each term page. | -| `term.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | -| `term.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the term header. | -| `term.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | -| `term.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | -| `term.showTableOfContents` | `false` | Whether or not the table of contents is displayed on terms. | -| `term.groupByYear` | `false` | Whether or not articles are grouped by year on term pages. | -| `term.cardView` | `false` | Display lists as a gallery of cards. | -| `term.cardViewScreenWidth` | `false` | Enhance the width of card galleries in lists to take the full width available. | +| `sitemap.excludedKinds` | `["taxonomy", "term"]` | 生成された `/sitemap.xml` ファイルから除外するコンテンツの種類。許容される値については、[Hugo のドキュメント](https://gohugo.io/templates/section-templates/#page-kinds)を参照してください。 | + +### タクソノミー(Taxonomy) + +| 名前 | デフォルト　　 | 説明 | +| ------------------------------ | --------- | ----------------------------------------------------------------------------------------------------------------- | +| `taxonomy.showTermCount` | `true` | タクソノミーリストにタクソノミー用語内の記事数を表示するかどうか。 | +| `taxonomy.showHero` | `false` | 各タクソノミーページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | +| `taxonomy.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 | +| `taxonomy.showBreadcrumbs` | `false` | タクソノミーのヘッダーにパンくずリストを表示するかどうか。 | +| `taxonomy.showViews` | `false` | 記事の閲覧数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | +| `taxonomy.showLikes` | `false` | 記事のいいね数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | +| `taxonomy.showTableOfContents` | `false` | タクソノミーに目次を表示するかどうか。 | +| `taxonomy.cardView` | `false` | リストをカードのギャラリーとして表示します。 | + +### ターム(Term) + +| 名前 | デフォルト　　 | 説明 | +| -------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------- | +| `term.showHero` | `false` | 各タームページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | +| `term.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 | +| `term.showBreadcrumbs` | `false` | タームのヘッダーにパンくずリストを表示するかどうか。 | +| `term.showViews` | `false` | 記事の閲覧数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | +| `term.showLikes` | `false` | 記事のいいね数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | +| `term.showTableOfContents` | `false` | タームに目次を表示するかどうか。 | +| `term.groupByYear` | `false` | タームページで記事を年別にグループ化するかどうか。 | +| `term.cardView` | `false` | リストをカードのギャラリーとして表示します。 | +| `term.cardViewScreenWidth` | `false` | リスト内のカードギャラリーの幅を、利用可能な全幅を使用するように拡張します。 | ### Firebase -| Name | Default | Description | -| ---------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `firebase.apiKey` | _Not set_ | Firebase apiKey, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | -| `firebase.authDomain` | _Not set_ | Firebase authDomain, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | -| `firebase.projectId` | _Not set_ | Firebase projectId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | -| `firebase.storageBucket` | _Not set_ | Firebase storageBucket, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | -| `firebase.messagingSenderId` | _Not set_ | Firebase messagingSenderId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | -| `firebase.appId` | _Not set_ | Firebase appId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | -| `firebase.measurementId` | _Not set_ | Firebase measurementId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. | +| 名前 | デフォルト　　　 | 説明 | +| ---------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `firebase.apiKey` | _未設定_ | Firebase との統合に必要な Firebase API キー。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | +| `firebase.authDomain` | _未設定_ | Firebase との統合に必要な Firebase 認証ドメイン。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | +| `firebase.projectId` | _未設定_ | Firebase との統合に必要な Firebase プロジェクト ID。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | +| `firebase.storageBucket` | _未設定_ | Firebase との統合に必要な Firebase ストレージバケット。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | +| `firebase.messagingSenderId` | _未設定_ | Firebase との統合に必要な Firebase メッセージング送信者 ID。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | +| `firebase.appId` | _未設定_ | Firebase との統合に必要な Firebase アプリ ID。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | +| `firebase.measurementId` | _未設定_ | Firebase との統合に必要な Firebase 測定 ID。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})を参照してください。 | ### Fathom Analytics -| Name | Default | Description | -| ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -| `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. | +| 名前 | デフォルト　　　 | 説明 | +| ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `fathomAnalytics.site` | _未設定_ | ウェブサイト用に Fathom Analytics によって生成されたサイトコード。詳細については、[Analytics のドキュメント]({{< ref "partials#アナリティクス" >}})を参照してください。 | +| `fathomAnalytics.domain` | _未設定_ | Fathom Analytics でカスタムドメインを使用している場合、ここに指定して、`script.js` をカスタムドメインから配信します。 | ### 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. | -| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". | -| `umamiAnalytics.scriptName` | script.js | The name of the `script.js` used for anti-ad-blocking is configured by the environment variable `TRACKER_SCRIPT_NAME` | -| `umamiAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. | +| 名前 | デフォルト　　　 | 説明 | +|---|---|---| +| `umamiAnalytics.websiteid` | _未設定_ | ウェブサイト用に Umami Analytics によって生成されたサイトコード。詳細については、[Analytics のドキュメント]({{< ref "partials#アナリティクス" >}})を参照してください。 | +| `umamiAnalytics.domain` | _未設定_ | Umami Analytics でカスタムドメインを使用している場合、ここに指定して、`script.js` をカスタムドメインから配信します。 | +| `umamiAnalytics.dataDomains` | _未設定_ | トラッカーを特定のドメインでのみ実行したい場合は、トラッカースクリプトに指定します。これは、ドメイン名のカンマ区切りリストです。例えば "yoursite.com,yoursite2.com" のようになります。 | +| `umamiAnalytics.scriptName` | script.js | アンチ広告ブロックに使用される `script.js` の名前は、環境変数 `TRACKER_SCRIPT_NAME` で設定されます。 | +| `umamiAnalytics.enableTrackEvent` | `true` | `true` に設定すると、トラックイベントが自動的に追加されます。トラックイベントを追加したくない場合は、`false` に設定してください。 | ### Seline Analytics -| Name | Default | Description | +| 名前 | デフォルト　　　 | 説明 | |-----------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------| -| `selineAnalytics.token` | _Not set_ | The token generated by Seline Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. | -| `selineAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. | +| `selineAnalytics.token` | _未設定_ | ウェブサイト用に Seline Analytics によって生成されたトークン。詳細については、[Analytics のドキュメント]({{< ref "partials#アナリティクス" >}})を参照してください。 | +| `selineAnalytics.enableTrackEvent` | `true` | `true` に設定すると、トラックイベントが自動的に追加されます。トラックイベントを追加したくない場合は、`false` に設定してください。 | ### BuyMeACoffee -| Name | Default | Description | -| ----------------------------------- | --------- | --------------------------------------------------------------------------- | -| `buymeacoffee.identifier` | _Not set_ | The identifier to the target buymeacoffee account. | -| `buymeacoffee.globalWidget` | _Not set_ | Activate the global buymeacoffee widget. | -| `buymeacoffee.globalWidgetMessage` | _Not set_ | Message what will be displayed the first time a new user lands on the site. | -| `buymeacoffee.globalWidgetColor` | _Not set_ | Widget color in hex format. | -| `buymeacoffee.globalWidgetPosition` | _Not set_ | Position of the widget, i.e. "Left" or "Right" | - -### Verifications - -| Name | Default | Description | -| ------------------------ | --------- | --------------------------------------------------------------------------------------- | -| `verification.google` | _Not set_ | The site verification string provided by Google to be included in the site metadata. | -| `verification.bing` | _Not set_ | The site verification string provided by Bing to be included in the site metadata. | -| `verification.pinterest` | _Not set_ | The site verification string provided by Pinterest to be included in the site metadata. | -| `verification.yandex` | _Not set_ | The site verification string provided by Yandex to be included in the site metadata. | +| 名前 | デフォルト　　 | 説明 | +| ----------------------------------- | --------- | -------------------------------------------------------------------------------------- | +| `buymeacoffee.identifier` | _未設定_ | ターゲットの buymeacoffee アカウントの識別子。 | +| `buymeacoffee.globalWidget` | _未設定_ | グローバル buymeacoffee ウィジェットを有効にします。 | +| `buymeacoffee.globalWidgetMessage` | _未設定_ | 新しいユーザーが初めてサイトにアクセスしたときに表示されるメッセージ。 | +| `buymeacoffee.globalWidgetColor` | _未設定_ | ウィジェットの色（16進数形式）。 | +| `buymeacoffee.globalWidgetPosition` | _未設定_ | ウィジェットの位置。例えば "Left" または "Right" | + +### verification + +| 名前 | デフォルト　 | 説明 | +| ------------------------ | --------- | ------------------------------------------------------------------------------------------------------- | +| `verification.google` | _未設定_ | サイトメタデータに含まれる、Google が提供するサイト確認文字列。 | +| `verification.bing` | _未設定_ | サイトメタデータに含まれる、Bing が提供するサイト確認文字列。 | +| `verification.pinterest` | _未設定_ | サイトメタデータに含まれる、Pinterest が提供するサイト確認文字列。 | +| `verification.yandex` | _未設定_ | サイトメタデータに含まれる、Yandex が提供するサイト確認文字列。 | ## RSSNext -| Name | Default | Description | -| ------------------------ | --------- |--------------------------------------------------------------------------------------------------------------------------------------| -| `rssnext.feedId` | _Not set_ | The rss `feedId` string provided by [RSSNext/Follow](https://follow.is/) to be included in the `rss.xml`, which can helps to claim rss feed as your own. | -| `rssnext.userId` | _Not set_ | The rss `userId` string provided by [RSSNext/Follow](https://follow.is/) to be included in the `rss.xml`, which can helps to claim rss feed as your own. | +| 名前 | デフォルト　　　 | 説明 | +| ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `rssnext.feedId` | _未設定_ | [RSSNext/Follow](https://follow.is/) によって提供される rss `feedId` 文字列。`rss.xml` に含まれ、rss フィードを自身のものとしてクレームするのに役立ちます。 | +| `rssnext.userId` | _未設定_ | [RSSNext/Follow](https://follow.is/) によって提供される rss `userId` 文字列。`rss.xml` に含まれ、rss フィードを自身のものとしてクレームするのに役立ちます。 | -## Other configuration files +## その他の設定ファイル -The theme also includes a `markup.toml` configuration file. This file contains some important parameters that ensure that Hugo is correctly configured to generate sites built with Blowfish. +このテーマには `markup.toml` 設定ファイルも含まれています。このファイルには、Hugo が Blowfish で構築されたサイトを正しく生成するために重要なパラメータがいくつか含まれています。 -Always ensure this file is present in the config directory and that the required values are set. Failure to do so may cause certain features to function incorrectly and could result in unintended behaviour. +このファイルが常に config ディレクトリに存在し、必要な値が設定されていることを確認してください。そうしないと、特定の機能が正しく機能せず、意図しない動作を引き起こす可能性があります。 diff --git a/exampleSite/content/docs/content-examples/index.ja.md b/exampleSite/content/docs/content-examples/index.ja.md index 352701952..c986daa42 100644 --- a/exampleSite/content/docs/content-examples/index.ja.md +++ b/exampleSite/content/docs/content-examples/index.ja.md @@ -1,63 +1,63 @@ --- -title: "Content Examples" +title: "コンテンツの例" weight: 11 draft: false -description: "All the partials available in Blowfish." +description: "Blowfish で利用可能なすべてのパーシャル。" slug: "content-examples" tags: ["content", "example"] series: ["Documentation"] series_order: 12 --- -If you've been reading the documentation in order, you should now know about all the features and configurations available in Blowfish. This page is designed to pull everything together and offer some worked examples that you might like to use in your Hugo project. +ドキュメントを順に読んできた方なら、Blowfish で利用可能なすべての機能と設定について、すでにご存じでしょう。このページでは、これまで説明してきたすべてをまとめて、Hugo プロジェクトで使用できる実践的なサンプルを紹介します。 {{< alert >}} -**Tip:** If you're new to Hugo, be sure to check out the [official docs](https://gohugo.io/content-management/page-bundles/) to learn more about the concept of page bundles and resources. +**ヒント:** Hugo を初めて使用する場合は、[公式ドキュメント](https://gohugo.io/content-management/page-bundles/)でページバンドルとリソースの概念について、さらに詳しく学習することをお勧めします。 {{< /alert >}} -The examples on this page can all be adapted to different scenarios but hopefully give you some ideas about how to approach formatting a particular content item for your individual project. +このページの例は、さまざまなシナリオに適応できます。あなたのプロジェクトで、特定のコンテンツをどのようにフォーマットするか、そのヒントになれば幸いです。 -## Branch pages +## ブランチページ -Branch page bundles in Hugo cover items like the homepage, section listings, and taxonomy pages. The important thing to remember about branch bundles is that the filename for this content type is **`_index.md`**. +Hugo のブランチページバンドルは、ホームページ、セクションリスト、タクソノミーページなどを指します。ブランチバンドルで覚えておくべき重要なことは、このコンテンツタイプのファイル名が **`_index.md`** であることです。 -Blowfish will honour the front matter parameters specified in branch pages and these will override the default settings for that particular page. For example, setting the `title` parameter in a branch page will allow overriding the page title. +Blowfish は、ブランチページで指定された Front Matter のパラメータを認識し、特定のページのデフォルト設定を上書きします。例えば、ブランチページで `title` パラメータを設定すると、そのページのタイトルを上書きできます。 -### Homepage +### ホームページ | | | | ------------ | -------------------- | -| **Layout:** | `layouts/index.html` | -| **Content:** | `content/_index.md` | +| **レイアウト:** | `layouts/index.html` | +| **コンテンツ:** | `content/_index.md` | -The homepage in Blowfish is special in that it's overarching design is controlled by the homepage layout config parameter. You can learn more about this in the [Homepage Layout]({{< ref "homepage-layout" >}}) section. +Blowfish のホームページは、その全体デザインがホームページレイアウト設定パラメータによって制御される、特別なページです。詳細は[ホームページレイアウト]({{< ref "homepage-layout" >}})セクションをご覧ください。 -If you want to add custom content to this page, you simply need to create a `content/_index.md` file. Anything in this file will then be included in your homepage. +ホームページに独自のコンテンツを追加するには、`content/_index.md` ファイルを作成するだけです。このファイルの内容が、ホームページに表示されます。 -**Example:** +**例:** ```yaml --- -title: "Welcome to Blowfish!" -description: "This is a demo of adding content to the homepage." +title: "Blowfish へようこそ!" +description: "ホームページにコンテンツを追加するデモです。" --- -Welcome to my website! I'm really happy you stopped by. +私のウェブサイトへようこそ! お越しいただき、本当に嬉しいです。 ``` -_This example sets a custom title and adds some additional text to the body of the page. Any Markdown formatted text is acceptable, including shortcodes, images and links._ +_この例では、独自のタイトルを設定し、ページ本文にテキストを追加しています。ショートコード、画像、リンクなど、Markdown 形式のテキストはすべて使用できます。_ -### List pages +### リストページ | | | | ------------ | ---------------------------- | -| **Layout:** | `layouts/_default/list.html` | -| **Content:** | `content/../_index.md` | +| **レイアウト:** | `layouts/_default/list.html` | +| **コンテンツ:** | `content/../_index.md` | -List pages group all the pages within into a section and provide a way for visitors to reach each page. A blog or portfolio are examples of a list page as they group together posts or projects. +リストページは、セクション内の全ページをまとめて、訪問者が各ページを閲覧できるようにします。ブログやポートフォリオは、投稿やプロジェクトをまとめるリストページの代表例です。 -Creating a list page is as simple as making a sub-directory in the content folder. For example, to create a "Projects" section, you would create `content/projects/`. Then create a Markdown file for each of your projects. +リストページは、コンテンツフォルダ内にサブディレクトリを作成するだけで簡単に作成できます。例えば、「プロジェクト」セクションを作成するには、`content/projects/` を作成します。そして、各プロジェクト用の Markdown ファイルを作成します。 -A list page will be generated by default, however to customise the content, you should also create an `_index.md` page in this new directory. +リストページはデフォルトで生成されますが、コンテンツをカスタマイズするには、この新しいディレクトリ内に `_index.md` ファイルも作成する必要があります。 ```shell . @@ -70,39 +70,39 @@ A list page will be generated by default, however to customise the content, you └── project.jpg ``` -Hugo will generate URLs for the pages in your projects folder accordingly. +Hugo は、projects フォルダ内の各ページに対して、適切な URL を自動生成します。 -Just like the homepage, content in the `_index.md` file will be output into the generated list index. Blowfish will then list any pages in this section below the content. +ホームページと同様に、`_index.md` ファイルの内容は、生成されたリストのインデックスページに表示されます。そして、Blowfish は、そのセクション内のページをコンテンツの下に一覧表示します。 -**Example:** +**例:** ```yaml --- -title: "Projects" -description: "Learn about some of my projects." +title: "プロジェクト" +description: "私のプロジェクトのいくつかをご紹介します。" cascade: showReadingTime: false --- -This section contains all my current projects. +このセクションでは、私の現在進行中のプロジェクトを紹介しています。 ``` -_In this example, the special `cascade` parameter is being used to hide the reading time on any sub-pages within this section. By doing this, any project pages will not have their reading time showing. This is a great way to override default theme parameters for an entire section without having to include them in every individual page._ +_この例では、特別な `cascade` パラメータを使用して、このセクション内の各ページの閲覧時間を非表示にしています。これにより、各プロジェクトページでは閲覧時間が表示されなくなります。これは、個々のページにパラメータを記述することなく、セクション全体のデフォルトのテーマパラメータを上書きできる便利な方法です。_ -The [samples section]({{< ref "samples" >}}) of this site is an example of a list page. +このサイトの[サンプルセクション]({{< ref "samples" >}})は、リストページの活用例です。 -### Taxonomy pages +### タクソノミーページ | | | | ---------------- | -------------------------------- | -| **List layout:** | `layouts/_default/taxonomy.html` | -| **Term layout:** | `layouts/_default/term.html` | -| **Content:** | `content/../_index.md` | +| **リストレイアウト:** | `layouts/_default/taxonomy.html` | +| **タームレイアウト:** | `layouts/_default/term.html` | +| **コンテンツ:** | `content/../_index.md` | -Taxonomy pages come in two forms - taxonomy lists and taxonomy terms. Lists display a listing of each of the terms within a given taxonomy, while terms display a list of pages that are related to a given term. +タクソノミーページには、「タクソノミーリスト」と「タクソノミーターム」の2種類があります。リストは特定のタクソノミー内の各タームの一覧を表示し、タームは特定のタームに関連付けられたページ一覧を表示します。 -The terminology can get a little confusing so let's explore an example using a taxonomy named `animals`. +少し複雑に感じるかもしれないので、`animals` というタクソノミーを例に説明します。 -Firstly, to use taxonomies in Hugo, they have to be configured. This is done by creating a config file at `config/_default/taxonomies.toml` and defining the taxonomy name. +まず、Hugo でタクソノミーを使用するには、設定が必要です。`config/_default/taxonomies.toml` に設定ファイルを作成し、タクソノミー名を定義しましょう。 ```toml # config/_default/taxonomies.toml @@ -110,27 +110,27 @@ Firstly, to use taxonomies in Hugo, they have to be configured. This is done by animal = "animals" ``` -Hugo expects taxonomies to be listed using their singular and plural forms, so we add the singular `animal` equals the plural `animals` to create our example taxonomy. +Hugo ではタクソノミーを単数形と複数形で設定する必要があるため、ここでは `animal` (単数形) = `animals` (複数形) として、サンプルのタクソノミーを作成します。 -Now that our `animals` taxonomy exists, it needs to be added to individual content items. It's as simple as inserting it into the front matter: +`animals` タクソノミーが作成できたので、次はこれを個々のコンテンツに追加します。フロントマターに以下のように記述するだけです。 ```yaml --- -title: "Into the Lion's Den" -description: "This week we're learning about lions." +title: "ライオンの巣窟へ" +description: "今週はライオンについて学びます。" animals: ["lion", "cat"] --- ``` -This has now created two _terms_ within our `animals` taxonomy - `lion` and `cat`. +これで、`animals` タクソノミー内に `lion` と `cat` という2つの _ターム_ が作成されました。 -Although it's not obvious at this point, Hugo will now be generating list and term pages for this new taxonomy. By default the listing can be accessed at `/animals/` and the term pages can be found at `/animals/lion/` and `/animals/cat/`. +この時点ではまだ分かりませんが、Hugo はこの新しいタクソノミーのために、リストページとタームページを自動生成します。デフォルトでは、リストページは `/animals/`、タームページは `/animals/lion/` と `/animals/cat/` でアクセスできます。 -The list page will list all the terms contained within the taxonomy. In this example, navigating to `/animals/` will show a page that has links for "lion" and "cat" which take visitors to the individual term pages. +リストページには、タクソノミーに含まれるすべてのタームが一覧表示されます。この例では、`/animals/` にアクセスすると、「lion」と「cat」へのリンクが表示され、それぞれのタームページへ移動できます。 -The term pages will list all the pages contained within that term. These term lists are essentially the same as normal [list pages](#list-pages) and behave in much the same way. +タームページには、そのタームに関連付けられたすべてのページが表示されます。タームリストは、基本的に通常の[リストページ](#リストページ)と同じで、ほぼ同様に機能します。 -In order to add custom content to taxonomy pages, simply create `_index.md` files in the content folder using the taxonomy name as the sub-directory name. +タクソノミーページに独自のコンテンツを追加するには、タクソノミー名をサブディレクトリ名として、`content` フォルダ内に `_index.md` ファイルを作成するだけです。 ```shell . @@ -141,21 +141,21 @@ In order to add custom content to taxonomy pages, simply create `_index.md` file └── _index.md # /animals/lion ``` -Anything in these content files will now be placed onto the generated taxonomy pages. As with other content, the front matter variables can be used to override defaults. In this way you could have a tag named `lion` but override the `title` to be "Lion". +これらのファイルに記述した内容はすべて、自動生成されたタクソノミーページに表示されます。他のコンテンツと同様に、フロントマターの変数を使用してデフォルト値を上書きできます。例えば、`lion` というタグ名を付けつつ、`title` を「Lion」と表示することも可能です。 -To see how this looks in reality, check out the [tags taxonomy listing]({{< ref "tags" >}}) on this site. +実際の表示例は、このサイトの[タグタクソノミーリスト]({{< ref "tags" >}})をご覧ください。 -## Leaf pages +## リーフページ | | | | ------------------------- | ------------------------------- | -| **Layout:** | `layouts/_default/single.html` | -| **Content (standalone):** | `content/../page-name.md` | -| **Content (bundled):** | `content/../page-name/index.md` | +| **レイアウト:** | `layouts/_default/single.html` | +| **コンテンツ (スタンドアロン):** | `content/../page-name.md` | +| **コンテンツ (バンドル):** | `content/../page-name/index.md` | -Leaf pages in Hugo are basically standard content pages. They are defined as pages that don't contain any sub-pages. These could be things like an about page, or an individual blog post that lives in the blog section of the website. +Hugo のリーフページは、基本的に標準的なコンテンツページです。サブページを含まないページとして定義されます。例えば、自己紹介ページや、ウェブサイトのブログセクションにある個別のブログ記事などが該当します。 -The most important thing to remember about leaf pages is that unlike branch pages, leaf pages should be named `index.md` _without_ an underscore. Leaf pages are also special in that they can be grouped together at the top level of the section and named with a unique name. +リーフページで最も重要なのは、ブランチページとは異なり、ファイル名をアンダースコアを _付けずに_ `index.md` とすることです。また、リーフページはセクションのトップレベルでグループ化し、それぞれに固有の名前を付けられるという点でも特別です。 ```shell . @@ -168,35 +168,35 @@ The most important thing to remember about leaf pages is that unlike branch page └── image.jpg ``` -When including assets in a page, like an image, a page bundle should be used. Page bundles are created using a sub-directory with an `index.md` file. Grouping the assets with the content in its own directory is important as many of the shortcodes and other theme logic assumes that resources are bundled alongside pages. +画像などのアセットをページに含める場合は、ページバンドルを使用する必要があります。ページバンドルは、`index.md` ファイルを含むサブディレクトリを使用して作成します。多くのショートコードやその他のテーマロジックは、リソースがページと共にバンドルされていることを前提としているため、アセットとコンテンツを独自のディレクトリにまとめておくことが重要です。 -**Example:** +**例:** ```yaml --- -title: "My First Blog Post" +title: "初めてのブログ記事" date: 2022-01-25 -description: "Welcome to my blog!" -summary: "Learn more about me and why I am starting this blog." +description: "私のブログへようこそ!" +summary: "私自身と、このブログを始めた理由についてご紹介します。" tags: ["welcome", "new", "about", "first"] --- -_This_ is the content of my blog post. +_これ_ が私のブログ記事の本文です。 ``` -Leaf pages have a wide variety of [front matter]({{< ref "front-matter" >}}) parameters that can be used to customise how they are displayed. +リーフページでは、表示方法をカスタマイズするために、様々な[フロントマター]({{< ref "front-matter" >}})パラメータを使用できます。 -### External links +### 外部リンク -Blowfish has a special feature that allows links to external pages to appear alongside articles in the article listings. This is useful if you have content on third party websites like Medium, or research papers that you'd like to link to, without replicating the content in your Hugo site. +Blowfish には、記事リストの記事と一緒に外部リンクを表示できる特別な機能があります。これは、Medium などのサードパーティのウェブサイトにコンテンツがある場合や、Hugo サイトにコンテンツを複製せずにリンクしたい研究論文がある場合に便利です。 -In order to create an external link article, some special front matter needs to be set: +外部リンク記事を作成するには、特別なフロントマターを設定する必要があります。 ```yaml --- -title: "My Medium post" +title: "私の Medium 記事" date: 2022-01-25 externalUrl: "https://medium.com/" -summary: "I wrote a post on Medium." +summary: "Medium に記事を投稿しました。" showReadingTime: false _build: render: "false" @@ -204,57 +204,57 @@ _build: --- ``` -Along with the normal front matter parameters like `title` and `summary`, the `externalUrl` parameter is used to tell Blowfish that this is not an ordinary article. The URL provided here will be where visitors are directed when they select this article. +`title` や `summary` などの通常の Front Matter パラメータに加えて、`externalUrl` パラメータは、これが通常の記事ではないことを Blowfish に伝えるために使用されます。ここに指定された URL は、訪問者がこの記事を選択した際にリダイレクトされる場所です。 -Additionally, we use a special Hugo front matter parameter `_build` to prevent a normal page for this content being generated - there's no point generating a page since we're linking to an external URL! +さらに、特別な Hugo フロントマターパラメータ `_build` を使用して、このコンテンツの通常のページが生成されないようにします。外部リンクにリダイレクトするため、ページを生成する必要はありません。 -The theme includes an archetype to make generating these external link articles simple. Just specify `-k external` when making new content. +テーマには、外部リンク記事を簡単に作成するためのアーキタイプが含まれています。新しいコンテンツを作成する際に、`-k external` を指定するだけです。 ```shell hugo new -k external posts/my-post.md ``` -### Simple pages +### シンプルページ | | | | ----------------- | ------------------------------ | -| **Layout:** | `layouts/_default/simple.html` | -| **Front Matter:** | `layout: "simple"` | +| **レイアウト:** | `layouts/_default/simple.html` | +| **フロントマター:** | `layout: "simple"` | -Blowfish also includes a special layout for simple pages. The simple layout is a full-width template that just places Markdown content into the page without any special theme features. +Blowfish には、シンプルなページ用の特別なレイアウトも用意されています。シンプルレイアウトは、特別なテーマ機能を使用せずに、Markdown コンテンツのみを表示する全幅テンプレートです。 -The only features available in the simple layout are breadcrumbs and sharing links. However, the behaviour of these can still be controlled using the normal page [front matter]({{< ref "front-matter" >}}) variables. +シンプルレイアウトで利用できる機能は、パンくずリストと共有リンクのみです。ただし、これらの動作は、通常のページの[フロントマター]({{< ref "front-matter" >}})変数を使用して制御できます。 -To enable the simple layout on a particular page, add the `layout` front matter variable with a value of `"simple"`: +特定のページでシンプルレイアウトを有効にするには、`layout` フロントマター変数に値 `"simple"` を設定します。 ```yaml --- -title: "My landing page" +title: "私のランディングページ" date: 2022-03-08 layout: "simple" --- -This page content is now full-width. +このページのコンテンツは全幅で表示されます。 ``` -## Custom layouts +## カスタムレイアウト -One of the benefits of Hugo is that it makes it easy to create custom layouts for the whole site, individual sections or pages. +Hugo の利点の 1 つは、サイト全体、個別のセクション、またはページごとに、簡単にカスタムレイアウトを作成できることです。 -Layouts follow all the normal Hugo templating rules and more information is available in the [official Hugo docs](https://gohugo.io/templates/introduction/). +レイアウトは、通常の Hugo テンプレートルールに従います。詳細は[公式 Hugo ドキュメント](https://gohugo.io/templates/introduction/)をご覧ください。 -### Overriding default layouts +### デフォルトレイアウトの上書き -Each of the content types discussed above lists the layout file that is used to generate each type of page. If this file is created in your local project it will override the theme template and thus can be used to customise the default style of the website. +上記の各コンテンツタイプには、それぞれのタイプのページを生成するために使用されるレイアウトファイルが記載されています。このファイルをローカルプロジェクトで作成すると、テーマのテンプレートが上書きされるため、ウェブサイトのデフォルトスタイルをカスタマイズできます。 -For example, creating a `layouts/_default/single.html` file will allow the layout of leaf pages to be completely customised. +例えば、`layouts/_default/single.html` ファイルを作成すると、リーフページのレイアウトを完全にカスタマイズできます。 -### Custom section layouts +### カスタムセクションレイアウト -It is also simple to create custom layouts for individual content sections. This is useful when you want to make a section that lists a certain type of content using a particular style. +個々のコンテンツセクション用に、カスタムレイアウトを作成することも簡単です。特定のスタイルを使用して、特定のタイプのコンテンツを一覧表示するセクションを作成したい場合に便利です。 -Let's step through an example that creates a custom "Projects" page that lists projects using a special layout. +特別なレイアウトを使用してプロジェクトを一覧表示する、カスタム「プロジェクト」ページを作成する例を見てみましょう。 -In order to do this, structure your content using the normal Hugo content rules and create a section for your projects. Additionally, create a new layout for the projects section by using the same directory name as the content and adding a `list.html` file. +まず、通常の Hugo コンテンツルールに従ってコンテンツを構成し、プロジェクト用のセクションを作成します。次に、コンテンツと同じディレクトリ名を使用し、`list.html` ファイルを追加して、プロジェクトセクション用の新しいレイアウトを作成します。 ```shell . @@ -268,22 +268,22 @@ In order to do this, structure your content using the normal Hugo content rules └── list.html ``` -This `list.html` file will now override the default list template, but only for the `projects` section. Before we look at this file, lets first look at the individual project files. +この `list.html` ファイルは、デフォルトのリストテンプレートを上書きしますが、`projects` セクションに対してのみ有効です。このファイルの中身を見る前に、まず個々のプロジェクトファイルを見てみましょう。 ```yaml --- title: "Blowfish" date: 2021-08-11 icon: "github" -description: "A theme for Hugo built with Tailwind CSS." +description: "Tailwind CSS を使用して構築された Hugo テーマ。" topics: ["Hugo", "Web", "Tailwind"] externalUrl: "https://github.com/nunocoracao/blowfish/" --- ``` -_In this example we are assigning some metadata for each project that we can then use in our list template. There's no page content, but there's nothing stopping you from including it. It's your own custom template after all!_ +_ここでは、各プロジェクトのメタデータを設定しています。このメタデータは、後ほどリストテンプレートで使用できます。ページコンテンツはありませんが、必要に応じて追加することも可能です。あなた独自のカスタムテンプレートですから!_ -With the projects defined, now we can create a list template that outputs the details of each project. +プロジェクトが定義できたので、次は各プロジェクトの詳細を出力するリストテンプレートを作成しましょう。 ```go {{ define "main" }} @@ -311,8 +311,8 @@ With the projects defined, now we can create a list template that outputs the de {{ end }} ``` -Although this is quite a straightforward example, you can see that it steps through each of the pages in this section (ie. each project), and then outputs HTML links to each project alongside an icon. The metadata in the front matter for each project is used to determine which information is displayed. +これは非常にシンプルな例ですが、このセクションの各ページ (つまり、各プロジェクト) を順に処理し、アイコンと共に各プロジェクトへの HTML リンクを出力しています。各プロジェクトのフロントマターのメタデータは、表示される情報を決定するために使用されます。 -Keep in mind that you'll need to ensure the relevant styles and classes are available, which may require the Tailwind CSS to be recompiled. This is discussed in more detail in the [Advanced Customisation]({{< ref "advanced-customisation" >}}) section. +関連するスタイルとクラスが利用可能であることを確認する必要があることに注意してください。場合によっては、Tailwind CSS の再コンパイルが必要になる場合があります。これについては、[高度なカスタマイズ]({{< ref "advanced-customisation" >}})セクションで詳しく説明しています。 -When making custom templates like this one, it's always easiest to take a look at how the default Blowfish template works and then use that as a guide. Remember, the [Hugo docs](https://gohugo.io/templates/introduction/) are a great resource to learn more about creating templates too. +このようなカスタムテンプレートを作成する際には、まずデフォルトの Blowfish テンプレートの動作を確認し、それを参考にすることをお勧めします。[Hugo ドキュメント](https://gohugo.io/templates/introduction/)も、テンプレート作成について学ぶための優れた情報源です。 diff --git a/exampleSite/content/docs/firebase-views/index.ja.md b/exampleSite/content/docs/firebase-views/index.ja.md index 254056b86..16fc008c6 100644 --- a/exampleSite/content/docs/firebase-views/index.ja.md +++ b/exampleSite/content/docs/firebase-views/index.ja.md @@ -1,30 +1,30 @@ --- -title: "Firebase: Views & Likes" +title: "Firebase: 閲覧数といいね" weight: 15 draft: false -description: "Learn how to integrate Firebase and get dynamic data for views and likes." +description: "Firebase を統合して、閲覧数といいねの動的データを取得する方法を学びます。" slug: "firebase-views" -tags: ["firebase", "views", likes] +tags: ["firebase", "views", "likes"] series: ["Documentation"] series_order: 15 --- -In order to be able to support dynamic data across your website we've added the support to integrate Firebase. This will allow you to use the views feature across lists and posts. +ウェブサイト全体で動的データをサポートできるようにするために、Firebase を統合するサポートを追加しました。これにより、リストや投稿全体で閲覧数機能を使用できるようになります。 -1. Go to Firebase website and create an account for free -2. Create a new project -3. Select analytics location -4. Setup firebase in Blowfish by getting the variables for your project and setting them inside `params.toml` file. More details can be found in }}">this page. You can find an example of the file Firebase will provide below, notice the parameters within the FirebaseConfig object. +1. Firebase のウェブサイトにアクセスして、無料のアカウントを作成します +2. 新規プロジェクトを作成します +3. 分析ロケーションを選択します +4. プロジェクトの変数を取得し、`params.toml` ファイル内で設定して、Blowfish で Firebase を設定します。詳細は、}}">このページをご覧ください。Firebase が提供するファイルの例を以下に示します。FirebaseConfig オブジェクト内のパラメータに注意してください。 ``` -// Import the functions you need from the SDKs you need +// 必要な SDK から必要な関数をインポートします import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; -// TODO: Add SDKs for Firebase products that you want to use +// TODO: 使用する Firebase 製品の SDK を追加します // https://firebase.google.com/docs/web/setup#available-libraries -// Your web app's Firebase configuration -// For Firebase JS SDK v7.20.0 and later, measurementId is optional +// ウェブアプリの Firebase 設定 +// Firebase JS SDK v7.20.0 以降では、measurementId はオプションです const firebaseConfig = { apiKey: "AIzaSyB5tqlqDky77Vb4Tc4apiHV4hRZI18KGiY", authDomain: "blowfish-21fff.firebaseapp.com", @@ -35,12 +35,12 @@ const firebaseConfig = { measurementId: "G-PEDMYR1V0K" }; -// Initialize Firebase +// Firebase を初期化する const app = initializeApp(firebaseConfig); const analytics = getAnalytics(app); ``` -5. Setup Firestore - Select Build and open Firestore. Create a new database and choose to start in production mode. Select server location and wait. Once that is started you need to configure the rules. Just copy and paste the file below and press publish. +5. Firestore を設定する - 「ビルド」を選択して Firestore を開きます。新しいデータベースを作成し、本番モードで開始することを選択します。サーバーの場所を選択して待ちます。開始したら、ルールを設定する必要があります。以下のファイルをコピーして貼り付け、「公開」をクリックします。 ``` rules_version = '2'; service cloud.firestore { @@ -51,5 +51,5 @@ service cloud.firestore { } } ``` -6. Enable anonymous authorization - Select Build and open Authentication. Select get started, click Anonymous and turn it on, save. -7. Enjoy - you can now activate views and likes on Blowfish for all (or specific) articles. +6. 匿名認証を有効にする - 「ビルド」を選択して「認証」を開きます。「開始する」を選択し、「匿名」をクリックしてオンにし、保存します。 +7. お楽しみください - すべて (または特定の) 記事に対して、Blowfish で閲覧数といいねを有効にできるようになりました。 diff --git a/exampleSite/content/docs/front-matter/index.ja.md b/exampleSite/content/docs/front-matter/index.ja.md index c8ee7e02a..19d612954 100644 --- a/exampleSite/content/docs/front-matter/index.ja.md +++ b/exampleSite/content/docs/front-matter/index.ja.md @@ -1,58 +1,58 @@ --- -title: "Front Matter" +title: "フロントマター" weight: 7 draft: false -description: "All the front matter variables available in Blowfish." +description: "Blowfish で利用可能なすべてのフロントマター変数。" slug: "front-matter" tags: ["front matter", "config", "docs"] series: ["Documentation"] series_order: 7 --- -In addition to the [default Hugo front matter parameters](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below. +[デフォルトの Hugo フロントマターパラメータ](https://gohugo.io/content-management/front-matter/#front-matter-variables)に加えて、Blowfish は個々の記事の表示をカスタマイズするための追加オプションを多数用意しています。利用可能なテーマのフロントマターパラメータをすべて以下に示します。 -Front matter parameter default values are inherited from the theme's [base configuration]({{< ref "configuration" >}}), so you only need to specify these parameters in your front matter when you want to override the default. +フロントマターパラメータのデフォルト値は、テーマの[基本設定]({{< ref "configuration" >}})から継承されるため、デフォルトを上書きしたい場合にのみ、フロントマターでこれらのパラメータを指定する必要があります。 -| Name | Default | Description | +| 名前 | デフォルト | 説明 | | ----------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `title` | _Not set_ | The name of the article. | -| `description` | _Not set_ | The text description for the article. It is used in the HTML metadata. | -| `externalUrl` | _Not set_ | If this article is published on a third-party website, the URL to this article. Providing a URL will prevent a content page being generated and any references to this article will link directly to the third-party website. | -| `editURL` | `article.editURL` | When `showEdit` is active, the URL for the edit link. | -| `editAppendPath` | `article.editAppendPath` | When `showEdit` is active, whether or not the path to the current article should be appended to the URL set at `editURL`. | -| `groupByYear` | `list.groupByYear` | Whether or not articles are grouped by year on list pages. | -| `menu` | _Not set_ | When a value is provided, a link to this article will appear in the named menus. Valid values are `main` or `footer`. | -| `robots` | _Not set_ | String that indicates how robots should handle this article. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values. | -| `sharingLinks` | `article.sharingLinks` | Which sharing links to display at the end of this article. When not provided, or set to `false` no links will be displayed. | -| `showAuthor` | `article.showAuthor` | Whether or not the author box for the default author is displayed in the article footer. | -| `showAuthorBottom` | `article.showAuthorBottom` | Author boxes are displayed at the bottom of each page instead of the top. | -| `authors` | _Not set_ | Array of values for authors, if set it overrides `showAuthor` settings for page or site. Used on the multiple authors feature, check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | -| `showAuthorsBadges` | `article.showAuthorsBadges` | Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | -| `featureimage` | _Not set_ | External URL for feature image | -| `featureimagecaption` | _Not set_ | Caption for feature image. Only displayed in heroStyle `big` | -| `showHero` | `article.showHero` | Whether the thumbnail image will be shown as a hero image within the article page. | -| `heroStyle` | `article.heroStyle` | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | -| `showBreadcrumbs` | `article.showBreadcrumbs` or `list.showBreadcrumbs` | Whether the breadcrumbs are displayed in the article or list header. | -| `showDate` | `article.showDate` | Whether or not the article date is displayed. The date is set using the `date` parameter. | -| `showDateUpdated` | `article.showDateUpdated` | Whether or not the date the article was updated is displayed. The date is set using the `lastmod` parameter. | -| `showEdit` | `article.showEdit` | Whether or not the link to edit the article content should be displayed. | -| `showHeadingAnchors` | `article.showHeadingAnchors` | Whether or not heading anchor links are displayed alongside headings within this article. | -| `showPagination` | `article.showPagination` | Whether or not the next/previous article links are displayed in the article footer. | -| `invertPagination` | `article.invertPagination` | Whether or not to flip the direction of the next/previous article links. | -| `showReadingTime` | `article.showReadingTime` | Whether or not the article reading time is displayed. | -| `showTaxonomies` | `article.showTaxonomies` | Whether or not the taxonomies that relate to this article are displayed. | -| `showTableOfContents` | `article.showTableOfContents` | Whether or not the table of contents is displayed on this article. | -| `showWordCount` | `article.showWordCount` | Whether or not the article word count is displayed. | -| `showComments` | `article.showComments` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | -| `showSummary` | `list.showSummary` | Whether or not the article summary should be displayed on list pages. | -| `showViews` | `article.showViews` | Whether or not the article views should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | -| `showLikes` | `article.showLikes` | Whether or not the article likes should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | -| `seriesOpened` | `article.seriesOpened` | Whether or not the series module will be displayed open by default or not. | -| `series` | _Not set_ | Array of series the article belongs to, we recommend using only one series per article. | -| `series_order` | _Not set_ | Number of the article within the series. | -| `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article. | -| `xml` | `true` unless excluded by `sitemap.excludedKinds` | Whether or not this article is included in the generated `/sitemap.xml` file. | -| `layoutBackgroundBlur` | `true` | Makes the background image in the background heroStyle blur with the scroll | -| `layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | +| `title` | _未設定_ | 記事の名前。 | +| `description` | _未設定_ | 記事のテキスト説明。HTML メタデータで使用されます。 | +| `externalUrl` | _未設定_ | この記事がサードパーティのウェブサイトで公開されている場合、この記事への URL。URL を指定すると、コンテンツページの生成が妨げられ、この記事への参照はすべてサードパーティのウェブサイトに直接リンクされます。 | +| `editURL` | `article.editURL` | `showEdit` がアクティブな場合の、編集リンクの URL。 | +| `editAppendPath` | `article.editAppendPath` | `showEdit` がアクティブな場合、現在の記事へのパスを `editURL` で設定された URL に追加するかどうか。 | +| `groupByYear` | `list.groupByYear` | リストページで記事を年別にグループ化するかどうか。 | +| `menu` | _未設定_ | 値を指定すると、この記事へのリンクが名前付きメニューに表示されます。有効な値は `main` または `footer` です。 | +| `robots` | _未設定_ | ロボットがこの記事をどのように処理するかを示す文字列。設定されている場合、ページヘッドに出力されます。有効な値については、[Google のドキュメント](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives)を参照してください。 | +| `sharingLinks` | `article.sharingLinks` | この記事の最後に表示する共有リンク。指定されていない場合、または `false` に設定されている場合、リンクは表示されません。 | +| `showAuthor` | `article.showAuthor` | 記事のフッターにデフォルトの著者の著者ボックスを表示するかどうか。 | +| `showAuthorBottom` | `article.showAuthorBottom` | 著者ボックスは、各ページの上部ではなく下部に表示されます。 | +| `authors` | _未設定_ | 著者の値の配列。設定されている場合、ページまたはサイトの `showAuthor` 設定を上書きします。複数人の著者機能で使用されます。この機能の設定方法の詳細については、[このページ]({{< ref "multi-author" >}})をご覧ください。 | +| `showAuthorsBadges` | `article.showAuthorsBadges` | 記事またはリストヘッダーに `authors` タクソノミーを表示するかどうか。これには、`複数人の著者` と `authors` タクソノミーの設定が必要です。この機能の設定方法の詳細については、[このページ]({{< ref "multi-author" >}})をご覧ください。 | +| `featureimage` | _未設定_ | フィーチャー画像の外部 URL。 | +| `featureimagecaption` | _未設定_ | フィーチャー画像のキャプション。heroStyle `big` でのみ表示されます。 | +| `showHero` | `article.showHero` | 記事ページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | +| `heroStyle` | `article.heroStyle` | ヒーロー画像の表示スタイル。有効なオプションは、`basic`、`big`、`background`、`thumbAndBackground` です。 | +| `showBreadcrumbs` | `article.showBreadcrumbs`
または `list.showBreadcrumbs` | 記事またはリストヘッダーにパンくずリストを表示するかどうか。 | +| `showDate` | `article.showDate` | 記事の日付を表示するかどうか。日付は `date` パラメータを使用して設定されます。 | +| `showDateUpdated` | `article.showDateUpdated` | 記事が更新された日付を表示するかどうか。日付は `lastmod` パラメータを使用して設定されます。 | +| `showEdit` | `article.showEdit` | 記事コンテンツを編集するためのリンクを表示するかどうか。 | +| `showHeadingAnchors` | `article.showHeadingAnchors` | この記事の見出しの横に見出しアンカーリンクを表示するかどうか。 | +| `showPagination` | `article.showPagination` | 記事のフッターに次/前の記事へのリンクを表示するかどうか。 | +| `invertPagination` | `article.invertPagination` | 次/前の記事へのリンクの方向を反転するかどうか。 | +| `showReadingTime` | `article.showReadingTime` | 記事の閲覧時間を表示するかどうか。 | +| `showTaxonomies` | `article.showTaxonomies` | この記事に関連するタクソノミーを表示するかどうか。 | +| `showTableOfContents` | `article.showTableOfContents` | この記事に目次を表示するかどうか。 | +| `showWordCount` | `article.showWordCount` | 記事の単語数を表示するかどうか。 | +| `showComments` | `article.showComments` | 記事のフッターの後に[コメントパーシャル]({{< ref "partials#comments" >}})を含めるかどうか。 | +| `showSummary` | `list.showSummary` | リストページに記事の要約を表示するかどうか。 | +| `showViews` | `article.showViews` | リストと詳細ビューに記事の閲覧数を表示するかどうか。これには Firebase の統合が必要です。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})をご覧ください。 | +| `showLikes` | `article.showLikes` | リストと詳細ビューに記事のいいねを表示するかどうか。これには Firebase の統合が必要です。Firebase を Blowfish に統合する方法については、[このページ]({{< ref "firebase-views" >}})をご覧ください。 | +| `seriesOpened` | `article.seriesOpened` | シリーズモジュールをデフォルトで開いて表示するかどうか。 | +| `series` | _未設定_ | 記事が属するシリーズの配列。記事ごとに 1 つのシリーズのみを使用することをお勧めします。 | +| `series_order` | _未設定_ | シリーズ内の記事の番号。 | +| `summary` | `summaryLength` を使用して自動生成されます ([サイト設定]({{< ref "configuration#site-configuration" >}})を参照) | `showSummary` が有効な場合、この記事の要約として使用される Markdown 文字列。 | +| `xml` | `sitemap.excludedKinds` によって除外されない限り `true` | この記事が生成された `/sitemap.xml` ファイルに含まれるかどうか。 | +| `layoutBackgroundBlur` | `true` | background heroStyle の背景画像をスクロールでぼかします | +| `layoutBackgroundHeaderSpace` | `true` | ヘッダーと本文の間にスペースを追加します | diff --git a/exampleSite/content/docs/getting-started/index.ja.md b/exampleSite/content/docs/getting-started/index.ja.md index 56fffbd7f..632a5bc9f 100644 --- a/exampleSite/content/docs/getting-started/index.ja.md +++ b/exampleSite/content/docs/getting-started/index.ja.md @@ -1,8 +1,8 @@ --- -title: "Getting Started" +title: "始める" weight: 3 draft: false -description: "All the front matter variables available in Blowfish." +description: "Blowfish で利用可能なすべてのフロントマター変数。" slug: "getting-started" tags: ["installation", "docs"] series: ["Documentation"] @@ -10,61 +10,60 @@ series_order: 3 --- {{< alert >}} -This section assumes you have already [installed the Blowfish theme]({{< ref "docs/installation" >}}). +このセクションでは、[Blowfish テーマをすでにインストールしている]({{< ref "docs/installation" >}})ことを前提としています。 {{< /alert >}}
{{< alert "fire" >}} -We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using: +Blowfish の使用開始を支援する CLI ツールをリリースしました。インストールと設定に役立ちます。次のコマンドで CLI ツールをグローバルにインストールします。 ```bash npx blowfish-tools ``` {{< /alert >}} +Blowfish に同梱されている設定ファイルには、テーマが認識できるすべての設定が含まれています。デフォルトでは、これらの多くはコメントアウトされていますが、コメントを解除するだけで特定の機能を有効化または変更できます。 -The config files that ship with Blowfish contain all of the possible settings that the theme recognises. By default, many of these are commented out but you can simply uncomment them to activate or change a specific feature. +## 基本設定 -## Basic configuration - -Before creating any content, there are a few things you should set for a new installation. Starting in the `hugo.toml` file, set the `baseURL` and `languageCode` parameters. The `languageCode` should be set to the main language that you will be using to author your content. +コンテンツを作成する前に、新しいインストール用に設定する必要があるものがいくつかあります。まず、`hugo.toml` ファイルで、`baseURL` と `languageCode` パラメータを設定します。`languageCode` は、コンテンツの作成に使用する主要言語に設定する必要があります。 ```toml # config/_default/hugo.toml baseURL = "https://your_domain.com/" -languageCode = "en" +languageCode = "ja" ``` -The next step is to configure the language settings. Although Blowfish supports multilingual setups, for now, just configure the main language. +次のステップは、言語設定です。Blowfish は多言語設定をサポートしていますが、ここではまず主要言語を設定します。 -Locate the `languages.en.toml` file in the config folder. If your main language is English you can use this file as is. Otherwise, rename it so that it includes the correct language code in the filename. For example, for French, rename the file to `languages.fr.toml`. +設定フォルダで `languages.en.toml` ファイルを見つけます。主要言語が英語の場合は、このファイルをそのまま使用できます。それ以外の場合は、ファイル名に正しい言語コードが含まれるように名前を変更します。例えば日本語の場合は、`languages.ja.toml`にファイル名を変更します。 {{< alert >}} -Note that the language code in the language config filename should match the `languageCode` setting in `hugo.toml`. +言語設定ファイル名の言語コードは、`hugo.toml` の `languageCode` 設定と一致する必要があることに注意してください。 {{< /alert >}} ```toml -# config/_default/languages.en.toml +# config/_default/languages.ja.toml -title = "My awesome website" +title = "私の素晴らしいウェブサイト" [params.author] -name = "My name" +name = "私の名前" image = "img/author.jpg" -headline = "A generally awesome human" -bio = "A little bit about me" +headline = "一般的に素晴らしい人間" +bio = "私について少し" links = [ { twitter = "https://twitter.com/username" } ] ``` -The `[params.author]` configuration determines how the author information is displayed on the website. The image should be placed in the site's `assets/` folder. Links will be displayed in the order they are listed. +`[params.author]` 設定は、ウェブサイトに著者情報をどのように表示するかを決定します。画像はサイトの `assets/` フォルダに配置する必要があります。リンクはリストされている順序で表示されます。 -If you need extra detail, further information about each of these configuration options, is covered in the [Configuration]({{< ref "configuration" >}}) section. +これらの設定オプションの詳細については、[設定]({{< ref "configuration" >}})セクションで説明しています。 -## Colour schemes +## カラースキーム -Blowfish ships with a number of colour schemes out of the box. To change the scheme, simply set the `colorScheme` theme parameter. Valid options are `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, and`slate`. +Blowfish には、すぐに使用できる多くのカラースキームが付属しています。スキームを変更するには、`colorScheme` テーマパラメータを設定するだけです。有効なオプションは、`blowfish` (デフォルト)、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate` です。 ```toml # config/_default/params.toml @@ -72,9 +71,9 @@ Blowfish ships with a number of colour schemes out of the box. To change the sch colorScheme = "blowfish" ``` -Blowfish defines a three-colour palette that is used throughout the theme. Each main colour contains ten shades which are based upon the colours that are included in [Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). The three main colours are used for the header, footer, and accent colours. Here are the colors for each scheme: +Blowfish は、テーマ全体で使用される3色のパレットを定義しています。各メインカラーには、[Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference) に含まれる色に基づいた10の色合いが含まれています。3つのメインカラーは、ヘッダー、フッター、およびアクセントカラーに使用されます。各スキームの色は次のとおりです。 -#### Blowfish (default) +#### Blowfish (デフォルト) {{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} #### Avocado @@ -116,14 +115,13 @@ Blowfish defines a three-colour palette that is used throughout the theme. Each #### Slate {{< swatches "#6B7280" "#64748b" "#6B7280" >}} +これらはデフォルトのスキームですが、独自のスキームを作成することもできます。詳細については、[高度なカスタマイズ]({{< ref "advanced-customisation#colour-schemes" >}})セクションを参照してください。 -Although these are the default schemes, you can also create your own. Refer to the [Advanced Customisation]({{< ref "advanced-customisation#colour-schemes" >}}) section for details. - -## Organising content +## コンテンツの整理 -By default, Blowfish doesn't force you to use a particular content type. In doing so you are free to define your content as you wish. You might prefer _pages_ for a static site, _posts_ for a blog, or _projects_ for a portfolio. +デフォルトでは、Blowfish は特定のコンテンツタイプを使用することを強制しません。そのため、コンテンツを自由に定義できます。静的サイトの場合は _pages_、ブログの場合は _posts_、ポートフォリオの場合は _projects_ を使用することをお勧めします。 -Here's a quick overview of a basic Blowfish project. All content is placed within the `content` folder: +基本的な Blowfish プロジェクトの概要を簡単に説明します。すべてのコンテンツは `content` フォルダ内に配置されます。 ```shell . @@ -145,11 +143,11 @@ Here's a quick overview of a basic Blowfish project. All content is placed withi └── blowfish ``` -It's important to have a firm grasp of how Hugo expects content to be organised as the theme is designed to take full advantage of Hugo page bundles. Be sure to read the [official Hugo docs](https://gohugo.io/content-management/organization/) for more information. +このテーマは Hugo のページバンドルを最大限に活用するように設計されているため、Hugo がどのようにコンテンツを整理することを想定しているかをしっかりと把握することが重要です。詳細については、[Hugo 公式ドキュメント](https://gohugo.io/content-management/organization/)を参照してください。 -Blowfish is also flexible when it comes to taxonomies. Some people prefer to use _tags_ and _categories_ to group their content, others prefer to use _topics_. +Blowfish はタクソノミーに関しても柔軟です。_tags_ と _categories_ を使用してコンテンツをグループ化することを好む人もいれば、_topics_ を使用することを好む人もいます。 -Hugo defaults to using posts, tags and categories out of the box and this will work fine if that's what you want. If you wish to customise this, however, you can do so by creating a `taxonomies.toml` configuration file: +Hugo はデフォルトで posts、tags、categories を使用するように設定されており、これを希望する場合は問題なく動作します。ただし、これをカスタマイズしたい場合は、`taxonomies.toml` 設定ファイルを作成することでカスタマイズできます。 ```toml # config/_default/taxonomies.toml @@ -157,26 +155,26 @@ Hugo defaults to using posts, tags and categories out of the box and this will w topic = "topics" ``` -This will replace the default _tags_ and _categories_ with _topics_. Refer to the [Hugo Taxonomy docs](https://gohugo.io/content-management/taxonomies/) for more information on naming taxonomies. +これにより、デフォルトの _tags_ と _categories_ が _topic_ に置き換えられます。タクソノミーの命名の詳細については、[Hugo タクソノミードキュメント](https://gohugo.io/content-management/taxonomies/)を参照してください。 -When you create a new taxonomy, you will need to adjust the navigation links on the website to point to the correct sections, which is covered below. +新しいタクソノミーを作成する場合は、ウェブサイトのナビゲーションリンクを調整して、正しいセクションを指すようにする必要があります。これについては以下で説明します。 -## Menus +## メニュー -Blowfish has two menus that can be customised to suit the content and layout of your site. The `main` menu appears in the site header and the `footer` menu appears at the bottom of the page just above the copyright notice. +Blowfish には、サイトのコンテンツとレイアウトに合わせてカスタマイズできる2つのメニューがあります。`main` メニューはサイトヘッダーに表示され、`footer` メニューはページの下部、著作権表示のすぐ上に表示されます。 -Both menus are configured in the `menus.en.toml` file. Similarly to the languages config file, if you wish to use another language, rename this file and replace `en` with the language code you wish to use. +どちらのメニューも `menus.ja.toml` ファイルで設定できます。言語設定ファイルと同様に、別の言語を使用したい場合は、このファイルの名前を変更して、`en` を使用したい言語コードに置き換えます。 ```toml -# config/_default/menus.toml +# config/_default/menus.ja.toml [[main]] - name = "Blog" + name = "ブログ" pageRef = "posts" weight = 10 [[main]] - name = "Topics" + name = "トピック" pageRef = "topics" weight = 20 @@ -193,80 +191,80 @@ Both menus are configured in the `menus.en.toml` file. Similarly to the language weight = 40 [[footer]] - name = "Privacy" + name = "プライバシー" url = "https://external-link" ``` -The `name` parameter specifies the text that is used in the menu link. You can also optionally provide a `title` which fills the HTML title attribute for the link. +`name` パラメータは、メニューリンクで使用されるテキストを指定します。オプションで、リンクの HTML タイトル属性を設定する `title` を指定することもできます。 -The `pageRef` parameter allows you to easily reference Hugo content pages and taxonomies. It is the quickest way to configure the menu as you can simply refer to any Hugo content item and it will automatically build the correct link. To link to external URLs, the `url` parameter can be used. +`pageRef` パラメータを使用すると、Hugo コンテンツページとタクソノミーを簡単に参照できます。これは、Hugo コンテンツアイテムを参照するだけで正しいリンクが自動的に作成されるため、メニューを設定する最も簡単な方法です。外部 URL にリンクするには、`url` パラメータを使用できます。 -The `pre` parameter allows you to place an icon from [Blowfish's icon set]({{< ref "samples/icons" >}}) on the menu entry. This parameter can be used with `name` parameter or by itself. If you want to use multiple menu entries with just icons please set the `identifier`parameter otherwise Hugo will default to the naming tag as the id and probably not display all the menu entries. +`pre` パラメータを使用すると、[Blowfish のアイコンセット]({{< ref "samples/icons" >}})からメニューエントリにアイコンを配置できます。このパラメータは、`name` パラメータと組み合わせて使用することも、単独で使用することもできます。アイコンのみを使用して複数のメニューエントリを使用する場合は、`identifier` パラメータを設定してください。そうしないと、Hugo はデフォルトで命名タグを ID として使用し、おそらくすべてのメニューエントリを表示しません。 -Menu links will be sorted from lowest to highest `weight`, and then alphabetically by `name`. +メニューリンクは、`weight` が低い順に並べ替えられ、次に `name` でアルファベット順に並べ替えられます。 -Both menus are completely optional and can be commented out if not required. Use the template provided in the file as a guide. +どちらのメニューも完全にオプションであり、不要な場合はコメントアウトできます。ファイルに記載されているテンプレートをガイドとして使用してください。 -### Nested menus +### ネストされたメニュー -The theme also supports nested menus. In order to use them you just need to define a parent entry in `menu.toml` and its sub-menus using the `parent` parameter to reference the parent. All properties can be used for sub-menus. `pageRef` and `url` can also be used in the parent entry. Nested menus are only available in the main menu not for the footer. +テーマはネストされたメニューもサポートしています。これらを使用するには、`menu.toml` で親エントリを定義し、`parent` パラメータを使用し親を参照してサブメニューを定義するだけです。すべてのプロパティは、サブメニューに使用できます。`pageRef` と `url` は、親エントリでも使用できます。ネストされたメニューは、メインメニューでのみ使用でき、フッターでは使用できません。 ```toml -# config/_default/menus.toml +# config/_default/menus.ja.toml [[main]] - name = "Parent" + name = "親" weight = 20 [[main]] - name = "sub-menu 1" - parent = "Parent" + name = "サブメニュー 1" + parent = "親" pageRef = "samples" weight = 20 [[main]] - name = "sub-menu 2" - parent = "Parent" + name = "サブメニュー 2" + parent = "親" pageRef = "samples" weight = 20 [[main]] - name = "sub-menu 3" - parent = "Parent" + name = "サブメニュー 3" + parent = "親" pre = "github" pageRef = "samples" weight = 20 ``` -### Sub-Navigation menu +### サブナビゲーションメニュー -Additionally, you can also configure a sub-navigation menu. Just define new menu entries as `subnavigation` in `menus.toml`. -This will render a second line with sub-categories below the main header menu. +さらに、サブナビゲーションメニューを設定することもできます。`menus.toml` で新しいメニューエントリを `subnavigation` として定義するだけです。 +これにより、メインヘッダーメニューの下に、サブカテゴリを含む2行目が表示されます。 ```toml -# config/_default/menus.toml +# config/_default/menus.ja.toml [[subnavigation]] - name = "An interesting topic" + name = "興味深いトピック" pageRef = "tags/interesting-topic" weight = 10 [[subnavigation]] - name = "My Awesome Category" + name = "私の素晴らしいカテゴリ" pageRef = "categories/awesome" weight = 20 ``` -The default `name` is the `pageRef` title cased. +デフォルトの `name` は、`pageRef` のタイトルになります。 -## Thumbnails & Backgrounds +## サムネイルと背景 -Blowfish was built so it would be easy to add visual support to your articles. If your familiar with Hugo article structure, you just need to place an image file (almost all formats are supported but we recommend `.png` or `.jpg`) that starts with `feature*` inside your article folder. And that's it, Blowfish will then be able to both use the image as a thumbnail within your website as well as for oEmbed cards across social platforms. +Blowfish は、記事に視覚的なサポートを簡単に追加できるように構築されました。Hugo の記事構造に慣れている場合は、記事フォルダ内に `feature*` で始まる画像ファイル (ほとんどすべての形式がサポートされていますが、`.png` または `.jpg` を推奨) を配置するだけです。それだけで、Blowfish はその画像をウェブサイト内のサムネイルとして使用したり、ソーシャルプラットフォーム全体の oEmbed カードに使用したりできるようになります。 -[Here]({{< ref "thumbnails" >}}) is also a guide with more info and a [sample]({{< ref "thumbnail_sample" >}}) if you want to see how you can do it. +詳細な情報と、設定方法を確認するための[サンプル]({{< ref "thumbnail_sample" >}})を含むガイドも[こちら]({{< ref "thumbnails" >}})にあります。 -Additionally, Blowfish also supports background hero images in articles and lists. In order to use a different image than the featured one, add an image file in which the name starts with `background*`. +さらに、Blowfish は記事やリストの背景ヒーロー画像もサポートしています。フィーチャー画像とは異なる画像を使用するには、名前が `background*` で始まる画像ファイルを（記事フォルダに）追加します。 -## Detailed configuration +## 詳細設定 -The steps above are the bare minimum configuration. If you now run `hugo server` you will be presented with a blank Blowfish website. Detailed configuration is covered in the [Configuration]({{< ref "configuration" >}}) section. +上記の手順は、最低限の設定です。`hugo server` を実行すると、空の Blowfish ウェブサイトが表示されます。詳細な設定については、[設定]({{< ref "configuration" >}})セクションで説明しています。 diff --git a/exampleSite/content/docs/homepage-layout/index.ja.md b/exampleSite/content/docs/homepage-layout/index.ja.md index 14ea10b88..cb4eee208 100644 --- a/exampleSite/content/docs/homepage-layout/index.ja.md +++ b/exampleSite/content/docs/homepage-layout/index.ja.md @@ -1,89 +1,88 @@ --- -title: "Homepage Layout" +title: "ホームページレイアウト" weight: 5 draft: false -description: "Configuring the homepage layout in the Blowfish theme." +description: "Blowfish テーマのホームページレイアウト設定" slug: "homepage-layout" tags: ["homepage", "layouts", "docs"] series: ["Documentation"] series_order: 5 --- -Blowfish provides a fully flexible homepage layout. There are two main templates to choose from with additional settings to adjust the design. Alternatively, you can also provide your own template and have complete control over the homepage content. +Blowfish は完全に柔軟なホームページレイアウトを提供します。2つのメインテンプレートから選択でき、追加設定でデザインを調整できます。または、独自のテンプレートを提供して、ホームページのコンテンツを完全に制御することもできます。 -The layout of the homepage is controlled by the `homepage.layout` setting in the `params.toml` configuration file. Additionally, all layouts have the option to include a listing of [recent articles](#recent-articles). +ホームページのレイアウトは、`params.toml` 設定ファイルの `homepage.layout` 設定によって制御されます。さらに、すべてのレイアウトには、[最新記事](#最新記事)のリストを含めるオプションがあります。 -## Profile layout +## プロフィールレイアウト (profile) -The default layout is the profile layout, which is great for personal websites and blogs. It puts the author's details front and centre by providing an image and links to social profiles. +デフォルトのレイアウトはプロフィールレイアウトで、個人ウェブサイトやブログに最適です。画像とソーシャルプロファイルへのリンクを提供することで、著者の詳細を前面に押し出します。 -The author information is provided in the languages configuration file. Refer to the [Getting Started]({{< ref "getting-started" >}}) and [Language Configuration]({{< ref "configuration##language-and-i18n" >}}) sections for parameter details. +著者情報は、言語設定ファイルで提供されます。パラメータの詳細については、[始める]({{< ref "getting-started" >}})と[言語設定]({{< ref "configuration#言語と-i18n" >}})セクションを参照してください。 -Additionally, any Markdown content that is provided in the homepage content will be placed below the author profile. This allows extra flexibility for displaying a bio or other custom content using shortcodes. +さらに、ホームページのコンテンツで提供される Markdown コンテンツはすべて、著者プロファイルの下に配置されます。これにより、ショートコードを使用して経歴やその他のカスタムコンテンツを表示するための柔軟性が向上します。 -To enable the Profile layout, set `homepage.layout = "profile"` in the `params.toml` configuration file. +プロフィールレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "profile"` と設定します。 -## Page layout +## ページレイアウト (page) -The page layout is simply a normal content page that displays your Markdown content. It's great for static websites and provides a lot of flexibility. +ページレイアウトは、Markdown コンテンツを表示する通常のコンテンツページです。静的ウェブサイトに最適で、高い柔軟性を提供します。 -To enable the Page layout, set `homepage.layout = "page"` in the `params.toml` configuration file. +ページレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "page"` を設定します。 -## Hero layout +## ヒーローレイアウト (hero) -The hero layout brings together ideas from the profile and card layouts. This one not only displays information on the author of the site but it also loads your markdown beneath it. +ヒーローレイアウトは、プロフィールレイアウトとカードレイアウトのアイデアを組み合わせたものです。これは、サイトの著者に関する情報を表示するだけでなく、その下に Markdown をロードします。 -To enable the Hero layout, set `homepage.layout = "hero"` and `homepage.homepageImage` in the `params.toml` configuration file. +ヒーローレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "hero"` と `homepage.homepageImage` を設定します。 -## Background layout +## 背景レイアウト (background) -The background layout is a more smooth version of the hero layout. As in the Hero layout, this one also displays both information on the author of the site and loads your markdown beneath it. +背景レイアウトは、ヒーローレイアウトをより滑らかにしたバージョンです。ヒーローレイアウトと同様に、サイトの著者に関する情報を表示し、その下に Markdown をロードします。 -To enable the Background layout, set `homepage.layout = "background"` and `homepage.homepageImage` in the `params.toml` configuration file. +背景レイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "background"` と `homepage.homepageImage` を設定します。 -## Card layout +## カードレイアウト (card) -The card layout is an extension of the page layout. It provides the same level of flexibility by also displaying your markdown content and adds a card image to display visual content. +カードレイアウトは、ページレイアウトの拡張版です。Markdown コンテンツも表示することで同じレベルの柔軟性を提供し、ビジュアルコンテンツを表示するためのカード画像も追加します。 -To enable the Card layout, set `homepage.layout = "card"` and `homepage.homepageImage` in the `params.toml` configuration file. +カードレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "card"` と `homepage.homepageImage` を設定します。 +## カスタムレイアウト -## Custom layout +組み込みのホームページレイアウトがニーズに合わない場合は、独自のカスタムレイアウトを提供するオプションがあります。これにより、ページコンテンツを完全に制御でき、基本的に作業するための白紙の状態が得られます。 -If the built-in homepage layouts aren't sufficient for your needs, you have the option to provide your own custom layout. This allows you to have total control over the page content and essentially gives you a blank slate to work with. +カスタムレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "custom"` を設定します。 -To enable the Custom layout, set `homepage.layout = "custom"` in the `params.toml` configuration file. +設定値を設定したら、新しい `custom.html` ファイルを作成し、`layouts/partials/home/custom.html` に配置します。これで、`custom.html` ファイルの内容がサイトのホームページのコンテンツ領域に配置されます。レイアウトを定義するために、HTML、Tailwind、または Hugo テンプレート関数を自由に使用できます。 -With the configuration value set, create a new `custom.html` file and place it in `layouts/partials/home/custom.html`. Now whatever is in the `custom.html` file will be placed in the content area of the site homepage. You may use whatever HTML, Tailwind, or Hugo templating functions you wish to define your layout. +カスタムレイアウトに[最新記事](#最新記事)を含めるには、`recent-articles/main.html` パーシャルを使用します。 -To include [recent articles](#recent-articles) on the custom layout, use the `recent-articles/main.html` partial. +例として、このサイトの[ホームページ]({{< ref "/" >}})では、カスタムレイアウトを使用して、プロフィールレイアウトとページレイアウトを切り替えています。動作を確認するには、[GitHub リポジトリ](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html)にアクセスしてください。 -As an example, the [homepage]({{< ref "/" >}}) on this site uses the custom layout to allow toggling between the profile and page layouts. Visit the [GitHub repo](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) to see how it works. +## 最新記事 -## Recent articles - -All homepage layouts have the option of displaying recent articles below the main page content. To enable this, simply set the `homepage.showRecent` setting to `true` in the `params.toml` configuration file. +すべてのホームページレイアウトには、メインページコンテンツの下に最新記事を表示するオプションがあります。これを有効にするには、`params.toml` 設定ファイルで `homepage.showRecent` 設定を `true` に設定するだけです。 -The articles listed in this section are derived from the `mainSections` setting which allows for whatever content types you are using on your website. For instance, if you had content sections for _posts_ and _projects_ you could set this setting to `["posts", "projects"]` and all the articles in these two sections would be used to populate the recent list. The theme expects this setting to be an array so if you only use one section for all your content, you should set this accordingly: `["blog"]`. +このセクションにリストされている記事は、`mainSections` 設定から派生したもので、ウェブサイトで使用しているコンテンツタイプを指定できます。たとえば、_posts_ と _projects_ のコンテンツセクションがある場合、この設定を `["posts", "projects"]` に設定すると、これら2つのセクションのすべての記事が最新リストに表示されます。テーマはこの設定を配列として想定しているため、すべてのコンテンツに1つのセクションのみを使用する場合は、それに応じて設定する必要があります: `["blog"]`。 -## Thumbnails +## サムネイル -Blowfish was built so it would be easy to add visual support to your articles. If your familiar with Hugo article structure, you just need to place an image file (almost all formats are supported bue we recommend `.png` or `.jpg`) that starts with `feature*` inside your article folder. And that's it, Blowfish will then able to both use the image as a thumbnail within your website as well as for oEmbed cards across social platforms. +Blowfish は、記事にビジュアルサポートを簡単に追加できるように構築されています。Hugo の記事構造に慣れている場合は、記事フォルダ内に `feature*` で始まる画像ファイル (ほとんどすべての形式がサポートされていますが、`.png` または `.jpg` を推奨) を配置するだけです。それだけで、Blowfish はその画像をサイト内のサムネイルとして使用したり、ソーシャルプラットフォーム全体の oEmbed カードに使用したりできるようになります。 -[Here]({{< ref "thumbnails" >}}) is a guide with more info and a [sample]({{< ref "thumbnail_sample" >}}) if you want to see an example. +詳細情報と例を確認したい場合は、[こちら]({{< ref "thumbnails" >}})にガイドがあります。 -## Card Gallery +## カードギャラリー -Blowfish also supports displaying the standard lists of articles as card galleries. You can config this both for the recent section in the homepage and for lists of articles across your website. For homepage you can use `homepage.cardView` and `homepage.cardViewScreenWidth`; and for lists use `list.cardView` and `list.cardViewScreenWidth`. Check the [Configuration docs]({{< ref "configuration" >}}) for more details, and the homepage for a live demo. +Blowfish は、記事の標準リストをカードギャラリーとして表示することもサポートしています。これは、ホームページの最新セクションとサイト全体の記事リストの両方で設定できます。ホームページの場合は `homepage.cardView` と `homepage.cardViewScreenWidth` を使用し、リストの場合は `list.cardView` と `list.cardViewScreenWidth` を使用します。詳細については、[設定ドキュメント]({{< ref "configuration" >}})を確認し、ライブデモについてはホームページを確認してください。 diff --git a/exampleSite/content/docs/hosting-deployment/index.ja.md b/exampleSite/content/docs/hosting-deployment/index.ja.md index dd04bc14d..a5903661a 100644 --- a/exampleSite/content/docs/hosting-deployment/index.ja.md +++ b/exampleSite/content/docs/hosting-deployment/index.ja.md @@ -1,38 +1,38 @@ --- -title: "Hosting & Deployment" +title: "ホスティングとデプロイ" weight: 14 draft: false -description: "Learn how to deploy a Blowfish site." +description: "Blowfish サイトのデプロイ方法について説明します。" slug: "hosting-deployment" tags: ["docs", "hosting", "deployment", "github", "netlify", "render"] series: ["Documentation"] series_order: 14 --- -There are many ways to deploy your Hugo website built with Blowfish. The theme is designed to be flexible in almost any deployment scenario. +Blowfish で構築された Hugo ウェブサイトをデプロイする方法はたくさんあります。このテーマは、ほとんどすべてのデプロイシナリオで柔軟に対応できるように設計されています。 -Blowfish is built using relative URLs throughout the theme. This enables sites to easily be deployed to sub-folders and hosts like GitHub Pages. There's usually no special configuration required for this to work as long as the `baseURL` parameter has been configured in the `config.toml` file. +Blowfish は、テーマ全体で相対的な URL を使用して構築されています。これにより、サイトをサブフォルダや GitHub Pages などのホストに簡単にデプロイできます。`baseURL` パラメータが `config.toml` ファイルで設定されていれば、通常、これが機能するために特別な設定は必要ありません。 -The official Hugo [Hosting and Deployment](https://gohugo.io/hosting-and-deployment/) docs are the best place to learn how to deploy your site. The sections below contain some specific theme configuration details that can help you deploy smoothly with certain providers. +Hugo の公式[ホスティングとデプロイ](https://gohugo.io/hosting-and-deployment/)ドキュメントは、サイトのデプロイ方法を学ぶのに最適な場所です。以下のセクションには、特定のプロバイダーでスムーズにデプロイするのに役立つ、テーマ固有の設定の詳細が記載されています。 -**Choose your provider:** +**プロバイダーを選択してください:** - [GitHub Pages](#github-pages) - [Netlify](#netlify) - [Render](#render) - [Cloudflare Pages](#cloudflare-pages) -- [Shared hosting, VPS or private web server](#shared-hosting-vps-or-private-web-server) +- [共有ホスティング、VPS、またはプライベート Web サーバー](#共有ホスティングvpsまたはプライベート-web-サーバー) --- ## GitHub Pages -GitHub allows hosting on [GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) using Actions. To enable this functionality, enable Pages on your repo and create a new Actions workflow to build and deploy your site. +GitHub では、[GitHub Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages) でのアクションを使用したホスティングが可能です。この機能を有効にするには、リポジトリで Pages を有効にし、サイトをビルドしてデプロイするための新しいアクションワークフローを作成します。 -The file needs to be in YAML format, placed within the `.github/workflows/` directory of your GitHub repository and named with a `.yml` extension. +ファイルは YAML 形式で、GitHub リポジトリの `.github/workflows/` ディレクトリ内に配置し、`.yml` 拡張子を付けて名前を付ける必要があります。 {{< alert >}} -**Important:** Ensure you set the correct branch name under `branches` and in the deploy step `if` parameter to the source branch used in your project. +**重要:** `branches` の下とデプロイステップの `if` パラメータに、プロジェクトで使用されているソースブランチの正しいブランチ名を設定してください。 {{< /alert >}} ```yaml @@ -74,19 +74,19 @@ jobs: publish_dir: ./public ``` -Push the config file to GitHub and the action should automatically run. It may fail the first time and you'll need to visit the **Settings > Pages** section of your GitHub repo to check the source is correct. It should be set to use the `gh-pages` branch. +設定ファイルを GitHub にプッシュすると、アクションが自動的に実行されます。最初は失敗する可能性があり、GitHub リポジトリの **Settings > Pages** セクションにアクセスして、ソースが正しいことを確認する必要があります。`gh-pages` ブランチを使用するように設定する必要があります。 -{{< screenshot src="github-pages-source.jpg" alt="Screen capture of GitHub Pages source" >}} +{{< screenshot src="github-pages-source.jpg" alt="GitHub Pages ソースのスクリーンキャプチャ" >}} -Once the settings are configured, re-run the action and the site should build and deploy correctly. You can consult the actions log to check everything deployed successfully. +設定が完了したら、アクションを再実行すると、サイトが正しくビルドおよびデプロイされます。すべてが正常にデプロイされたことを確認するには、アクションログを参照してください。 ## Netlify -To deploy to [Netlify](https://www.netlify.com), create a new continuous deployment site and link it to your source code. The build settings can be left blank in the Netlify UI. You will only need to configure the domain you'll be using. +[Netlify](https://www.netlify.com) にデプロイするには、新しい継続的デプロイサイトを作成し、それをソースコードにリンクします。Netlify UI では、ビルド設定を空白のままにすることができます。使用するドメインを設定するだけで済みます。 -{{< screenshot src="netlify-build-settings.jpg" alt="Screen capture of Netlify build settings" >}} +{{< screenshot src="netlify-build-settings.jpg" alt="Netlify ビルド設定のスクリーンキャプチャ" >}} -Then in the root of your site repository, create a `netlify.toml` file: +次に、サイトリポジトリのルートに `netlify.toml` ファイルを作成します。 ```toml # netlify.toml @@ -98,7 +98,7 @@ Then in the root of your site repository, create a `netlify.toml` file: [build.environment] NODE_ENV = "production" GO_VERSION = "1.16" - TZ = "UTC" # Set to preferred timezone + TZ = "UTC" # 希望のタイムゾーンに設定 [context.production.environment] HUGO_VERSION = "0.104.1" @@ -108,41 +108,41 @@ Then in the root of your site repository, create a `netlify.toml` file: HUGO_VERSION = "0.104.1" ``` -This configuration assumes you are deploying Blowfish as a Hugo module. If you have installed the theme using another method, change the build command to simply `hugo --gc --minify -b $URL`. +この設定では、Blowfish を Hugo モジュールとしてデプロイすることを想定しています。別の方法でテーマをインストールした場合は、ビルドコマンドを単に `hugo --gc --minify -b $URL` に変更します。 -When you push the config file to your repo, Netlify should automatically deploy your site. You can check the deploy logs in the Netlify UI to check for any errors. +設定ファイルをリポジトリにプッシュすると、Netlify は自動的にサイトをデプロイします。エラーがないか確認するには、Netlify UI のデプロイログを確認してください。 ## Render -Deploying to [Render](https://render.com) is very straightforward and all configuration is via the Render UI. +[Render](https://render.com) へのデプロイは非常に簡単で、すべての設定は Render UI を介して行います。 -Create a new **Static Site** and link it to your project's code repository. Then simply configure the build command to be `hugo --gc --minify` and publish directory to be `public`. +新しい **静的サイト** を作成し、それをプロジェクトのコードリポジトリにリンクします。次に、ビルドコマンドを `hugo --gc --minify` に、公開ディレクトリを `public` に設定するだけです。 -{{< screenshot src="render-settings.jpg" alt="Screen capture of Render settings" >}} +{{< screenshot src="render-settings.jpg" alt="Render 設定のスクリーンキャプチャ" >}} -The site will automatically build and deploy whenever you push a change to your repo. +リポジトリに変更をプッシュするたびに、サイトが自動的にビルドおよびデプロイされます。 ## Cloudflare Pages -Cloudflare offers the [Pages](https://pages.cloudflare.com/) service that can host Hugo blogs. It builds the site from a git repository and then hosts it on Cloudflare's CDN. Follow their [Hugo deployment guide](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) to get started. +Cloudflare は、Hugo ブログをホストできる [Pages](https://pages.cloudflare.com/) サービスを提供しています。これは、git リポジトリからサイトをビルドし、Cloudflare の CDN でホストします。[Hugo デプロイメントガイド](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site)に従って始めてください。 -The Rocket Loader™ feature offered by Cloudflare tries to speed up rendering of web pages with JavaScript, but it breaks the appearance switcher in the theme. It can also cause an annoying light/dark screen flash when browsing your site due to scripts loading in the wrong order. +Cloudflare が提供する Rocket Loader™ 機能は、JavaScript を使用した Web ページのレンダリングを高速化しようとしますが、テーマの外観スイッチャーが壊れます。また、スクリプトが間違った順序で読み込まれるため、サイトの閲覧時に迷惑な明暗の画面のちらつきが発生する可能性があります。 -This problem can be fixed by disabling it: +この問題は、次のように無効にすることで修正できます。 -- Go to the [Cloudflare dashboard](https://dash.cloudflare.com) -- Click on your domain name in the list -- Click _Optimization_ in the _Speed_ section -- Scroll down to _Rocket Loader™_ and disable it +- [Cloudflare ダッシュボード](https://dash.cloudflare.com)に移動します +- リストでドメイン名をクリックします +- _Speed_ セクションで _Optimization_ をクリックします +- _Rocket Loader™_ までスクロールして無効にします -Hugo sites built with Blowfish still load very quickly, even with this feature disabled. +Blowfish でビルドされた Hugo サイトは、この機能を無効にしても非常に高速に読み込まれます。 -## Shared hosting, VPS or private web server +## 共有ホスティング、VPS、またはプライベート Web サーバー -Using traditional web hosting, or deploying to your own web server, is as simple as building your Hugo site and transferring the files to your host. +従来の Web ホスティングを使用したり、独自の Web サーバーにデプロイしたりするのは、Hugo サイトをビルドしてファイルをホストに転送するのと同じくらい簡単です。 -Make sure that the `baseURL` parameter in `config.toml` is set to the full URL to the root of your website (including any sub domains or sub-folders). +`config.toml` の `baseURL` パラメータが、ウェブサイトのルートへの完全な URL (サブドメインやサブフォルダを含む) に設定されていることを確認してください。 -Then build your site using `hugo` and copy the contents of the output directory to the root of your web server and you will be ready to go. By default, the output directory is named `public`. +次に、`hugo` を使用してサイトをビルドし、出力ディレクトリの内容を Web サーバーのルートにコピーすると、準備完了です。デフォルトでは、出力ディレクトリの名前は `public` です。 -_If you need a hosting provider, check out [Vultr](https://www.vultr.com/?ref=8957394-8H) or [DigitalOcean](https://m.do.co/c/36841235e565). Signing up using these affiliate links will give you up to $100 in free credit so you can try the service._ +_ホスティングプロバイダーが必要な場合は、[Vultr](https://www.vultr.com/?ref=8957394-8H) または [DigitalOcean](https://m.do.co/c/36841235e565) を確認してください。これらのアフィリエイトリンクを使用してサインアップすると、最大 $100 の無料クレジットが付与されるため、サービスを試すことができます。_ diff --git a/exampleSite/content/docs/installation/index.ja.md b/exampleSite/content/docs/installation/index.ja.md index e7ee0375a..037421131 100644 --- a/exampleSite/content/docs/installation/index.ja.md +++ b/exampleSite/content/docs/installation/index.ja.md @@ -1,83 +1,83 @@ --- -title: "Installation" +title: "インストール" weight: 2 draft: false -description: "How to install the Blowfish theme." +description: "Blowfish テーマのインストール方法" slug: "installation" tags: ["installation", "docs"] series: ["Documentation"] series_order: 2 --- -Simply follow the standard Hugo [Quick Start](https://gohugo.io/getting-started/quick-start/) procedure to get up and running quickly. +Hugo の[クイックスタートガイド](https://gohugo.io/getting-started/quick-start/)に従うだけで、簡単に使い始めることができます。 -Detailed installation instructions can be found below. Instructions for [updating the theme](#installing-updates) are also available. +詳細なインストール手順は以下に記載されています。[テーマのアップデート方法](#テーマのアップデート方法)についても説明しています。 -## Installation +## インストール -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. +以下の手順では、全くの新規状態から Hugo と Blowfish を使用してウェブサイトを立ち上げる方法を説明します。このガイドで紹介するツールのほとんどは、お使いのプラットフォームに対応したパッケージマネージャーからインストール可能です。 -### Install Hugo +### Hugo のインストール -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`. +Hugo を初めて使用する場合は、[公式サイトの手順](https://gohugo.io/getting-started/installing)に従って、ローカルマシンにインストールしてください。すでにインストールされているかどうかは、コマンド `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. +テーマは最新の Hugo の機能を活用しているため、**Hugo バージョン 0.87.0 以降**を使用していることを確認してください。 {{< /alert >}} -You can find detailed installation instructions for your platform in the [Hugo docs](https://gohugo.io/getting-started/installing). +お使いのプラットフォームに合わせた詳細なインストール手順は、[Hugo の公式ドキュメント](https://gohugo.io/getting-started/installing)に記載されています。 -### Blowfish Tools (recommended) +### Blowfish Tools (推奨) -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). +Blowfish を簡単に使い始められるよう、新しく CLI ツールをリリースしました。このツールは、新しい Hugo プロジェクトの作成、テーマのインストール、そしてテーマ設定ファイルのセットアップを自動的に行います。まだベータ版ですので、[問題を発見した場合は報告にご協力ください](https://github.com/nunocoracao/blowfish-tools)。 -Install the CLI tool globally using npm (or other package manager): +npm (または他のパッケージマネージャー) を使用して、CLI ツールをグローバルにインストールします。 ```shell npx blowfish-tools ``` -or +または ```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. +次に、コマンド `blowfish-tools` を実行すると、対話形式でプロジェクトの作成と設定をガイドしてくれます。 ```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. +また、コマンド `blowfish-tools new` を実行すれば、新しい Hugo プロジェクトの作成とテーマのインストールを一度に行うこともできます。詳細は、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: +CLI ツールを使って Blowfish を迅速に使い始める方法を、以下の動画でご覧いただけます。 -### Install without CLI +### CLI を使用しないインストール -#### Create a new site +#### 新しいサイトの作成 -Run the command `hugo new site mywebsite` to create a new Hugo site in a directory named `mywebsite`. +コマンド `hugo new site mywebsite` を実行して、`mywebsite` という名前のディレクトリに新しい Hugo サイトを作成します。 -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. +プロジェクトディレクトリには任意の名前を付けることができますが、以降の手順では `mywebsite` という名前を想定して説明します。別の名前を使用する場合は、適宜読み替えてください。 -#### Download the Blowfish theme +#### 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: +Hugo ウェブサイトに Blowfish テーマをインストールするには、いくつかの方法があります。インストールとメンテナンスが簡単な方法から難しい方法まで、以下の通りです。 -- [Git submodule](#install-using-git) (recommended) -- [Hugo module](#install-using-hugo) -- [Manual file copy](#install-manually) +- [Git サブモジュールを使用する](#git-を使用してインストールする) (推奨) +- [Hugo モジュールを使用する](#hugo-を使用してインストールする) +- [手動でファイルをコピーする](#手動でインストールする) -If you're unsure, choose the Git submodule method. +どの方法を選べば良いか分からない場合は、Git サブモジュール方式を選択することをお勧めします。 -#### Install using git +#### 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. +この方法は、テーマを最新の状態に保つための最も迅速で簡単な方法です。**Hugo** と **Go** に加えて、ローカルマシンに **Git** がインストールされていることも確認してください。 -Change into the directory for your Hugo website (that you created above), initialise a new `git` repository and add Blowfish as a submodule. +(上記で作成した) Hugo ウェブサイトのディレクトリに移動し、新しい `git` リポジトリを初期化して、Blowfish をサブモジュールとして追加します。 ```bash cd mywebsite @@ -85,29 +85,29 @@ 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). +次に、[テーマ設定ファイルを作成する](#テーマ設定ファイルを作成する)に進みます。 -#### Install using Hugo +#### 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. +この方法では、Hugo を使用してテーマを管理します。Hugo は **Go** を使用してモジュールを初期化および管理するため、続行する前に `go` がインストールされていることを確認する必要があります。 -1. [Download](https://golang.org/dl/) and install Go. You can check if it's already installed by using the command `go version`. +1. Go を[ダウンロード](https://golang.org/dl/)してインストールします。コマンド `go version` を使用して、すでにインストールされているかどうかを確認できます。 {{< alert >}} - Make sure you are using **Go version 1.12** or later as Hugo requires this for modules to work correctly. + Hugo ではモジュールが正しく動作するために **Go バージョン 1.12 以降** が必要です。必ず対応バージョンを使用してください。 {{< /alert >}} -2. From your Hugo project directory (that you created above), initialise modules for your website: +2. (上記で作成した) Hugo プロジェクトディレクトリから、ウェブサイトのモジュールを初期化します。 ```shell - # If you're managing your project on GitHub - hugo mod init github.com// + # プロジェクトを GitHub で管理している場合 + hugo mod init github.com/<ユーザー名>/<リポジトリ名> - # If you're managing your project locally + # プロジェクトをローカルで管理している場合 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. 新しいファイル `config/_default/module.toml` を作成し、以下を記述して、テーマを設定に追加します。 ```toml [[imports]] @@ -115,32 +115,32 @@ For this method you'll use Hugo to manage your themes. Hugo uses **Go** to initi 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. `hugo server` を実行してサーバーを起動すると、テーマが自動的にダウンロードされます。 +5. [テーマ設定ファイルを作成する](#テーマ設定ファイルを作成する)に進みます。 -#### Install manually +#### 手動でインストールする -1. Download the latest release of the theme source code. +1. テーマソースコードの最新リリースをダウンロードします。 - {{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Download from Github{{< /button >}} + {{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}GitHub からダウンロード{{< /button >}} -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). +2. アーカイブを解凍し、フォルダ名を `blowfish` に変更して、Hugo プロジェクトのルートフォルダ内の `themes/` ディレクトリに移動します。 +3. [テーマ設定ファイルを作成する](#テーマ設定ファイルを作成する)に進みます。 -#### Set up theme configuration files +#### テーマ設定ファイルを作成する -In the root folder of your website, delete the `hugo.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. +ウェブサイトのルートフォルダで、Hugo によって自動生成された `hugo.toml` ファイルを削除します。`*.toml` 設定ファイルをテーマから `config/_default/` フォルダにコピーします。これにより、必要なテーマ設定がすべて適用され、テーマを簡単にカスタマイズできるようになります。 {{< alert >}} -**Note:** You should not overwrite the `module.toml` file if one already exists in your project! +**注意:** プロジェクトに `module.toml` ファイルがすでに存在する場合は、上書きしないでください。 {{< /alert >}} -Depending on how you installed the theme you will find the theme config files in different places: +テーマのインストール方法によって、テーマ設定ファイルの場所は異なります。 -- **Hugo Modules:** In the Hugo cache directory, or [download a copy](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) from GitHub -- **Git submodule or Manual install:** `themes/blowfish/config/_default` +- **Hugo モジュール:** Hugo キャッシュディレクトリ、または GitHub から [設定ファイルのコピーをダウンロード](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) します +- **Git サブモジュールまたは手動インストール:** `themes/blowfish/config/_default` -Once you've copied the files, your config folder should look like this: +ファイルをコピーしたら、設定フォルダは次のようになります。 ```shell config/_default/ @@ -148,64 +148,64 @@ config/_default/ ├─ languages.en.toml ├─ markup.toml ├─ menus.en.toml -├─ module.toml # if you installed using Hugo Modules +├─ module.toml # Hugo モジュールを使用してインストールした場合 └─ params.toml ``` {{< alert >}} -**Important:** If you didn't use Hugo Modules to install Blowfish, you must add the line `theme = "blowfish"` to the top of your `hugo.toml` file. +**重要:** Hugo モジュールを使用せずに Blowfish をインストールした場合は、`hugo.toml` ファイルの先頭に `theme = "blowfish"` という行を追加する必要があります。 {{< /alert >}} -### Next steps +### 次のステップ -The basic Blowfish installation is now complete. Continue to the [Getting Started]({{< ref "getting-started" >}}) section to learn more about configuring the theme. +これで Blowfish の基本的なインストールは完了です。[始める]({{< ref "getting-started" >}})セクションに進んで、テーマの設定についてさらに詳しく学びましょう。 --- -## Installing updates +## テーマのアップデート方法 -From time to time there will be [new releases](https://github.com/nunocoracao/blowfish/releases) posted that apply fixes and add new functionality to the theme. In order to take advantage of these changes, you will need to update the theme files on your website. +不具合の修正や新機能の追加を含む[新しいリリース](https://github.com/nunocoracao/blowfish/releases)が随時公開されます。これらの変更を反映するには、ウェブサイトのテーマファイルをアップデートする必要があります。 -How you go about this will depend on the installation method you chose when the theme was originally installed. Instructions for each method can be found below. +アップデート方法は、最初にテーマをインストールした方法によって異なります。各方法の手順は以下に記載されています。 -- [Git submodule](#update-using-git) -- [Hugo module](#update-using-hugo) -- [Manual file copy](#update-manually) +- [Git サブモジュール](#git-を使用してアップデートする) +- [Hugo モジュール](#hugo-を使用してアップデートする) +- [手動でファイルをコピー](#手動でアップデートする) -### Update using git +### Git を使用してアップデートする -Git submodules can be updated using the `git` command. Simply execute the following command and the latest version of the theme will be downloaded into your local repository: +Git サブモジュールは、`git` コマンドを使用してアップデートできます。次のコマンドを実行するだけで、テーマの最新バージョンがローカルリポジトリにダウンロードされます。 ```shell git submodule update --remote --merge ``` -Once the submodule has been updated, rebuild your site and check everything works as expected. +サブモジュールがアップデートされたら、サイトを再びビルドし、すべてが期待通りに動作することを確認してください。 -### Update using Hugo +### Hugo を使用してアップデートする -Hugo makes updating modules super easy. Simply change into your project directory and execute the following command: +Hugo を使用すると、モジュールのアップデートが非常に簡単になります。プロジェクトディレクトリに移動して、次のコマンドを実行するだけです。 ```shell hugo mod get -u ``` -Hugo will automatically update any modules that are required for your project. It does this by inspecting your `module.toml` and `go.mod` files. If you have any issues with the update, check to ensure these files are still configured correctly. +Hugo は、プロジェクトに必要なモジュールを自動的にアップデートします。これは、`module.toml` ファイルと `go.mod` ファイルを調べることで行われます。アップデートに問題がある場合は、これらのファイルが正しく設定されていることを確認してください。 -Then simply rebuild your site and check everything works as expected. +その後、サイトを再びビルドし、すべてが期待通りに動作することを確認してください。 -### Update manually +### 手動でアップデートする -Updating Blowfish manually requires you to download the latest copy of the theme and replace the old version in your project. +Blowfish を手動でアップデートするには、テーマの最新コピーをダウンロードして、プロジェクトの古いバージョンを置き換える必要があります。 {{< alert >}} -Note that any local customisations you have made to the theme files will be lost during this process. +この処理を行うと、テーマファイルに加えたローカルの変更はすべて失われるので注意してください。 {{< /alert >}} -1. Download the latest release of the theme source code. +1. テーマソースコードの最新リリースをダウンロードします。 - {{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Download from Github{{< /button >}} + {{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}GitHub からダウンロード{{< /button >}} -2. Extract the archive, rename the folder to `blowfish` and move it to the `themes/` directory inside your Hugo project's root folder. You will need to overwrite the existing directory to replace all the theme files. +2. アーカイブを解凍し、フォルダ名を `blowfish` に変更して、Hugo プロジェクトのルートフォルダ内の `themes/` ディレクトリに移動します。すべてのテーマファイルを置き換えるには、既存のディレクトリを上書きする必要があります。 -3. Rebuild your site and check everything works as expected. +3. サイトを再びビルドし、すべてが期待通りに動作することを確認してください。 diff --git a/exampleSite/content/docs/multi-author/index.ja.md b/exampleSite/content/docs/multi-author/index.ja.md index 472c743bf..bd6a46a1e 100644 --- a/exampleSite/content/docs/multi-author/index.ja.md +++ b/exampleSite/content/docs/multi-author/index.ja.md @@ -1,8 +1,8 @@ --- -title: "Multiple Authors" +title: "複数の著者" weight: 8 draft: false -description: "Configure multiple authors for your articles." +description: "記事に複数の著者を設定する。" slug: "multi-author" tags: ["authors", "config", "docs"] series: ["Documentation"] @@ -14,24 +14,23 @@ showAuthorsBadges : false --- -Some websites have more than one author contributing with content and therefore require more than a single default author across the entire website. For those use-cases, Blowfish allows users to extend the list of authors using the multiple authors feature. +一部のウェブサイトでは、複数の著者がコンテンツを提供しているため、ウェブサイト全体で単一のデフォルト著者以上のものが必要になります。このようなユースケースのために、Blowfish では、複数著者機能を使用して著者リストを拡張できます。 -To keep everything backwards compatible, this feature only allows the definition of extra authors and does not change in any way the previous author functionality which is used via config files. +すべての後方互換性を維持するために、この機能では追加の著者の定義のみを許可し、設定ファイルを介して使用される以前の著者機能を一切変更しません。 +## 著者の作成 -## Create Authors +新しい著者を作成する最初のステップは、`./data/authors` に新しいフォルダを設定することです。次に、その中に新しい `json` ファイルを、新しい著者ごとに1つずつ追加できます。ファイルの名前は、記事で参照する際のその著者の `key` になります。 -The first step to create new authors is to set up a new folder in `./data/authors`. Then you can simply add new `json` files inside, one for each new author. The name of the file will be the `key` for that author when referencing it in your articles. +例として、`./data/authors` 内に `nunocoracao.json` というファイルを作成しましょう。ファイルの内容は以下のものと同様である必要があります。`name`、`image`、`bio`、および `social` は、著者に対して現在サポートされている4つのパラメータです。これらは、設定ファイルでデフォルトの著者に対して使用できる設定を模倣しています。 -As an example, let’s create a file called `nunocoracao.json` within `./data/authors`. The contents of the file should be similar to the ones below. `name`, `image`, `bio`, and `social` are the 4 parameters supported right for authors. They mimic the configurations available for the default author in the config files. - -_Note: the key in the social object will be used to fetch one of the theme’s icons, feel free to use any of the icons available in your setup._ +_注: ソーシャルオブジェクトのキーは、テーマのアイコンの1つを取得するために使用されます。セットアップで利用可能な任意のアイコンを自由に使用してください。_ ```json { "name": "Nuno Coração", "image" : "img/nuno_avatar.jpg", - "bio": "Theme Creator", + "bio": "テーマ作成者", "social": [ { "linkedin": "https://linkedin.com/in/nunocoracao" }, { "twitter": "https://twitter.com/nunocoracao" }, @@ -45,19 +44,18 @@ _Note: the key in the social object will be used to fetch one of the theme’s i } ``` +## 記事で著者を参照する -## Reference Authors in Articles - -Now that you created one author, the next step is to reference it in one or more articles. In the example below, we reference the author created in the previous step using its `key`. +著者を作成したので、次のステップは1つ以上の記事でそれを参照することです。以下の例では、前のステップで作成した著者をその `key` を使用して参照しています。 -This will render an extra author using the data provided in the `json` file. This feature does not change in any way the default author configured for the overall site, and therefore, you can control both separately. Using the `showAuthor` parameter, you can configure whether to show the default author, that is the normal use-case for a single author blog. The new `authors` front-matter parameter allows you to define authors specifically to an article, and they will be rendered independently of the configurations for the default site author. +これにより、`json` ファイルで提供されたデータを使用して追加の著者がレンダリングされます。この機能は、サイト全体に設定されたデフォルトの著者を一切変更しないため、両方を個別に制御できます。`showAuthor` パラメータを使用すると、デフォルトの著者を表示するかどうかを設定できます。これは、単一著者のブログの通常の使用例です。新しい `authors` フロントマターパラメータを使用すると、記事に固有の著者を定義でき、それらはデフォルトのサイト著者の設定とは独立してレンダリングされます。 ```md --- -title: "Multiple Authors" +title: "複数の著者" date: 2020-08-10 draft: false -description: "Configure multiple authors for your articles." +description: "記事に複数の著者を設定する。" slug: "multi-author" tags: ["authors", "config", "docs"] showAuthor: true @@ -67,13 +65,13 @@ showAuthorsBadges : false --- ``` -In the example, which matches the markdown of the current page, both the default author and the new one will be displayed. You can scroll now to see the outcome. +この例は、現在のページの Markdown と同じもので、デフォルトの著者と新しい著者の両方が表示されます。スクロールして結果を確認できます。 -## Create the Authors Taxonomy +## 著者タクソノミーを作成する -To get lists of articles for each of your authors you can configure the `authors` taxonomy, which opens up some more configurations that might be interesting. This is an optional step in the process that is not required to display the authors in your articles. +著者ごとに記事のリストを取得するには、`authors` タクソノミーを設定できます。これにより、さらに興味深い設定がいくつか可能になります。これは、記事に著者を表示するために必要なプロセスではオプションのステップです。 -First step is to configure the `authors` taxonomy in your `config.toml` file, like in the example below. Even though `tag` and `category` are defined by default with Hugo, once you add a specific taxonomies section you need to add them again otherwise the site will not process them. +最初のステップは、以下の例のように、`config.toml` ファイルで `authors` タクソノミーを設定することです。`tag` と `category` はデフォルトで Hugo で定義されていますが、一度特定のタクソノミーセクションを追加したら、再度追加する必要があります。そうしないと、サイトはそれらを処理しません。 ```toml [taxonomies] @@ -82,21 +80,21 @@ First step is to configure the `authors` taxonomy in your `config.toml` file, li author = "authors" ``` -And that’s just about it. Now you will have pages that reference your authors and, for each, show the respective list of articles where they participate. You can also use the `article.showAuthorsBadges` on the config file, or `showAuthorsBadges` on each article to chose whether to display the `authors` taxonomy as badges in each post item. As an example, this doc is configured to not display authors but if you look at the sample referenced below you will see the authors displayed as badges. +これでほぼ完了です。著者を指定するページが作成され、それぞれに、参加している記事のリストが表示されます。設定ファイルで `article.showAuthorsBadges` を使用したり、各記事で `showAuthorsBadges` を使用したりして、各投稿アイテムに `authors` タクソノミーをバッジとして表示するかを選択できます。例として、このドキュメントでは著者を表示しないように設定されていますが、以下に参照されているサンプルを見ると、著者がバッジとして表示されていることがわかります。 -Lastly, you can add more detail to each author page so that it displays a little bio, links, or whatever information fits your use-case. To achieve that, create a folder with the `key` to each author inside `./content/authors` and inside each folder place a `_index.md` file. For the example above, we would end up with a `.content/authors/nunocoracao/_index.md` file. Inside, you can configure the actual name of the author and the contents of their page. Authors in this documentation website are configured like this, so you can have a look by playing around with the site. +最後に、各著者ページに詳細を追加して、ちょっとした経歴、リンク、または用途に合った情報を表示できます。これを実現するには、`./content/authors` 内に各著者への `key` を持つフォルダを作成し、各フォルダ内に `_index.md` ファイルを配置します。上記の例では、`.content/authors/nunocoracao/_index.md` ファイルが作成されます。この中で、著者の実際の名前とそのページの内容を設定できます。このドキュメントウェブサイトの著者はこのように設定されているため、サイトをいじって見てください。 ```md --- title: "Nuno Coração" --- -Nuno's awesome dummy bio. +Nuno の素晴らしいダミー経歴。 ``` -## Sample +## サンプル -This sample sample below shows an example where the default site author is turned off and the article has multiple authors. +以下のサンプルは、デフォルトのサイト作成者がオフになっており、記事に複数の作成者がいる例を示しています。 -{{< article link="/samples/multiple-authors/" >}} \ No newline at end of file +{{< article link="/samples/multiple-authors/" >}} diff --git a/exampleSite/content/docs/partials/index.ja.md b/exampleSite/content/docs/partials/index.ja.md index 0c8bd31da..ba18e0238 100644 --- a/exampleSite/content/docs/partials/index.ja.md +++ b/exampleSite/content/docs/partials/index.ja.md @@ -1,21 +1,21 @@ --- -title: "Partials" +title: "パーシャル" weight: 9 draft: false -description: "All the partials available in Blowfish." +description: "Blowfish で利用可能なすべてのパーシャル。" slug: "partials" tags: ["partials", "analytics", "privacy", "comments", "favicons", "icon", "docs"] series: ["Documentation"] 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 Analytics、Google アナリティクス、Umami Analytics のビルトインサポートを提供しています。Fathom は、ユーザーのプライバシーを尊重する Google アナリティクスの有料の代替手段です。 ### Fathom Analytics -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. +Fathom Analytics のサポートを有効にするには、`config/_default/params.toml` ファイルに Fathom サイトコードを指定するだけです。Fathom のカスタムドメイン機能を使用していて、ドメインからスクリプトを配信したい場合は、追加で `domain` 設定値を指定することもできます。`domain` 値を指定しない場合、スクリプトは Fathom DNS から直接ロードされます。 ```toml # config/_default/params.toml @@ -25,29 +25,29 @@ 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. +Google アナリティクスのサポートは、Hugo の内部パーシャルを介して提供されます。`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" ``` ### 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). -If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and`websiteid` match. If the environment variable `TRACKER_SCRIPT_NAME` is configured, you can specify a custom script name `scriptName`. If it is not configured, either comment it out or use the default `script.js`. +Umami Analytics のサポートを有効にするには、`config/_default/params.toml` ファイルに [Umami トラッキングコード](https://umami.is/docs/collect-data)を指定するだけです。 +Umami のカスタムドメイン機能を使用していて、ドメインからスクリプトを配信したい場合は、追加で `domain` 設定値を指定することもできます。`domain` 値を指定しない場合、スクリプトは Umami DNS (analytics.umami.is) から直接ロードされます。 +トラッカーを特定のドメインでのみ実行したい場合は、`dataDomains` 設定値を指定できます。`dataDomains` 値を指定しない場合、スクリプトは `domain` と `websiteid` が一致する任意のウェブサイトで実行されます。環境変数 `TRACKER_SCRIPT_NAME` が設定されている場合は、カスタムスクリプト名 `scriptName` を指定できます。設定されていない場合は、コメントアウトするか、デフォルトの `script.js` を使用してください。 {{< alert >}} -**Note:** If you enable Umami Analytics, Blowfish will support [Umami Track Event](https://umami.is/docs/track-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`. +**注:** Umami Analytics を有効にすると、Blowfish は [Umami トラックイベント](https://umami.is/docs/track-events)を自動的にサポートします。トラックイベントをサポートしたくない場合は、パラメータ `enableTrackEvent` を `false` に設定する必要があります。 {{< /alert >}} ```toml @@ -63,9 +63,10 @@ If you want the tracker to only run on specific domains, you can provide the `da ### Seline Analytics -To enable Seline Analytics support, simply provide your [Seline token](https://seline.so/docs/install-seline) in the `config/_default/params.toml` file. +Seline Analytics のサポートを有効にするには、`config/_default/params.toml` ファイルに [Seline トークン](https://seline.so/docs/install-seline)を指定するだけです。 + {{< alert >}} -**Note:** If you enable Seline Analytics, Blowfish will support [Seline Track Event](https://seline.so/docs/custom-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`. +**注:** Seline Analytics を有効にすると、Blowfish は [Seline トラックイベント](https://seline.so/docs/custom-events)を自動的にサポートします。トラックイベントをサポートしたくない場合は、パラメータ `enableTrackEvent` を `false` に設定する必要があります。 {{< /alert >}} ```toml @@ -76,23 +77,23 @@ To enable Seline Analytics support, simply provide your [Seline token](https://s enableTrackEvent = true ``` -### 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. +ウェブサイトで別のアナリティクスプロバイダーを使用したい場合は、アナリティクスパーシャルをオーバーライドして、独自のスクリプトを提供することもできます。プロジェクトに `layouts/partials/extend-head.html` ファイルを作成するだけで、ウェブサイトの `` に自動的に含まれます。 -## Comments +## コメント -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. +記事にコメントを追加するために、Blowfish には、各記事ページの下部に含まれるコメントパーシャルのサポートが含まれています。選択したコメントを表示するために必要なコードを含む `layouts/partials/comments.html` を指定するだけです。 -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. +組み込みの Hugo Disqus テンプレートを使用するか、独自のカスタムコードを提供できます。詳細については、[Hugo ドキュメント](https://gohugo.io/content-management/comments/)を参照してください。 -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. +パーシャルが提供されると、コメントが表示される場所をより細かく制御するために、`showComments` パラメータを使用して管理されます。この値は、`params.toml` [設定ファイル]({{< ref "configuration#テーマパラメーターtheme-parameters" >}})のテーマレベルで設定するか、[フロントマター]({{< ref "front-matter" >}})に含めることで記事ごとに設定できます。パラメータはデフォルトで `false` であるため、コメントを表示するには、これらの場所のいずれかで `true` に設定する必要があります。 -## 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 は、開始するための空白のファビコンのデフォルトセットを提供しますが、独自のアセットを提供してそれらを上書きできます。新しいファビコンアセットを取得する最も簡単な方法は、[favicon.io](https://favicon.io) などのサードパーティプロバイダーを使用してそれらを生成することです。 -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. +アイコンアセットは、ウェブサイトの `static/` フォルダに直接配置し、以下のリストに従って名前を付ける必要があります。[favicon.io](https://favicon.io) を使用する場合、これらは自動的に生成されるファイル名になりますが、必要に応じて独自のアセットを提供できます。 ```shell static/ @@ -105,34 +106,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. +または、デフォルトのファビコンの動作を完全にオーバーライドして、独自のファビコン HTML タグとアセットを提供することもできます。プロジェクトに `layouts/partials/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#アイコン" >}})と同様に、Blowfish の `icon.html` パーシャルを使用して、独自のテンプレートやパーシャルにアイコンを含めることができます。パーシャルは、含めるアイコンの名前である1つのパラメータを受け取ります。 -**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" >}})ページを確認してください。 -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/` ディレクトリに独自のアイコンアセットを提供することで追加できます。その後、`.svg` 拡張子なしで SVG ファイル名を使用して、パーシャルでアイコンを参照できます。 -Icons can also be used in article content by calling the [icon shortcode]({{< ref "shortcodes#icon" >}}). +アイコンは、[アイコンショートコード]({{< ref "shortcodes#アイコン" >}})を呼び出すことで、記事のコンテンツでも使用できます。 -## 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#バッジ" >}})と組み合わせると特に効果的です。 -### Head and Footer +### ヘッダーとフッター -The theme allows for inserting additional code directly into the `` and `