アセット
トピックからアセット(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 を参照してください。