Manshu Huang · Quant Research Blogs

Public address: https://research.huangit.dev

Source repository: https://huangit.dev/research/blog

A static research blog with two articles. The CME article is an independent cross-asset analysis grounded in exchange documentation, covering economic mechanisms, contract design, and proposed research tests. The implied-volatility review starts from attributed source observations and checks them against exchange documentation and academic work. Neither reports new experiments.

Write and preview

Requires Node.js 22 or newer, npm, and Python 3 for the optional local preview.

npm ci
npm run build
npm run preview

Open http://127.0.0.1:4173/.

Each article is a Markdown file in content/. The ordered list in content/articles.json controls the homepage. An entry contains slug, title, category, description, repoName, repo, and draft. Set draft to true to exclude an article from the generated site. Optionally add an accurate ISO date as date; omitted dates stay hidden. Do not edit generated HTML directly.

To add an article:

  1. Create content/your-article-slug.md.
  2. Add its metadata to content/articles.json.
  3. Run npm run build.
  4. Preview the article and its code links.
  5. Deploy only dist/ to the web server.

Markdown is trusted author content and permits HTML. Do not use this build script for untrusted public submissions.

Existing hosting

The user's existing Vultr server hosts Gitea and Caddy under /opt/gitea.

  • Root site: huangit.dev → existing Gitea service.
  • Blog: research.huangit.dev → static files served by Caddy.
  • DNS: Porkbun A record research64.177.112.18, TTL 600. Created and authoritatively verified on September 11, 2026.

Do not replace the existing Compose or Caddy configuration with the example below. Inspect the live configuration and back it up, then add only the blog-specific volume and site block.

Host directory: /opt/gitea/research-site.

Additional read-only mount for the existing Caddy service:

volumes:
  - ./research-site:/srv/research:ro

Additional Caddy site block:

research.huangit.dev {
    root * /srv/research
    encode zstd gzip
    file_server
    handle_errors {
        rewrite * /404.html
        file_server
    }
}

Caddy can provision HTTPS once the DNS points to the server, the domain's site block is active, and inbound ports 80/443 are available. Adding a container volume requires recreating the Caddy container; an ordinary restart does not add the mount. Validate the candidate Compose and Caddy configuration before applying it.

After activation, verify the root Gitea site, the blog homepage, both article routes, the CSS/favicon, HTTPS certificate validation, and the 404 response. A subsequent article update needs only a new static build and file deployment, not a Gitea restart.

Status

Published on September 11, 2026. DNS and HTTPS are active. The homepage, both article routes, stylesheet, favicon, and custom 404 have been verified against the local build. The existing Gitea homepage also returns HTTP 200.

The original server configuration was backed up before deployment under /opt/gitea/research-backups/20260911T222622Z. Only the Caddy service was recreated to add the read-only blog mount.

Gitea stores the source; pushing a commit does not automatically deploy it. Build and upload dist/ to update the website.

The initial three project-summary articles were withdrawn on September 11, 2026 at the author's request and replaced by the two topic reviews. The CME article was subsequently rewritten as an independent economic study of seven principal options asset classes and weather. It contains no blogger commentary or source-note index. The IV review cites 11 selected source notes. Coverage limitations are stated in each article.

S
Description
Source and published static pages for Manshu Huang · Quant Research Blogs.
Readme 424 KiB
Languages
JavaScript 100%