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.
Python dependencies are managed with uv:
uv syncYou'll also need the Quarto CLI installed.
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 postPosts 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.
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/.
- Copy
posts/qmd/trades_template.qmdintoposts/qmd/(or add an.ipynbtoposts/notebooks/). Filenames follow<ticker>-<YYYYMM>/<ticker>_to-<YYYYMM>(_to= the.TOToronto exchange). - Fill in the front matter —
title,abstract,image(listing thumbnail),date,categories(drive the home-page filters), anddraft: true|false. - Posts in
posts/qmdandposts/notebooksare 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.
_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.scssis an alternative)..env—IMGBB_API_KEYandOPENROUTER_API_KEY(gitignored, not committed).
See CLAUDE.md for a fuller architecture overview.