Skip to content

Taqiam/BoneLog

Repository files navigation

BoneLOG

Live site: https://taqiam.github.io/BoneLog/

Documentation: BoneLog docs (start here)


What's this?

A small file-based blog on Blazor WebAssembly, write Markdown, push to Git, deploy static files. No CMS, no database.

Quick start

  1. Fork this repo and enable GitHub Actions.
  2. Add posts under src/BoneLog.Blazor/wwwroot/data/posts.
  3. Edit config.json, set BaseDir (e.g. "/BoneLog/") and BaseDataPath ("data/"). Deploy workflows patch <base href> in index.html and 404.html from BaseDir.
  4. Settings → Pages → branch gh-pages, root /.
  5. Deploy: Actions → Deploy to GitHub Pages, or push tag v1.0.0.

Push post changes → Update index on main refreshes index.json on main, then Update data on gh-pages syncs full data/ to the live site (no full deploy). Run Deploy to GitHub Pages for WASM, CSS, images under wwwroot/images/, or config.json changes.

Documentation posts

Topic Link
Index Documentation hub
Quick start GitHub Pages
Publishing Deploy & hosting
Custom hosting Release zip & any host
Writing Posts & Markdown
Paths Paths & addresses
Search Filters
Config config.json
Workflows GitHub Actions
Developers Architecture

Customize

Goal Location
Posts wwwroot/data/posts/
About wwwroot/data/AboutMe.md
Settings & nav wwwroot/config.json
Images wwwroot/images/
Styles wwwroot/css/app.css

Contribute

PRs welcome, keep small and clear.