Skip to content

Add HTML pages guide page (write pages with HTML and ERB) - #8

Open
fcatuhe wants to merge 2 commits into
mainfrom
document-html-erb-pages
Open

Add HTML pages guide page (write pages with HTML and ERB)#8
fcatuhe wants to merge 2 commits into
mainfrom
document-html-erb-pages

Conversation

@fcatuhe

@fcatuhe fcatuhe commented Jul 19, 2026

Copy link
Copy Markdown
Owner

Summary

Documents Decant's HTML/ERB content variant as a new guide page in the flow (not a section), backed by a real working implementation in this repo — matching the guide's pattern where every page documents an applied commit.

Flow placement

Appended to the going-further extras, after Generate sitemaps and robots.txt, in its own Content group:

next (9) → classless-style (10) → rouge (11) → web-page-metadata (12) → sitemap-and-robots (13) → html-pages (14) → next

Zero renumbering — only sitemap-and-robots' forward arrow is rewired, and next.md gains a Content group after Styling and SEO.

Commits

  1. HTML pages — the implementation: HtmlPage Decant model over content/html_pages (ext: "html.erb"), render_erb helper (reused by render_content_from), controller, view, /html/*slug route, and a live demo page at /html/demo
  2. Guide pagecontent/pages/html-pages.md (position 14) with permalinks pinned to commit 1's SHA, nav footer wiring, and the next.md Content group

Verification

  • /html-pages, /html/demo, rewired nav on /sitemap-and-robots and /next all render (Ruby 4.0.6 / Rails 8.1.3)
  • Full static build with the GitHub Pages base: both new pages crawled by Parklife and present in sitemap.xml (16 URLs)
  • <%% ERB escaping verified in code samples; RuboCop clean

fcatuhe added 2 commits July 19, 2026 13:48
Add a second Decant collection for pages written in plain HTML with
ERB, skipping kramdown: HtmlPage model over content/html_pages, a
render_erb helper (also reused by render_content_from), controller,
view, route and a demo page.
New extras page (position 14) documenting the HTML pages commit,
appended to the going-further chain after sitemap-and-robots and
listed under a new Content group in What next?
@fcatuhe
fcatuhe force-pushed the document-html-erb-pages branch from 985936d to bc72c61 Compare July 19, 2026 11:49
@fcatuhe fcatuhe changed the title Document full HTML pages variant in ERB guide Add HTML pages guide page (write pages with HTML and ERB) Jul 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant