Jekyll Documentation Generator: Trace the Source to the Route

HTML for this example

Select the code and use your copy shortcut. Changes in this preview are temporary.

<!doctype html>
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Jekyll Documentation Generator: Trace the Source to the Route</title><style>*{box-sizing:border-box}body{margin:0;color:var(--ink,#233342);background:var(--bg,#eef2f3);font:17px/1.6 system-ui,sans-serif}main{max-width:980px;margin:auto;padding:clamp(16px,4vw,38px)}h1{font:700 clamp(30px,5vw,49px)/1.12 Georgia,serif;margin:10px 0 20px;max-width:800px}h2{font-size:24px;line-height:1.3;margin:0 0 15px}h3{font-size:19px;margin:12px 0}p{margin:0 0 16px}.eyebrow{font-weight:750;letter-spacing:.08em;text-transform:uppercase;font-size:16px}header{padding:10px 0 25px;border-bottom:3px solid var(--accent,#24586d);margin-bottom:24px}.lede{font-size:20px;max-width:760px}.panel{background:var(--paper,#fff);padding:clamp(18px,3vw,28px);border:1px solid var(--line,#c6d1d8);border-radius:12px;margin:20px 0}.grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:20px}.grid>*{min-width:0}.row{display:flex;gap:12px;flex-wrap:wrap;align-items:center;margin:16px 0}.stack>*{margin:12px 0}button{font:700 17px/1.4 system-ui,sans-serif;cursor:pointer;color:white;background:var(--accent,#24586d);border:2px solid var(--accent,#24586d);border-radius:7px;padding:11px 17px;max-width:100%;overflow-wrap:anywhere}button.secondary{background:transparent;color:var(--ink,#233342)}button[aria-pressed=true]{box-shadow:inset 0 0 0 3px #fff;outline:2px solid var(--ink,#233342)}button:disabled{opacity:.55;cursor:default}input,textarea,select{font:17px/1.5 system-ui,sans-serif;color:inherit;background:white;border:1px solid #778591;padding:10px 12px;border-radius:6px;max-width:100%;width:100%;min-width:0}input[type=checkbox]{width:22px;height:22px}textarea{min-height:110px;resize:vertical}label{display:block;font-weight:700;margin:12px 0 7px}button:focus-visible,input:focus-visible,textarea:focus-visible,summary:focus-visible,[tabindex]:focus-visible{outline:3px solid #aa3d70;outline-offset:4px}.result{padding:18px;border-left:5px solid var(--accent,#24586d);background:var(--soft,#e5eff2);white-space:pre-wrap;overflow-wrap:anywhere;margin:20px 0}.result:empty{display:none}.hint{font-size:16px;color:var(--muted,#435968)}table{border-collapse:collapse;width:100%;table-layout:fixed;margin:16px 0}th,td{text-align:left;vertical-align:top;overflow-wrap:anywhere;padding:12px 8px;border-bottom:1px solid var(--line,#c6d1d8)}caption{text-align:left;font-weight:750;margin:8px 0}details{padding:18px;border:1px dashed #7b8b96;margin:20px 0}summary{cursor:pointer;font-weight:750}pre{font:16px/1.6 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere;background:#162735;color:#f5f8fa;padding:18px;border-radius:8px}canvas,svg{display:block;max-width:100%;height:auto}footer{margin:28px 0;font-size:16px}.badge{font-weight:750;color:var(--accent,#24586d)}.metric{font:700 38px/1.3 Georgia,serif}.board{display:grid;gap:5px;max-width:440px;margin:20px auto}.board button{padding:7px;min-height:45px}.sr{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}@media(max-width:560px){.grid{grid-template-columns:1fr}main{padding:16px}th,td{padding:10px 5px}.row button{flex-grow:1}.metric{font-size:32px}}
:root{--bg:#f2eee5;--paper:#fffdf8;--accent:#8b503c;--soft:#f2e3d8;--ink:#463126}.sourcepacket{max-height:none}.route{font-family:ui-monospace,monospace}</style></head><body><main><header><p class="eyebrow">Collection source builder · Expected routes</p><h1>Jekyll Documentation Generator: Trace the Source to the Route</h1><p class="lede">A listed title is not proof that Jekyll wrote an individual page.</p><p class="hint">This local source-packet generator computes documented expectations. It does not run Jekyll, write files, build a site or verify deployed routes.</p></header><section class="panel"><h2>Configure the original guide collection</h2><div class="row"><button id="outputTrue" type="button">Output true</button><button id="outputFalse" type="button">Content only</button><button id="frontmatter" type="button">Toggle Verify front matter</button></div><p id="mode">Individual output enabled; both guides have front matter.</p><label for="baseurl">Local baseurl, empty or /subpath</label><input id="baseurl"><div class="row"><button id="build" type="button">Build source packet</button><button id="reset" type="button" class="secondary">Reset settings</button></div><p id="result" class="result" role="status"></p><pre id="routes" class="route"></pre></section><section class="panel"><h2>Copyable native source packet</h2><pre id="packet" class="sourcepacket">Build a source packet to inspect the complete original files.</pre><p>Actual Jekyll version, compilation, generated artifact inspection and public deployment: Pending.</p></section><footer>Copy the files into Jekyll and compare a fresh build with the expected routes.</footer></main><script>
(()=>{'use strict';const $=id=>document.getElementById(id);
let output=true,frontmatter=true;function clear(){$('result').textContent='Settings changed. Build a fresh source packet.';$('routes').textContent='';$('packet').textContent='';$('mode').textContent=(output?'Individual output enabled':'Content-only listing')+'; Verify front matter '+(frontmatter?'present.':'absent: processing review required.');}$('outputTrue').addEventListener('click',()=>{output=true;clear();});$('outputFalse').addEventListener('click',()=>{output=false;clear();});$('frontmatter').addEventListener('click',()=>{frontmatter=!frontmatter;clear();});$('baseurl').addEventListener('input',clear);$('build').addEventListener('click',()=>{const base=$('baseurl').value.trim().replace(/\/$/,'');if(base&&!/^\/(?:[A-Za-z0-9_-]+\/?)+$/.test(base)){$('result').textContent='Use an empty baseurl or a local /subpath, without a scheme, query or fragment.';return;}const fm=title=>'---\ntitle: '+title+'\norder: '+(title==='Overview'?1:2)+'\n---\n';const config='collections:\n  guides:\n    output: '+output+'\n    permalink: /guides/:name/\nbaseurl: "'+base+'"\ndefaults:\n  - scope:\n      path: ""\n      type: guides\n    values:\n      layout: guide';const index='---\nlayout: default\ntitle: Guides\n---\n{% assign collection = site.collections | where: "label", "guides" | first %}\n{% assign guides = site.guides | sort: "order" %}\n{% for doc in guides %}\n{% if collection.output %}<a href="{{ doc.url | relative_url }}">{{ doc.title }}</a>{% else %}<p>{{ doc.title }}</p>{% endif %}\n{% endfor %}';$('packet').textContent='_config.yml\n'+config+'\n\n_guides/overview.md\n'+fm('Overview')+'Read the supplied workflow first.\n\n_guides/verify.md\n'+(frontmatter?fm('Verify'):'')+'Compare output routes with source IDs.\n\n_layouts/default.html\n<!doctype html><html lang="en"><meta charset="utf-8"><title>{{ page.title }}</title><body><main>{{ content }}</main></body></html>\n\n_layouts/guide.html\n---\nlayout: default\n---\n<h1>{{ page.title }}</h1>\n{{ content }}\n\nindex.html\n'+index;const processedTitles=frontmatter?'Overview, Verify':'Overview';
const verifyGap='Verify: front matter absent; unprocessed/static source needs review; not listed as a processed guide.';
$('routes').textContent=!output?'CONTENT ONLY · '+processedTitles+'\nIndividual-route links suppressed; no processed guide pages expected.'+(frontmatter?'':'\n'+verifyGap):'EXPECTED, not built:\noverview → '+base+'/guides/overview/ → guides/overview/index.html\n'+(frontmatter?'verify → '+base+'/guides/verify/ → guides/verify/index.html':verifyGap);
$('result').textContent='Source packet prepared. Actual Jekyll build and route verification: pending.';});$('reset').addEventListener('click',()=>{output=true;frontmatter=true;$('baseurl').value='';clear();});
})();
</script></body></html>