russellballestrini/russell.ballestrini.net
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

Switch blog.json from embedded content to content_url links

Browse source 
Changes blog.json generation to link to hosted markdown files instead of
embedding full content. Each post now includes a content_url field pointing
to {site_url}/{slug}/index.md. This significantly reduces blog.json file
size while maintaining full content access via standard HTTP requests.

Updated README.rst to document the new linking behavior & how blog.json works.
This commit is contained in:
russell@unturf.com 2026-01-20 03:21:19 -05:00
parent 2bda81d294
commit d8cf83e051
2 changed files with 13 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

8
README.rst
View file

@ -67,7 +67,7 @@ The blog automatically generates multiple formats optimized for AI agents & LLM
**Generated files:**
- ``/blog.json`` - Entire blog in single JSON file (jsonblog.dev format)
- ``/blog.json`` - Blog index with links to markdown files (jsonblog.dev format)
- ``/feeds/all.json`` - JSON Feed v1.1 alternative to Atom/RSS
- ``/llms.txt`` - AI agent onboarding documentation with API info
- ``/*/index.md`` - GitHub-flavored Markdown for every post
@ -77,11 +77,15 @@ The blog automatically generates multiple formats optimized for AI agents & LLM
These formats enable AI agents, LLMs, & automated systems to:
- Ingest entire blog content in one request (blog.json)
- Discover all posts & fetch markdown via ``content_url`` links (blog.json)
- Subscribe to updates via JSON instead of XML (feeds/all.json)
- Discover blog structure & available formats (llms.txt)
- Read posts without HTML parsing (index.txt, index.md)
**How blog.json works:**
The ``blog.json`` file uses the jsonblog.dev format & links to hosted markdown files instead of embedding content. Each post includes a ``content_url`` field pointing to ``https://russell.ballestrini.net/{slug}/index.md``. This keeps the JSON file lightweight while providing full access to all post content through standard HTTP requests.
All formats are automatically generated during CI/CD builds & kept in sync with the HTML content.
**Requirements:**