askdkc.github.io

Astroで生成する、Markdown中心の個人ブログです。公開サイトは https://askdkc.github.io です。

開発

Node.js 22.12.0以上を用意してから依存関係をインストールします。

npm ci
npm run dev

ブラウザでhttp://localhost:4321を開くと開発サーバーを確認できます。

npm test
npm run check
npm run build
npm run verify:build
npm run preview

npm run content:convertはOrg-modeのソースをAstro用Markdownへ変換します。 変換元はcontent/org/、生成先はsrc/content/posts/org/で、生成先はGit管理しません。

記事を書く

通常の記事はsrc/content/posts/にMarkdownファイルとして追加します。 frontmatterでは少なくともtitle、pubDate、slugを指定します。

---
title: "記事のタイトル"
description: "記事の概要"
pubDate: 2026-08-30
tags: [notes]
draft: false
slug: "notes/example"
---
本文。

draft: trueの記事はローカル開発中は表示されますが、本番サイトとRSSには含まれません。

Org-modeを使う場合はcontent/org/**/*.orgに置き、#+TITLEと#+DATEを必ず指定します。 対応するメタデータは#+TITLE、#+DATE、#+DESCRIPTION、#+AUTHOR、 #+FILETAGS、#+KEYWORDS、#+SLUG、#+DRAFTです。見出し、リンク、リスト、 強調、画像リンク、#+BEGIN_SRCコードブロックを限定的に変換します。

公開

mainへのpushで.github/workflows/deploy.ymlがテスト、型検査、静的ビルド、 生成物検査を実行し、成功時にGitHub Pagesへデプロイします。Pull Requestでは デプロイせず、検証だけを実行します。

リポジトリのGitHub Pages設定で、SourceをGitHub Actionsに変更してください。

サポート