Skip to content
seekingvegaPublic

Repository files navigation

Birch Street Journal (BSJ)

A Quarto blog documenting discretionary trades — a record of winners vs. losers, risk management, and trade ideas. Posts are written as Quarto markdown (.qmd) or Jupyter notebooks (.ipynb), rendered to a static site in docs/, and served via GitHub Pages.

Setup

Python dependencies are managed with uv:

uv sync

You'll also need the Quarto CLI installed.

Developing

uv run quarto preview                            # live-reload preview while editing
uv run quarto render                             # build the full site into docs/
uv run quarto render posts/qmd/gold-202602.qmd   # render a single post

Posts execute Python (yfinance, plotly), so renders run inside the uv environment. Executed output is cached via Quarto's freeze: true (in .quarto/_freeze/) and only re-runs when a post's source changes.

Publishing

There is no CI workflow. quarto render writes the built site into docs/, and GitHub Pages serves that committed directory. To publish: render, then commit the changes under docs/.

Writing a post

  1. Copy posts/qmd/trades_template.qmd into posts/qmd/ (or add an .ipynb to posts/notebooks/). Filenames follow <ticker>-<YYYYMM> / <ticker>_to-<YYYYMM> (_to = the .TO Toronto exchange).
  2. Fill in the front matter — title, abstract, image (listing thumbnail), date, categories (drive the home-page filters), and draft: true|false.
  3. Posts in posts/qmd and posts/notebooks are auto-indexed on the home page (index.qmd), sorted by date. posts/drafts/ is excluded from the site.

Images are hosted externally on ImageBB (referenced as https://i.ibb.co/... URLs), not committed to the repo.

Configuration

  • _quarto.yml — site config (output dir, navbar, theme, freeze).
  • posts/_metadata.yml — shared front matter applied to all posts.
  • mw-custom.scss — the active theme (hashi.scss is an alternative).
  • .env — IMGBB_API_KEY and OPENROUTER_API_KEY (gitignored, not committed).

See CLAUDE.md for a fuller architecture overview.

Releases

Packages

Contributors

Languages