blowfish/exampleSite/content/docs/getting-started/index.ja.md at 74fa6ea570e0a29f0291bb0edd36da57df9cd9d4

michael/blowfish

Fork 0

mirror of https://github.com/nunocoracao/blowfish.git synced 2025-01-23 06:55:43 -06:00

Nuno Coração eebbf00941 corrected

2025-01-10 22:50:01 +00:00

13 KiB

Raw Blame History

title

weight

draft

description

slug

基本設定

コンテンツを作成する前に、新しいインストール用に設定する必要があるものがいくつかあります。まず、hugo.toml ファイルで、baseURL と languageCode パラメータを設定します。languageCode は、コンテンツの作成に使用する主要言語に設定する必要があります。

# config/_default/hugo.toml

baseURL = "https://your_domain.com/"
languageCode = "ja"

次のステップは、言語設定です。Blowfish は多言語設定をサポートしていますが、ここではまず主要言語を設定します。

設定フォルダで languages.en.toml ファイルを見つけます。主要言語が英語の場合は、このファイルをそのまま使用できます。それ以外の場合は、ファイル名に正しい言語コードが含まれるように名前を変更します。例えば日本語の場合は、languages.ja.tomlにファイル名を変更します。

{{< alert >}} 言語設定ファイル名の言語コードは、hugo.toml の languageCode 設定と一致する必要があることに注意してください。 {{< /alert >}}

# config/_default/languages.ja.toml

title = "私の素晴らしいウェブサイト"

[params.author]
name = "私の名前"
image = "img/author.jpg"
headline = "一般的に素晴らしい人間"
bio = "私について少し"
links = [
  { twitter = "https://twitter.com/username" }
]

[params.author] 設定は、ウェブサイトに著者情報をどのように表示するかを決定します。画像はサイトの assets/ フォルダに配置する必要があります。リンクはリストされている順序で表示されます。

これらの設定オプションの詳細については、[設定]({{< ref "configuration" >}})セクションで説明しています。

カラースキーム

Blowfish には、すぐに使用できる多くのカラースキームが付属しています。スキームを変更するには、colorScheme テーマパラメータを設定するだけです。有効なオプションは、blowfish (デフォルト)、avocado、fire、ocean、forest、princess、neon、bloody、terminal、marvel、noir、autumn、congo、slate です。

# config/_default/params.toml

colorScheme = "blowfish"

Blowfish は、テーマ全体で使用される3色のパレットを定義しています。各メインカラーには、Tailwind に含まれる色に基づいた10の色合いが含まれています。3つのメインカラーは、ヘッダー、フッター、およびアクセントカラーに使用されます。各スキームの色は次のとおりです。

Blowfish (デフォルト)

Avocado

Fire

Ocean

Forest

Princess

Neon

Bloody

Terminal

Marvel

Noir

Autumn

Congo

Slate

これらはデフォルトのスキームですが、独自のスキームを作成することもできます。詳細については、[高度なカスタマイズ]({{< ref "advanced-customisation#colour-schemes" >}})セクションを参照してください。

コンテンツの整理

デフォルトでは、Blowfish は特定のコンテンツタイプを使用することを強制しません。そのため、コンテンツを自由に定義できます。静的サイトの場合は pages、ブログの場合は posts、ポートフォリオの場合は projects を使用することをお勧めします。

基本的な Blowfish プロジェクトの概要を簡単に説明します。すべてのコンテンツは content フォルダ内に配置されます。

.
├── assets
│   └── img
│       └── author.jpg
├── config
│   └── _default
├── content
│   ├── _index.md
│   ├── about.md
│   └── posts
│       ├── _index.md
│       ├── first-post.md
│       └── another-post
│           ├── aardvark.jpg
│           └── index.md
└── themes
    └── blowfish

このテーマは Hugo のページバンドルを最大限に活用するように設計されているため、Hugo がどのようにコンテンツを整理することを想定しているかをしっかりと把握することが重要です。詳細については、Hugo 公式ドキュメントを参照してください。

Blowfish はタクソノミーに関しても柔軟です。tags と categories を使用してコンテンツをグループ化することを好む人もいれば、topics を使用することを好む人もいます。

Hugo はデフォルトで posts、tags、categories を使用するように設定されており、これを希望する場合は問題なく動作します。ただし、これをカスタマイズしたい場合は、taxonomies.toml 設定ファイルを作成することでカスタマイズできます。

# config/_default/taxonomies.toml

topic = "topics"

これにより、デフォルトの tags と categories が topic に置き換えられます。タクソノミーの命名の詳細については、Hugo タクソノミードキュメントを参照してください。

新しいタクソノミーを作成する場合は、ウェブサイトのナビゲーションリンクを調整して、正しいセクションを指すようにする必要があります。これについては以下で説明します。

メニュー

Blowfish には、サイトのコンテンツとレイアウトに合わせてカスタマイズできる2つのメニューがあります。main メニューはサイトヘッダーに表示され、footer メニューはページの下部、著作権表示のすぐ上に表示されます。

どちらのメニューも menus.ja.toml ファイルで設定できます。言語設定ファイルと同様に、別の言語を使用したい場合は、このファイルの名前を変更して、en を使用したい言語コードに置き換えます。

# config/_default/menus.ja.toml

[[main]]
  name = "ブログ"
  pageRef = "posts"
  weight = 10

[[main]]
  name = "トピック"
  pageRef = "topics"
  weight = 20

[[main]]
  pre = "github"
  name = "GitHub"
  url = "https://github.com/nunocoracao/blowfish"
  weight = 30

[[main]]
  identifier = "github2"
  pre = "github"
  url = "https://github.com/nunocoracao/blowfish"
  weight = 40

[[footer]]
  name = "プライバシー"
  url = "https://external-link"

name パラメータは、メニューリンクで使用されるテキストを指定します。オプションで、リンクの HTML タイトル属性を設定する title を指定することもできます。

pageRef パラメータを使用すると、Hugo コンテンツページとタクソノミーを簡単に参照できます。これは、Hugo コンテンツアイテムを参照するだけで正しいリンクが自動的に作成されるため、メニューを設定する最も簡単な方法です。外部 URL にリンクするには、url パラメータを使用できます。

pre パラメータを使用すると、[Blowfish のアイコンセット]({{< ref "samples/icons" >}})からメニューエントリにアイコンを配置できます。このパラメータは、name パラメータと組み合わせて使用することも、単独で使用することもできます。アイコンのみを使用して複数のメニューエントリを使用する場合は、identifier パラメータを設定してください。そうしないと、Hugo はデフォルトで命名タグを ID として使用し、おそらくすべてのメニューエントリを表示しません。

メニューリンクは、weight が低い順に並べ替えられ、次に name でアルファベット順に並べ替えられます。

どちらのメニューも完全にオプションであり、不要な場合はコメントアウトできます。ファイルに記載されているテンプレートをガイドとして使用してください。

ネストされたメニュー

テーマはネストされたメニューもサポートしています。これらを使用するには、menu.toml で親エントリを定義し、parent パラメータを使用し親を参照してサブメニューを定義するだけです。すべてのプロパティは、サブメニューに使用できます。pageRef と url は、親エントリでも使用できます。ネストされたメニューは、メインメニューでのみ使用でき、フッターでは使用できません。

# config/_default/menus.ja.toml

[[main]]
  name = "親"
  weight = 20

[[main]]
  name = "サブメニュー 1"
  parent = "親"
  pageRef = "samples"
  weight = 20

[[main]]
  name = "サブメニュー 2"
  parent = "親"
  pageRef = "samples"
  weight = 20

[[main]]
  name = "サブメニュー 3"
  parent = "親"
  pre = "github"
  pageRef = "samples"
  weight = 20

サブナビゲーションメニュー

さらに、サブナビゲーションメニューを設定することもできます。menus.toml で新しいメニューエントリを subnavigation として定義するだけです。これにより、メインヘッダーメニューの下に、サブカテゴリを含む2行目が表示されます。

# config/_default/menus.ja.toml

[[subnavigation]]
  name = "興味深いトピック"
  pageRef = "tags/interesting-topic"
  weight = 10

[[subnavigation]]
  name = "私の素晴らしいカテゴリ"
  pageRef = "categories/awesome"
  weight = 20

デフォルトの name は、pageRef のタイトルになります。

サムネイルと背景

Blowfish は、記事に視覚的なサポートを簡単に追加できるように構築されました。Hugo の記事構造に慣れている場合は、記事フォルダ内に feature* で始まる画像ファイル (ほとんどすべての形式がサポートされていますが、.png または .jpg を推奨) を配置するだけです。それだけで、Blowfish はその画像をウェブサイト内のサムネイルとして使用したり、ソーシャルプラットフォーム全体の oEmbed カードに使用したりできるようになります。

詳細な情報と、設定方法を確認するための[サンプル]({{< ref "thumbnail_sample" >}})を含むガイドも[こちら]({{< ref "thumbnails" >}})にあります。

さらに、Blowfish は記事やリストの背景ヒーロー画像もサポートしています。フィーチャー画像とは異なる画像を使用するには、名前が background* で始まる画像ファイルを（記事フォルダに）追加します。

詳細設定

上記の手順は、最低限の設定です。hugo server を実行すると、空の Blowfish ウェブサイトが表示されます。詳細な設定については、[設定]({{< ref "configuration" >}})セクションで説明しています。

13 KiB Raw Blame History Unescape Escape