記事・画像・見た目は、どこに保存される?

サイトのファイル、記事を保存するデータベース、画像の保存場所。この3つの違いを整理します。

目次

記事のタイトルや本文はデータベースに、登録した画像は画像用の保存場所に、ページの見た目や動きはサイトのファイルに保存されます。 記事を書くたびに、ページ用のファイルを自分で作る必要はありません。

このページでは、直したいものに合わせて、探す場所を選べるようになりましょう。最初の記事を作ったあと、その記事がどこにあるか振り返るとつかみやすくなります。

サイトの材料を3つに分けて考える

架空のブログ「週末ノート」に、記事と写真を載せる場面を考えます。

材料具体例主な保存場所
ページの作りや見た目記事を並べる処理、文字の色、共通のヘッダープロジェクト内のファイル
管理するデータ記事のタイトルと本文、設定、利用者の情報データベース
管理画面から登録した画像などの実体コーヒーカップの写真ファイルメディア用のストレージ

データベースは、情報を整理して保存し、あとから取り出せる仕組みです。たくさんの記事から、必要な1本を探したり、新しい順に取り出したりするときにも使います。

ストレージは、データを保存しておく場所という意味です。ここでいう「メディア用のストレージ」は、登録した画像やPDFなどのファイルを置く場所を指します。

この3つは保存する内容の違いを表しています。同じパソコンの中に置く構成もあります。EmDash公式の構成説明(別タブで開く)でも、データベースとメディアの保存先、それらを使うページの役割を分けています。

タイトルを変えても、ページのファイルは増えない

「はじめてのコーヒー道具」という記事を書いたとします。

その記事のタイトルや本文は、管理画面からデータベースへ保存されます。記事を書くたびに、自分で新しいページ用ファイルを1つ作る必要はありません。

ページ側には、記事の情報を受け取って表示する作りを用意しておきます。複数の記事に同じ作りを使い、表示する中身を切り替えられます。

たとえば、原稿用紙を毎回デザインし直すのではなく、決まった用紙に別々の原稿を書く感じです。ただし、これは役割をつかむためのたとえです。実際の記事の情報は、データベースに保存されます。

画像は「ファイル」と「その画像の情報」がある

写真を記事に使うときは、写真のファイルそのものと、「どの画像を使うか」という情報を扱います。

写真の実体はメディア用の保存場所に置かれ、記事側はその画像を参照します。たとえば、記事に「この写真を使う」と記録しておき、表示するときに写真を読み込む関係です。

このため、記事の文字だけを保存しても、写真のファイルまで全部保存できたとは限りません。公式のストレージガイド(別タブで開く)も、データベースと画像ファイルの保存を分けて扱っています。

最初によく見る、5つのファイルやフォルダー

ここからは、サイトを作る側のファイルを少しだけ見ます。表は、AstroやEmDashの標準的な構成を読むための目印です。使うひな型によって、ファイルの有無や中身は変わります。

パスとは、ファイルやフォルダーの場所を表す書き方です。たとえば src/pages/ は、「src フォルダーの中の pages フォルダー」を意味します。

名前何のためにある?最初はどう読む?
package.json使用する部品や、開発用のコマンドなどを記録するこのサイトの道具の一覧
astro.config.mjsAstroやEmDashの動かし方を設定するサイト全体の設定ファイル
src/pages/読者向けのページやURLに対応する処理を置くページを作る場所
src/components/複数のページで使う小さな部品などを置く共通部品の置き場所
src/styles/色や文字サイズなどの見た目を指定するファイルを置くことがあるデザインの指定を探す目印

components や styles の整理方法は、作る人が決められます。「必ずこの名前のフォルダーにある」とは限りません。Astro公式のファイル構成(別タブで開く)では、必須の場所と、よく使われる整理方法を説明しています。

EmDashには、記事をAstroへ渡す接続のための src/live.config.ts などもあります。今は「記事の原稿そのものが入っているファイルではない」とわかれば十分です。

保存場所の名前は、動かす環境で変わる

練習用サイトでは、自分のパソコン上のファイルにデータを保存する SQLite(エスキューライト) などを使えます。

Cloudflareというサービス上で動かす場合は、データベースに D1(ディーワン)、画像の保存先に R2(アールツー) を使う構成があります。

今はサービス名をすべて覚える必要はありません。「記事などのデータを保存する仕組み」と「画像ファイルを置く場所」は、環境に合わせて選ぶ、と理解しておきましょう。選択肢は公式のデータベースガイド(別タブで開く)とストレージガイド(別タブで開く)で確認できます。

サイトを丸ごと残したいときは、何が必要?

サイトのファイル、データベース、画像などのファイルを保存します。 暗号化した設定を読み出すための鍵など、秘密の設定が必要になる場合もあります。あとで元に戻せるように、これらを別の場所にも保存しておくことを バックアップ と呼びます。

その設定を渡す仕組みが「環境変数」です。ローカルでは .env というファイルに書く場合があります。秘密の設定が入っているファイルは、一般に公開しないでください。Astroの環境変数の説明(別タブで開く)

なお、EmDashが出力するJSON形式のバックアップは、公式資料では内容確認などに使うものとされ、EmDash自身がそこから復元する機能はありません。復元に備えるときは、公式のバックアップ手順(別タブで開く)に沿って、データベースと画像などを保存します。このページは保存対象の説明で、実際のバックアップ手順ではありません。

直したいものから、探す場所を選ぼう

「記事のタイトルが違う」なら、まず管理画面を開きます。「タイトルの文字を大きくしたい」なら、ページの見た目を指定するファイルを調べます。同じタイトルの話でも、作業場所が変わります。

次は、管理画面の中へ進みます。「コレクション」「フィールド」「エントリー」の違いを、記事1本の例で見ていきましょう。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。