Daisuke ff2571d948 docs: update blog post naming convention to date-based format

- Add filename convention documentation to README.md
- Update content.config.ts to match YYYY-MM-DD-*.md pattern
- Remove placeholder post-*.md files

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

2026-02-16 21:49:07 +09:00

2.5 KiB

Raw Blame History

Naputo - n-daisuke897's blog

Welcome to my blog repository!

Commands

All commands are run from the root of the project, from a terminal:

Command	Action
`npm install`	Installs dependencies
`npm run dev`	Starts local dev server at `localhost:4321`
`npm run build`	Build your production site to `./dist/`
`npm run preview`	Preview your build locally, before deploying
`npm run astro ...`	Run CLI commands like `astro add`, `astro check`
`npm run astro -- --help`	Get help using the Astro CLI

Blog post filename convention

Manage files in src/blog/ with this format:

YYYY-MM-DD-your-post-slug.md

Use lowercase letters, numbers, and hyphens in the slug.
Keep words separated by a single hyphen.
If two posts share the same date and slug, append -2, -3, etc.

Dependency update guidance

For security/deprecated remediation, allow breaking changes via npm audit fix --force, then verify:

npm audit
npm run build

Nix devshell (recommended)

If you use Nix, you can enter a dev shell that provides the required CLI tools for this repo:

nix develop

This is intended to provide tools like Forgejo CLI (fj) and Node.js so "when you enter the repo, everything is available":

nix develop --command fj version
nix develop --command node --version

Podman (container) development

This repo can be developed inside a Podman container to keep your host clean and improve reproducibility.

Using podman compose

export SSH_PUBKEY_PATH="$HOME/.ssh/id_ed25519.pub"
podman compose up --build

On WSL2/rootless Podman, if you hit netavark/nftables errors, this repo defaults to slirp4netns via network_mode in compose.yml.

If you want SSH access (for Emacs TRAMP /ssh:), SSH_PUBKEY_PATH must point to your public key and port 2222 will be exposed for SSH.

Then open: http://localhost:4321

Run other commands in the running container:

podman compose exec app npm run build
podman compose exec app npm run preview -- --host 0.0.0.0 --port 4321

Troubleshooting (WSL2)

If hot reload is unstable/slow, enable polling:

CHOKIDAR_USEPOLLING=1 podman compose up --build

Tip: placing the repo under the WSL filesystem (e.g. ~/project/...) is often faster than under /mnt/c.

2.5 KiB Raw Blame History