メインコンテンツまでスキップ

アセット

トピックからアセット(docx ファイルや画像など)に直接リンクしたい場合があります。docStatic では static/ フォルダを通じてこれを管理します。

フォルダに配置されたコンテンツはすべて、公開サイトのルートから利用可能になります。たとえば:

# ドキュメント
/website/docs/myFeature.mdx

# 使用したいアセット
/website/assets/docstatic-asset-example.docx
/website/img/docstastic-asset-example-banner.png

画像

docStatic には、トピックに画像を追加する2つの方法があります。インライン画像の場合は、Image アイコンをクリックしてトピックに画像を配置できます。これはアイコン()や小さな画像に最適です。アイコンは事前にスケーリングされた SVG ファイルとして保存してください。これらはダークモードでは反転され、色空間が 180° 回転されます。

ヒント

SVG のスケーリングには Librsvg を使用できます。たとえば、rsvg-convert example.svg -h 12 -f svg -o example.svg は高さを 12 ポイントに設定します。

大きな画像の場合は、Figure コンポーネントを使用することをお勧めします。

  1. Embed リストから Figure を選択します。
  2. コンポーネントを編集します。
  3. Image エリアをクリックして Media Manager を開きます。
  4. 画像をアップロードまたは選択します。
  5. Caption(キャプション)を付けます。

図の例
図の例

図はビューウィンドウに基づいてサイズが変更されます。クリックすると、ライトボックス内で最大サイズで表示されます。

Media Manager の詳細については、TinaCMS ドキュメントの Media Overview を参照してください。

ファイル

同様に、URL 内で static/ フォルダからのパスを使用することで、既存のアセットにリンクできます。たとえば:

./assets/docstatic-asset-example.docx

詳細については、Docusaurus ドキュメントの Static assets を参照してください。