コンテンツにスキップ

ディレクトリ構成

CLIウィザードのcreate astroで生成した新しいAstroプロジェクトには、いくつかのファイルとフォルダが含まれています。その他は自分で作成し、Astroの既存のファイル構成に追加します。

ここでは、Astroプロジェクトがどのように構成されているか、また、新しいプロジェクトに含まれるいくつかのファイルについて説明します。

Astroは、プロジェクトで独自のディレクトリ構成を利用します。すべてのAstroプロジェクトのルートには、以下のディレクトリとファイルを含む必要があります。

  • src/* - プロジェクトソースコード(コンポーネント、ページ、スタイルなど)
  • public/* - コード以外の処理不要のアセット(フォント、アイコンなど)
  • package.json - プロジェクトマニフェスト
  • astro.config.mjs - Astroの設定ファイル(推奨)
  • tsconfig.json - TypeScriptの設定ファイル(推奨)

よくあるAstroプロジェクトのディレクトリは次のような形です。

  • ディレクトリpublic/
    • robots.txt
    • favicon.svg
    • social-image.png
  • ディレクトリsrc/
    • ディレクトリcomponents/
      • Header.astro
      • Button.jsx
    • ディレクトリlayouts/
      • PostLayout.astro
    • ディレクトリpages/
      • ディレクトリposts/
        • post1.md
        • post2.md
        • post3.md
      • index.astro
    • ディレクトリstyles/
      • global.css
  • astro.config.mjs
  • package.json
  • tsconfig.json

src/ディレクトリには、プロジェクトのソースコードのほとんどが格納されます。これには以下が含まれます。

Astroは、src/内にあるファイルを処理し、最適化し、バンドルして、ブラウザに表示される最終的なウェブサイトを作成します。 静的なpublic/ディレクトリとは違い、src/内にあるファイルはAstroによってビルドされ、処理されます。

一部のファイル(Astroコンポーネントなど)は、そのままブラウザに送信されず、静的なHTMLに変換されます。その他のファイル(CSSなど)はブラウザに送信されますが、パフォーマンスのために最適化されたり、他のCSSファイルとバンドルされたりする場合があります。

コンポーネントは、HTMLページで再利用可能なコードの単位です。Astroコンポーネントや、ReactやVueなどのUIフレームワークコンポーネントがこれにあたります。 プロジェクトのすべてのコンポーネントをこのフォルダにまとめて整理するのが一般的です。

これはAstroプロジェクトでは一般的な慣習ですが、必須ではありません。好きなようにコンポーネントを整理してください!

src/content/ディレクトリは、コンテンツコレクションと、オプションのコレクション設定ファイルを格納するために予約されています。このフォルダには他のファイルを置くことはできません。

レイアウトは、複数のページで共有されるUI構造を定義するためのAstroコンポーネントです。

src/componentsと同様に、このディレクトリは一般的な慣習ですが、必須ではありません。

ページは、サイト上に新しいページを作成するために使用される、特別な種類のコンポーネントです。ページは、Astroコンポーネントまたは、サイトのコンテンツのページを表すMarkdownファイルになります。

CSSやSassのファイルをsrc/stylesディレクトリに格納するのは一般的な慣習ですが、必須ではありません。スタイルがsrc/ディレクトリのどこかにあり、正しくインポートされていれば、Astroはそれらを処理し最適化します。

public/ディレクトリは、Astroのビルドプロセスで処理する必要のないプロジェクトのファイルやアセットを格納するためのものです。このフォルダ内のファイルはそのままビルドフォルダにコピーされ、サイトがビルドされます。

この動作により、public/は画像やフォントなどの一般的なアセット、あるいはrobots.txtmanifest.webmanifestなどの特殊なファイルを置くのに最適な場所となります。

CSSやJavaScriptをpublic/ディレクトリに置くことはできますが、これらのファイルは最終的なビルドではバンドルされず、最適化されないことに注意してください。

これは、JavaScriptのパッケージマネージャーが依存関係を管理するために使用するファイルです。また、Astroを実行するためによく使われるスクリプトを定義します(たとえばnpm startnpm run buildなど)。

package.jsonには、dependenciesdevDependenciesという2種類の依存関係を指定できます。多くの場合、同じように動作します。Astroはビルド時に全ての依存関係を必要とし、パッケージマネージャーはどちらともインストールを行います。まずはdependenciesにすべての依存関係を含め、特に必要な場合のみdevDependenciesを利用することをおすすめします。

あなたのプロジェクトに新しいpackage.jsonファイルを作成する方法については、手動セットアップの説明を参照してください。

このファイルはすべてのスターターテンプレートで生成され、Astroプロジェクトの設定オプションが含まれています。ここでは、使用するインテグレーション、ビルドオプション、サーバーオプションなどを指定できます。

設定の詳細については、Astroの設定ガイドを参照してください。

このファイルはすべてのスターターテンプレートで生成され、TypeScriptの設定オプションが含まれています。(npmパッケージのインポートなどの)いくつかの機能はtsconfig.jsonファイルがないと完全にはサポートされません。

設定の詳細については、TypeScriptガイドを参照してください。

貢献する

どんなことを?

GitHub Issueを作成

チームに素早く問題を報告できます。

コミュニティ