SQLiteのファイル・画像フォルダー・配信URLの対応表

ローカルのEmDashで、記事の保存先、写真の保存先、ブラウザーから写真を開くURLを調べます。

目次

「週末ノート」では、記事と写真の登録情報を data.db に、写真のファイルを uploads フォルダーに保存します。写真をブラウザーで開くときは、EmDashが用意する配信用のURLを使います。

astro.config.mjs のどこを見る?

作業フォルダーにある astro.config.mjs を開き、emdash({...}) の中にある database と storage を探してください。次はローカルの教材で使っている値です。

設定する場所教材の値意味
sqlite() の urlfile:./data.db起動したフォルダーにあるSQLiteファイル。記事や写真の登録情報が入る
local() の directory./uploadsアップロードした写真のファイルを置くフォルダー
local() の baseUrl/_emdash/api/media/fileブラウザーからファイルを開くURLの共通部分

たとえば、記事のタイトルが出るのに写真を開けないときは、記事を読む処理までは動いています。次に、写真のファイルがあるか、そのファイルを配信用のURLで開けるかを順番に確かめます。

保存先と配信URLを確かめる

写真付き一覧の実習で教材を用意し、「週末の記録 01」の写真に教材の sample.png を登録して公開してください。

weekend-note の中で、package.json と同じ場所に check-local-files.mjs を作ります。この例はファイルの有無を調べ、見つかったPNG画像1枚の配信パスを表示します。

import { existsSync, readdirSync, statSync } from 'node:fs';

const dbFile = './data.db';
const uploads = './uploads';
const hasDb = existsSync(dbFile) && statSync(dbFile).isFile();
const hasUploads = existsSync(uploads) && statSync(uploads).isDirectory();
const photo = hasUploads && readdirSync(uploads, { withFileTypes: true })
  .find(file => file.isFile() && file.name.endsWith('.png'));

console.log('記事のDB:', hasDb ? 'あり' : 'なし');
console.log('画像フォルダー:', hasUploads ? 'あり' : 'なし');
console.log('PNGの配信パス:', photo
  ? '/_emdash/api/media/file/' + encodeURIComponent(photo.name)
  : 'PNGなし');

Macならターミナル、WindowsならPowerShellで、同じ weekend-note フォルダーから実行します。

node check-local-files.mjs

「記事のDB」「画像フォルダー」がともに「あり」なら、指定した場所にファイルとフォルダーが見つかっています。画像未登録なら「PNGなし」と出ます。JPEGを使った場合も、この例の検索対象はPNGだけです。

サイトが起動している状態で、表示された配信パスをローカルサイトのアドレスに続けてブラウザーで開いてください。写真付き一覧の実習なら、http://127.0.0.1:4350 の後ろに貼ります。画像が表示されれば、手元のファイルをEmDash経由で読めています。

写真が表示されないとき

見えた結果次に確認すること
記事のDBが「なし」コマンドを実行したフォルダーと、実際の sqlite() の設定を確認する
DBは「あり」、画像フォルダーは「なし」directory の指定と、画像を登録したサイトが同じかを確認する
PNGはあるが配信URLを開けないサイトの起動状態、ポート番号、baseUrl を確認する
配信URLで開けるが記事には出ない記事の写真欄にその画像を選んだか、変更を公開したかを確認する

この表はSQLiteとローカルストレージを組み合わせた場合の例です。CloudflareのD1・R2を使うサイトの保存先はCloudflare公開に必要な構成で確認できます。

公式の参照元

関連ガイド

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

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