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

アセット

トピックからアセット(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 コンポーネントを使用してください。キャプションが追加され—これはスクリーンリーダー用の alt テキストとしても使用されます—ページに合わせてサイズが調整され、クリックするとライトボックスで全画面表示されます。

図の例

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

ファイル

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

./assets/docstatic-asset-example.docx

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