インラインコンテンツ

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

A GitBook screenshot showing inline content options
インライン要素をコンテンツに追加します。

インラインパレットを使うと、キーボードから手を離さずにテキストブロックに追加コンテンツを素早く挿入できます。単に任意のテキストブロックで / を押してインラインパレットを開きます。スラッシュは、挿入するコンテンツに置き換えられます。

注釈

注釈を使うと、読者の思考の流れを途切れさせることなく語句に追加のコンテキストを付け加えられます。語の意味を説明したり、追加情報を挿入したりするのに使えます。読者は注釈の付いたテキストにカーソルを合わせると、テキストの上に注釈が表示されます。

注釈を作成する

注釈を作成するには、注釈したいテキストを選択して 注釈 をコンテキストメニューでクリックします。注釈を書き終えたら、その外側をクリックしてテキストブロックの執筆を続けます。

Markdown 表現

コンテンツを Markdown の脚注arrow-up-right として書き、GitBook に注釈として追加することができます。脚注の指標は注釈したい語の直後に表示されるべきで、句読点や他の記号の後に表示されるべきではありません。

画像

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

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

  1. インラインサイズ: 画像はフォントに比例したサイズになり、アイコンやバッジに最適です。

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

  3. ブロックに変換: これによりインライン画像が 画像ブロックに変わり、コンテンツ幅いっぱいの表示になります。

circle-info

画像ブロックは より多くのサイズやキャプションを追加する機能など、より多くのオプションを提供しますが、テキストとインライン表示されることはありません。

Markdown における表現

絵文字

絵文字は / を押してインラインパレットを開くことで追加できます。あるいは、 : と入力すると絵文字のリストがその場で表示されます — 絵文字の名前を入力して候補を絞り込めます。

Markdown における表現

リンク

挿入できるリンクの種類は3つあります:

相対リンク

相対リンクは、スペース内に既に存在する ページ へリンクすることで作成されるリンクです。相対リンクを使う利点は、ページのURL、名前、場所が変更されても参照が最新に保たれるため、壊れたリンクが減ることです。

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

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

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

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

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

  5. Enter.

絶対リンク

絶対リンクは外部へのリンクで、URLをコピーしてコンテンツに貼り付けられます。ドキュメント外の何かにリンクしたいときに便利です。

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

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

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

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

  4. Enter.

circle-info

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

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

GitBook はこの W3C 推奨の振る舞いarrow-up-right に従い、 アクセシビリティarrow-up-right をサポートして、読者に一貫した包括的な体験を提供します。

メールアドレス mailto リンク

メールアドレス mailto リンクは、訪問者がクリックするとデフォルトのメールクライアントが開き、 宛先 フィールドにリンクのメールアドレスが入力された状態でメールを書けるようにする場合に便利です。

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

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

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

  3. 貼り付けるか入力します mailto:something@address.com、そして something@address.com を使用したいメールアドレスに置き換えます。

  4. Enter.

Markdown における表現

数式と TeX

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

circle-info

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

Markdown における表現

ボタン

ボタンは行動喚起(CTA)を示す優れた方法です。ユーザーを GitBook 内の他のページや外部のURLに送るのに使用できます。

ボタンにはプライマリとセカンダリのスタイルがあります。以下はいくつかの例です:

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

Markdown における表現

アイコン

アイコンを使うとサイトに視覚的な付加表示を追加できます。段落内にインラインで追加したり、カード内や他の任意の場所に配置してデザイン性を高めることができます。アイコンは カスタマイズ設定.

facebook github x-twitter instagram

で定義されたビジュアルスタイルを使用します。 を訪れてarrow-up-right Font Awesome

Markdown における表現

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

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

最終更新

役に立ちましたか?