blowfish/exampleSite/content/docs/thumbnails/index.ja.md

title	weight	draft	description	slug	tags	series	series_order
サムネイル	10	false	記事にサムネイル画像を設定する。	thumbnails	thumbnail config docs	Documentation	6

サムネイル

Blowfish は、記事に視覚的な要素を簡単に追加できるように改良されました。サムネイル画像を設定するには、以下の例のように、記事のメインディレクトリ内に feature* で始まる画像ファイル (ほとんどすべての形式がサポートされていますが、.png または .jpg を推奨) を配置するだけです。

content
└── awesome_article
    ├── index.md
    └── featured.png

このように配置することで、Blowfish は記事にサムネイル画像があることを認識し、ウェブサイト全体でサムネイルとして使用したり、ソーシャルプラットフォームで共有する際の oEmbed カード用画像として使用したりできます。

フォルダ構成

記事を単一の .md ファイルで管理していて、次のようなファイル構成になっている場合:

content
└── awesome_article.md

単一の Markdown ファイルからフォルダ形式に変更する必要があります。記事と同じ名前のディレクトリを作成し、その中に index.md ファイルを作成します。以下のような構成になります。

content
└── awesome_article
    └── index.md

あとは、前述のように画像を追加するだけです。設定例を確認したい場合は、[こちらのサンプル]({{< ref "thumbnail_sample" >}}) をご覧ください。

ヒーロー画像

サムネイル画像は、デフォルトで各記事のヒーロー画像としても使用されます。サイト全体、または特定の記事ごとにこの機能を設定するには、config/_default/params.toml 内の article.showHero、または各記事のフロントマターパラメータ showHero を使用します。ヒーロー画像のスタイルを変更したい場合は、./layouts/partials/ に hero.html というファイルを作成することで、テーマの元のパーシャルを上書きできます。