インラインコンテンツ

インラインパレットを使って、画像、リンク、数式 & TeX などを追加する

コンテンツにインライン要素を追加します。

インラインパレットを使うと、キーボードから手を離さずにテキストブロックへ追加コンテンツをすばやく挿入できます。 / を任意のテキストブロックで押すと、インラインパレットが開きます。スラッシュは、挿入するために選んだコンテンツに置き換えられます。

注釈

注釈を使うと、読者の思考の流れを妨げることなく、言葉に追加の文脈を加えられます。単語の意味を説明したり、補足情報を挿入したり、さまざまな用途に使えます。読者は注釈付きテキストにカーソルを合わせると、テキストの上に注釈を表示できます。

注釈を作成する

注釈を作成するには、注釈を付けたいテキストを選択し、 注釈を付ける オプションをコンテキストメニューでクリックします。注釈を書いたら、その外側をクリックしてテキストブロックでの入力を続けます。

Markdown 表記

コンテンツを Markdown の脚注 として記述すると、GitBook で注釈として追加できます。脚注インジケーターは注釈を付けたい単語の直後に置く必要があり、句読点やその他の記号の後に置いてはいけません。

これはシンプルな脚注[^1]です。こちらは長めの脚注[^bignote]です。

[^1]: これは最初の脚注です。

[^bignote]: これは複数の段落とコードを含むものです。

    脚注に含めるには段落をインデントしてください。

    `{ my code }`

    段落はいくつでも追加できます。

画像

インライン画像は、ページ上でテキストと並んで表示されます。

デフォルトでは、画像は元のサイズのままで最大幅 300px に設定されています。サイズを変更するには、画像をクリックして書式設定パレットを開き、次の 3 つのオプションのいずれかを選択します。

1. インラインサイズ: 画像はフォントに合わせて比例的にサイズ変更されます。アイコンやバッジに最適です。

2. 元のサイズ: 画像は元のサイズのままインライン表示され、最大幅は 300 ピクセルです。

3. ブロックに変換: これにより、インライン画像が 画像ブロックに変わり、コンテンツと同じ幅になります。

画像ブロック では、より多くのサイズ指定やキャプション追加など、さらに多くのオプションを利用できますが、テキストとインラインでは表示されません。

Markdown での表現

これはインライン画像です: <img src=".gitbook/assets/GitBook - Dark.jpg" alt="GitBook ロゴのダークバージョン" data-size="line">

絵文字

を押してインラインパレットを開くと、絵文字を追加できます。 / または、 : と入力すると、絵文字の一覧がその場に直接表示されます。絵文字名を入力し始めると候補を絞り込めます。

Markdown での表現

:house:
:car:
:dog:

リンク

3 種類のリンクを挿入できます:

• 相対リンク

• 絶対リンク

• メールアドレス mailto リンク

相対リンク

相対リンクは、 ページ すでにスペース内に存在するページへリンクして作成するリンクです。相対リンクを使う利点は、ページの URL、名前、または場所が変更されても参照が最新の状態に保たれることです。つまり、リンク切れが少なくなります。

相対リンクを挿入する方法は次のとおりです:

1. リンクを挿入したい段落内の場所をクリックするか、テキストを選択します。

2. インラインパレットを開くために / を押して Link を選ぶか、 リンク ボタンをコンテキストメニューでクリックするか、 ⌘ + K.

3. リンクしたいページのタイトルを入力し始めます。

4. ドロップダウン検索結果からページを選択します。

5. 押す Enter.

絶対リンク

絶対リンクは、コンテンツにコピー＆ペーストできる外部リンクです。ドキュメントの外にあるものへリンクしたいときに最適です。

絶対リンクを挿入するには:

1. リンクを挿入したい段落内の場所をクリックするか、テキストを選択します。

2. インラインパレットを開くために / を押して Link を選ぶか、 リンク ボタンをコンテキストメニューでクリックするか、 ⌘ + K.

3. リンク先にしたい URL を貼り付けます。

4. 押す Enter.

なぜ外部リンクは新しいタブで開かないのですか？

ドキュメント内で外部サイトへのリンクを追加すると、同じタブで開きます。

GitBook はこの W3C 推奨の動作 に従って、 アクセシビリティ をサポートし、読者に一貫性があり包括的な体験を提供します。

メールアドレスの mailto リンク

メールアドレス mailto リンクは、訪問者がクリックすると既定のメールクライアントが開き、 宛先 欄にリンク先のメールアドレスが入力されるようにしたい場合に便利です。これにより、メールを書いて送信できます。

メールアドレスの mailto リンクを挿入する方法は次のとおりです:

1. リンクを挿入したい段落内の場所をクリックするか、テキストを選択します。

2. インラインパレットを開くために / を押して Link を選ぶか、 リンク ボタンをコンテキストメニューでクリックするか、 ⌘ + K.

3. 貼り付けるか入力します mailto:[e-mail]、ここで [e-mail] を使用したいメールアドレスに置き換えます。

4. 押す Enter.

Markdown での表現

[これはこのスペース内の別のページへの相対リンクです](../content-structure/page.md)
[これは絶対リンクです](https://www.gitbook.com/blog)
[これはリンクです](mailto:[e-mail])。サポート用メールアドレスへのリンクです

数式 & TeX

このオプションを使うと、コンテンツ内に次のようなインライン数式を作成できます: $f(x) = x * e^{2 pi i \xi x}$。数式のレンダリングには KaTeX ライブラリを使用しています。

また、 ブロックレベルの数式 を、空のブロックでコマンドパレットを開き、2 つ目の Math & TeX オプションを選ぶことで挿入することもできます。

Markdown での表現

# 数式と TeX ブロック

$$f(x) = x * e^{2 pi i \xi x}$$

ボタン

ボタンは、行動喚起を目立たせたり、ドキュメントに検索バーや Ask AI バーを追加したりするのに最適な方法です。読者をどこかへ誘導したり、答えを見つける手助けをしたりできます。

ボタンのアクション

ボタンは URL へのリンク以上のことができます。ページ上から直接、ボタンを検索バーや GitBook Assistant への質問バーにすることもできます。これらのアクションは公開ページでも機能します。以下の例で確認できます

次のアクションを設定できます:

リンクボタンを追加する

読者を別のページまたは外部 URL に送る:Assistant について詳しく知る

検索バーを追加する

任意の事前設定クエリで検索を開く:

Ask AI/GitBook Assistant バーを追加する

開く GitBook Assistant 任意の事前設定プロンプト付きで:

無効なボタンを追加する

意図的に無効化されたボタンを表示する:

ボタンを作成して設定する

1. 入力します / を選択し、 Button.

2. ボタンをクリックして ラベル メニューを開きます。

3. アクションを選び、ラベルとスタイルを設定します。

4. 任意: 事前設定の検索クエリまたは Assistant プロンプトを追加します。

スタイル

リンクボタンと無効ボタンには、どちらもプライマリとセカンダリのスタイルがあります。以下にいくつか例を示します:

GitBook にサインアップ トップへ移動

Markdown での表現

<a href="https://app.gitbook.com" class="button primary">GitBook</a>

アイコン

アイコンを使うと、サイトに追加の視覚的な目印を加えられます。段落内にインラインで追加したり、カードの中に入れたり、その他アクセントを加えたい場所ならどこにでも追加できます。見た目は カスタマイズ設定.

で定義されたビジュアルスタイルを使用します。訪問する Font Awesome で利用可能なさまざまなアイコンを確認してください。

Markdown での表現

<i class="fa-github">:github:</i>

式

式を使うと、 変数で定義されたコンテンツを動的に表示できます。式は / メニューから挿入できます。挿入後に式をクリックすると式エディターが開き、変数を参照して 条件付きで書式設定 できます。