bloggy 0.1.43__py3-none-any.whl → 0.2.5__py3-none-any.whl

bloggy/core.py

@@ -1,4 +1,6 @@
 import re, frontmatter, mistletoe as mst, pathlib, os, tomllib
+from itertools import chain
+from urllib.parse import quote_plus
 from functools import partial
 from functools import lru_cache
 from pathlib import Path
@@ -22,9 +24,35 @@ slug_to_title = lambda s: ' '.join(
     for word in s.replace('-', ' ').replace('_', ' ').split()
 )
 
+def _strip_inline_markdown(text):
+    cleaned = text or ""
+    cleaned = re.sub(r'\[([^\]]+)\]\([^)]+\)', r'\1', cleaned)
+    cleaned = re.sub(r'\[([^\]]+)\]\[[^\]]*\]', r'\1', cleaned)
+    cleaned = re.sub(r'`([^`]+)`', r'\1', cleaned)
+    cleaned = re.sub(r'\*\*([^*]+)\*\*', r'\1', cleaned)
+    cleaned = re.sub(r'__([^_]+)__', r'\1', cleaned)
+    cleaned = re.sub(r'\*([^*]+)\*', r'\1', cleaned)
+    cleaned = re.sub(r'_([^_]+)_', r'\1', cleaned)
+    cleaned = re.sub(r'~~([^~]+)~~', r'\1', cleaned)
+    return cleaned
+
+def _plain_text_from_html(text):
+    import html
+    cleaned = re.sub(r'<[^>]+>', '', text or "")
+    return html.unescape(cleaned)
+
+def _unique_anchor(base, counts):
+    if not base:
+        base = "section"
+    current = counts.get(base, 0) + 1
+    counts[base] = current
+    return base if current == 1 else f"{base}-{current}"
+
 def text_to_anchor(text):
     """Convert text to anchor slug"""
-    return re.sub(r'[^\w\s-]', '', text.lower()).replace(' ', '-')
+    cleaned = _strip_inline_markdown(text)
+    cleaned = _plain_text_from_html(cleaned)
+    return re.sub(r'[^\w\s-]', '', cleaned.lower()).replace(' ', '-')
 
 # Cache for parsed frontmatter to avoid re-reading files
 _frontmatter_cache = {}
@@ -77,6 +105,7 @@ def _normalize_bloggy_config(parsed):
         "sort": "name_asc",
         "folders_first": True,
         "folders_always_first": False,
+        "layout_max_width": None,
     }
     if not isinstance(parsed, dict):
         return config
@@ -108,6 +137,14 @@ def _normalize_bloggy_config(parsed):
         if lowered in ("true", "false"):
             config["folders_always_first"] = lowered == "true"
 
+    for key in ("layout_max_width",):
+        value = parsed.get(key)
+        if isinstance(value, (int, float)):
+            value = str(value)
+        if isinstance(value, str):
+            value = value.strip()
+            config[key] = value if value else None
+
     return config
 
 def get_bloggy_config(folder):
@@ -129,6 +166,42 @@ def get_bloggy_config(folder):
     )
     return config
 
+def _coerce_config_str(value):
+    if value is None:
+        return None
+    if isinstance(value, (int, float)):
+        return str(value)
+    if isinstance(value, str):
+        cleaned = value.strip()
+        return cleaned if cleaned else None
+    return str(value)
+
+def _width_class_and_style(value, kind):
+    if not value:
+        return "", ""
+    val = value.strip()
+    lowered = val.lower()
+    if lowered in ("default", "auto", "none"):
+        return "", ""
+    if kind == "max":
+        if val.startswith("max-w-"):
+            return val, ""
+        if re.match(r'^\d+(\.\d+)?$', val):
+            val = f"{val}px"
+        return "", f"--layout-max-width: {val};"
+    return "", ""
+
+def _style_attr(style_value):
+    if not style_value:
+        return {}
+    return {"style": style_value}
+
+def _resolve_layout_config(current_path):
+    config = get_config()
+    return {
+        "layout_max_width": _coerce_config_str(config.get("layout_max_width", "BLOGGY_LAYOUT_MAX_WIDTH", "75vw")),
+    }
+
 def order_bloggy_entries(entries, config):
     if not entries:
         return []
@@ -312,23 +385,68 @@ def preprocess_tabs(content):
     
     def replace_tabs_block(match):
         tabs_content = match.group(1)
-        # Pattern to match ::tab{title="..."}
-        tab_pattern = re.compile(r'^::tab\{title="([^"]+)"\}\s*\n(.*?)(?=^::tab\{|\Z)', re.MULTILINE | re.DOTALL)
-        
+        # Pattern to match ::tab{title="..." ...}
+        tab_pattern = re.compile(r'^::tab\{([^\}]+)\}\s*\n(.*?)(?=^::tab\{|\Z)', re.MULTILINE | re.DOTALL)
+
+        def parse_attrs(raw_attrs):
+            attrs = {}
+            for key, value in re.findall(r'([a-zA-Z0-9_-]+)\s*=\s*"([^"]*)"', raw_attrs):
+                attrs[key] = value
+            return attrs
+
         tabs = []
         for tab_match in tab_pattern.finditer(tabs_content):
-            title = tab_match.group(1)
+            raw_attrs = tab_match.group(1)
             tab_content = tab_match.group(2).strip()
-            tabs.append((title, tab_content))
+            attrs = parse_attrs(raw_attrs)
+            title = attrs.get('title')
+            if not title:
+                continue
+            tabs.append({'title': title, 'content': tab_content, 'attrs': attrs})
         
         if not tabs:
             return match.group(0)  # Return original if no tabs found
+
+        title_map = {tab['title']: tab for tab in tabs}
+        index_map = {str(i): tab for i, tab in enumerate(tabs)}
+
+        def fence_wrap(content):
+            backtick_runs = re.findall(r'`+', content)
+            max_run = max((len(run) for run in backtick_runs), default=0)
+            fence_len = max(4, max_run + 1)
+            fence = '`' * fence_len
+            return f'{fence}\n{content}\n{fence}'
+
+        def resolve_tab_content(tab, stack=None):
+            stack = stack or set()
+            copy_from = tab.get('attrs', {}).get('copy-from')
+            if not copy_from:
+                return tab['content']
+            if copy_from in stack:
+                return tab['content']
+            source_tab = None
+            if copy_from.startswith('index:'):
+                index_key = copy_from.split(':', 1)[1].strip()
+                source_tab = index_map.get(index_key)
+            elif copy_from.isdigit():
+                source_tab = index_map.get(copy_from)
+            else:
+                source_tab = title_map.get(copy_from)
+            if not source_tab:
+                return tab['content']
+            stack.add(copy_from)
+            resolved = resolve_tab_content(source_tab, stack)
+            stack.remove(copy_from)
+            return fence_wrap(resolved)
+
+        for tab in tabs:
+            tab['content'] = resolve_tab_content(tab)
         
         # Generate unique ID for this tab group
         tab_id = hashlib.md5(match.group(0).encode()).hexdigest()[:8]
         
         # Store tab data for later processing
-        tab_data_store[tab_id] = tabs
+        tab_data_store[tab_id] = [(tab['title'], tab['content']) for tab in tabs]
         
         # Return a placeholder that won't be processed by markdown
         placeholder = f'<div class="tab-placeholder" data-tab-id="{tab_id}"></div>'
@@ -342,6 +460,8 @@ class ContentRenderer(FrankenRenderer):
         super().__init__(*extras, img_dir=img_dir, **kwargs)
         self.footnotes, self.fn_counter = footnotes or {}, 0
         self.current_path = current_path  # Current post path for resolving relative links and images
+        self.heading_counts = {}
+        self.mermaid_counter = 0
     
     def render_list_item(self, token):
         """Render list items with task list checkbox support"""
@@ -398,6 +518,12 @@ class ContentRenderer(FrankenRenderer):
         self.fn_counter += 1
         n, target = self.fn_counter, token.target
         content = self.footnotes.get(target, f"[Missing footnote: {target}]")
+        if "\n" in content:
+            content = content.replace("\r\n", "\n")
+            placeholder = "__BLOGGY_PARA_BREAK__"
+            content = content.replace("\n\n", f"\n{placeholder}\n")
+            content = content.replace("\n", "<br>\n")
+            content = content.replace(f"\n{placeholder}\n", "\n\n")
         rendered = mst.markdown(content, partial(ContentRenderer, img_dir=self.img_dir, current_path=self.current_path)).strip()
         if rendered.startswith('<p>') and rendered.endswith('</p>'): rendered = rendered[3:-4]
         style = "text-sm leading-relaxed border-l-2 border-amber-400 dark:border-blue-400 pl-3 text-neutral-500 dark:text-neutral-400 transition-all duration-500 w-full my-2 xl:my-0"
@@ -409,10 +535,12 @@ class ContentRenderer(FrankenRenderer):
     
     def render_heading(self, token):
         """Render headings with anchor IDs for TOC linking"""
+        import html
         level = token.level
         inner = self.render_inner(token)
-        anchor = text_to_anchor(inner)
-        return f'<h{level} id="{anchor}">{inner}</h{level}>'
+        plain = _plain_text_from_html(inner)
+        anchor = _unique_anchor(text_to_anchor(plain), self.heading_counts)
+        return f'<h{level} id="{anchor}">{html.escape(plain)}</h{level}>'
     
     def render_superscript(self, token):
         """Render superscript text"""
@@ -519,7 +647,8 @@ class ContentRenderer(FrankenRenderer):
                 # Use code without frontmatter for rendering
                 code = code_without_frontmatter
             
-            diagram_id = f"mermaid-{hash(code) & 0xFFFFFF}"
+            self.mermaid_counter += 1
+            diagram_id = f"mermaid-{abs(hash(code)) & 0xFFFFFF}-{self.mermaid_counter}"
             
             # Determine if we need to break out of normal content flow
             # This is required for viewport-based widths to properly center
@@ -550,17 +679,46 @@ class ContentRenderer(FrankenRenderer):
         # For other languages: escape HTML/XML for display, but NOT for markdown 
         # (markdown code blocks should show raw source)
         import html
+        raw_code = code
+        code = html.unescape(code)
         if lang and lang.lower() != 'markdown':
             code = html.escape(code)
         lang_class = f' class="language-{lang}"' if lang else ''
-        return f'<pre><code{lang_class}>{code}</code></pre>'
+        icon_html = to_xml(UkIcon("copy", cls="w-4 h-4"))
+        code_id = f"codeblock-{abs(hash(raw_code)) & 0xFFFFFF}"
+        toast_id = f"{code_id}-toast"
+        textarea_id = f"{code_id}-clipboard"
+        escaped_raw = html.escape(raw_code)
+        return (
+            '<div class="code-block relative my-4">'
+            f'<button type="button" class="code-copy-button absolute top-2 right-2 '
+            'inline-flex items-center justify-center rounded border border-slate-200 '
+            'dark:border-slate-700 bg-white/80 dark:bg-slate-900/70 '
+            'text-slate-600 dark:text-slate-300 hover:text-slate-900 '
+            'dark:hover:text-white hover:border-slate-300 dark:hover:border-slate-500 '
+            f'transition-colors" aria-label="Copy code" '
+            f'onclick="(function(){{const el=document.getElementById(\'{textarea_id}\');const toast=document.getElementById(\'{toast_id}\');if(!el){{return;}}el.focus();el.select();const text=el.value;const done=()=>{{if(!toast){{return;}}toast.classList.remove(\'opacity-0\');toast.classList.add(\'opacity-100\');setTimeout(()=>{{toast.classList.remove(\'opacity-100\');toast.classList.add(\'opacity-0\');}},1400);}};if(navigator.clipboard&&window.isSecureContext){{navigator.clipboard.writeText(text).then(done).catch(()=>{{document.execCommand(\'copy\');done();}});}}else{{document.execCommand(\'copy\');done();}}}})()"'
+            '>'
+            f'{icon_html}<span class="sr-only">Copy code</span></button>'
+            f'<div id="{toast_id}" class="absolute top-2 right-10 text-xs bg-slate-900 text-white px-2 py-1 rounded opacity-0 transition-opacity duration-300">Copied</div>'
+            f'<textarea id="{textarea_id}" class="absolute left-[-9999px] top-0 opacity-0 pointer-events-none">{escaped_raw}</textarea>'
+            f'<pre><code{lang_class}>{code}</code></pre>'
+            '</div>'
+        )
     
     def render_link(self, token):
         href, inner, title = token.target, self.render_inner(token), f' title="{token.title}"' if token.title else ''
         # ...existing code...
-        is_external = href.startswith(('http://', 'https://', 'mailto:', 'tel:', '//', '#'))
+        is_hash = href.startswith('#')
+        is_external = href.startswith(('http://', 'https://', 'mailto:', 'tel:', '//'))
         is_absolute_internal = href.startswith('/') and not href.startswith('//')
         is_relative = not is_external and not is_absolute_internal
+        if is_hash:
+            link_class = (
+                "text-amber-600 dark:text-amber-400 underline underline-offset-2 "
+                "hover:text-amber-800 dark:hover:text-amber-200 font-medium transition-colors"
+            )
+            return f'<a href="{href}" class="{link_class}"{title}>{inner}</a>'
         if is_relative:
             from pathlib import Path
             original_href = href
@@ -585,7 +743,7 @@ class ContentRenderer(FrankenRenderer):
                 logger.debug(f"DEBUG: No current_path, treating as external")
         is_internal = is_absolute_internal and '.' not in href.split('/')[-1]
         hx = f' hx-get="{href}" hx-target="#main-content" hx-push-url="true" hx-swap="innerHTML show:window:top"' if is_internal else ''
-        ext = '' if (is_internal or is_absolute_internal) else ' target="_blank" rel="noopener noreferrer"'
+        ext = '' if (is_internal or is_absolute_internal or is_hash) else ' target="_blank" rel="noopener noreferrer"'
         # Amber/gold link styling, stands out and is accessible
         link_class = (
             "text-amber-600 dark:text-amber-400 underline underline-offset-2 "
@@ -632,7 +790,7 @@ def postprocess_tabs(html, tab_data_store, img_dir, current_path, footnotes):
 def from_md(content, img_dir=None, current_path=None):
     # Resolve img_dir from current_path if not explicitly provided
     if img_dir is None and current_path:
-        # Convert current_path to URL path for images (e.g., demo/flat-land/chapter-01 -> /posts/demo/flat-land)
+        # Convert current_path to URL path for images (e.g., demo/books/flat-land/chapter-01 -> /posts/demo/books/flat-land)
         from pathlib import Path
         path_parts = Path(current_path).parts
         if len(path_parts) > 1:
@@ -666,7 +824,8 @@ def from_md(content, img_dir=None, current_path=None):
     mods = {'pre': 'my-4', 'p': 'text-base leading-relaxed mb-6', 'li': 'text-base leading-relaxed',
             'ul': 'uk-list uk-list-bullet space-y-2 mb-6 ml-6 text-base', 'ol': 'uk-list uk-list-decimal space-y-2 mb-6 ml-6 text-base', 
             'hr': 'border-t border-border my-8', 'h1': 'text-3xl font-bold mb-6 mt-8', 'h2': 'text-2xl font-semibold mb-4 mt-6', 
-            'h3': 'text-xl font-semibold mb-3 mt-5', 'h4': 'text-lg font-semibold mb-2 mt-4'}
+            'h3': 'text-xl font-semibold mb-3 mt-5', 'h4': 'text-lg font-semibold mb-2 mt-4',
+            'table': 'uk-table uk-table-striped uk-table-hover uk-table-divider uk-table-middle my-6'}
     
     # Register custom tokens with renderer context manager
     with ContentRenderer(YoutubeEmbed, InlineCodeAttr, Strikethrough, FootnoteRef, Superscript, Subscript, img_dir=img_dir, footnotes=footnotes, current_path=current_path) as renderer:
@@ -682,10 +841,15 @@ def from_md(content, img_dir=None, current_path=None):
 # App configuration
 def get_root_folder(): return get_config().get_root_folder()
 def get_blog_title(): return get_config().get_blog_title()
+def get_favicon_href():
+    root_icon = get_root_folder() / "static" / "icon.png"
+    if root_icon.exists():
+        return "/static/icon.png"
+    return "/static/favicon.png"
 
 hdrs = (
     *Theme.slate.headers(highlightjs=True),
-    Link(rel="icon", href="/static/favicon.png"),
+    Link(rel="icon", href=get_favicon_href()),
     Script(src="https://unpkg.com/hyperscript.org@0.9.12"),
     Script(src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs", type="module"),
     Script("""
@@ -812,13 +976,48 @@ hdrs = (
         .sidebar-highlight.fade-out {
             box-shadow: 0 0 0 2px rgba(59, 130, 246, 0);
         }
+
+        /* PDF focus mode */
+        body.pdf-focus {
+            overflow: hidden;
+        }
+        body.pdf-focus #site-navbar,
+        body.pdf-focus #site-footer,
+        body.pdf-focus #posts-sidebar,
+        body.pdf-focus #toc-sidebar,
+        body.pdf-focus #mobile-posts-panel,
+        body.pdf-focus #mobile-toc-panel {
+            display: none !important;
+        }
+        body.pdf-focus #content-with-sidebars {
+            max-width: none !important;
+            width: 100vw !important;
+            padding: 0 !important;
+            margin: 0 !important;
+            gap: 0 !important;
+        }
+        body.pdf-focus #main-content {
+            padding: 1rem !important;
+        }
+        body.pdf-focus .pdf-viewer {
+            height: calc(100vh - 6rem) !important;
+        }
+
+        .layout-fluid {
+            --layout-breakpoint: 1280px;
+            --layout-blend: 240px;
+            max-width: calc(
+                100% - (100% - var(--layout-max-width))
+                * clamp(0, (100vw - var(--layout-breakpoint)) / var(--layout-blend), 1)
+            ) !important;
+        }
         
         /* Tabs styles */
         .tabs-container { 
             margin: 2rem 0; 
             border: 1px solid rgb(226 232 240); 
             border-radius: 0.5rem; 
-            overflow: hidden; 
+            overflow: visible; 
             box-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1);
         }
         .dark .tabs-container { 
@@ -877,6 +1076,7 @@ hdrs = (
         .tabs-content { 
             background: white;
             position: relative;
+            overflow: visible;
         }
         .dark .tabs-content { 
             background: rgb(2 6 23);
@@ -892,6 +1092,7 @@ hdrs = (
             opacity: 0;
             visibility: hidden;
             pointer-events: none;
+            overflow: visible;
         }
         .tab-panel.active { 
             position: relative;
@@ -918,6 +1119,43 @@ hdrs = (
             font-family: 'IBM Plex Mono', monospace;
         }
     """),
+    # Custom table stripe styling for punchier colors
+    Style("""
+        .uk-table-striped tbody tr:nth-of-type(odd) {
+            background-color: rgba(71, 85, 105, 0.08);
+        }
+        .dark .uk-table-striped tbody tr:nth-of-type(odd) {
+            background-color: rgba(148, 163, 184, 0.12);
+        }
+        .uk-table-striped tbody tr:hover {
+            background-color: rgba(59, 130, 246, 0.1);
+        }
+        .dark .uk-table-striped tbody tr:hover {
+            background-color: rgba(59, 130, 246, 0.15);
+        }
+        .uk-table thead {
+            border-bottom: 2px solid rgba(71, 85, 105, 0.3);
+        }
+        .dark .uk-table thead {
+            border-bottom: 2px solid rgba(148, 163, 184, 0.4);
+        }
+        .uk-table thead th {
+            font-weight: 600;
+            font-size: 1.25rem;
+            color: rgb(51, 65, 85);
+        }
+        .dark .uk-table thead th {
+            color: rgb(226, 232, 240);
+        }
+        .uk-table th:not(:last-child),
+        .uk-table td:not(:last-child) {
+            border-right: 1px solid rgba(71, 85, 105, 0.15);
+        }
+        .dark .uk-table th:not(:last-child),
+        .dark .uk-table td:not(:last-child) {
+            border-right: 1px solid rgba(148, 163, 184, 0.2);
+        }
+    """),
     # Script("if(!localStorage.__FRANKEN__) localStorage.__FRANKEN__ = JSON.stringify({mode: 'light'})"))
     Script("""
         (function () {
@@ -969,8 +1207,23 @@ logger.info(f'{beforeware=}')
 
 app = FastHTML(hdrs=hdrs, before=beforeware) if beforeware else FastHTML(hdrs=hdrs)
 
-static_dir = Path(__file__).parent / "static"
+def _favicon_icon_path():
+    root_icon = get_root_folder() / "static" / "icon.png"
+    if root_icon.exists():
+        return root_icon
+    package_favicon = Path(__file__).parent / "static" / "favicon.png"
+    if package_favicon.exists():
+        return package_favicon
+    return None
+
+@app.route("/static/icon.png")
+async def favicon_icon():
+    path = _favicon_icon_path()
+    if path and path.exists():
+        return FileResponse(path)
+    return Response(status_code=404)
 
+static_dir = Path(__file__).parent / "static"
 if static_dir.exists():
     app.mount("/static", StaticFiles(directory=str(static_dir)), name="static")
 
@@ -978,7 +1231,7 @@ rt = app.route
 
 
 from starlette.requests import Request
-from starlette.responses import RedirectResponse
+from starlette.responses import RedirectResponse, FileResponse, Response
 
 @rt("/login", methods=["GET", "POST"])
 async def login(request: Request):
@@ -1017,10 +1270,88 @@ def posts_sidebar_lazy():
     html = _cached_posts_sidebar_html(_posts_sidebar_fingerprint())
     return Aside(
         NotStr(html),
-        cls="hidden md:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
+        cls="hidden xl:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
         id="posts-sidebar"
     )
 
+# Route to serve raw markdown for LLM-friendly access
+@rt("/posts/{path:path}.md")
+def serve_post_markdown(path: str):
+    from starlette.responses import FileResponse
+    file_path = get_root_folder() / f'{path}.md'
+    if file_path.exists():
+        return FileResponse(file_path, media_type="text/markdown; charset=utf-8")
+    return Response(status_code=404)
+
+@rt("/search/gather")
+def gather_search_results(htmx, q: str = ""):
+    import html
+    matches, regex_error = _find_search_matches(q, limit=200)
+    if not matches:
+        content = Div(
+            H1("Search Results", cls="text-3xl font-bold mb-6"),
+            P("No matching posts found.", cls="text-slate-600 dark:text-slate-400"),
+            P(regex_error, cls="text-amber-600 dark:text-amber-400 text-sm") if regex_error else None
+        )
+        return layout(content, htmx=htmx, title="Search Results", show_sidebar=True)
+
+    root = get_root_folder()
+    sections = []
+    copy_parts = [f"# Search Results: {q.strip() or 'All'}\n"]
+    if regex_error:
+        copy_parts.append(f"> {regex_error}\n")
+    for idx, item in enumerate(matches):
+        rel = item.relative_to(root).as_posix()
+        if item.suffix == ".pdf":
+            slug = item.relative_to(root).with_suffix("").as_posix()
+            pdf_href = f"/posts/{slug}.pdf"
+            sections.extend([
+                H2(rel, cls="text-xl font-semibold mb-2"),
+                P(
+                    "PDF file: ",
+                    A(rel, href=pdf_href, cls="text-blue-600 hover:underline"),
+                    cls="text-sm text-slate-600 dark:text-slate-300"
+                ),
+                Hr(cls="my-6 border-slate-200 dark:border-slate-800") if idx < len(matches) - 1 else None
+            ])
+            copy_parts.append(f"\n---\n\n## {rel}\n\n[PDF file]({pdf_href})\n")
+            continue
+        try:
+            raw_md = item.read_text(encoding="utf-8")
+        except Exception:
+            raw_md = ""
+        sections.extend([
+            H2(rel, cls="text-xl font-semibold mb-2"),
+            Pre(html.escape(raw_md), cls="text-xs font-mono whitespace-pre-wrap text-slate-700 dark:text-slate-300"),
+            Hr(cls="my-6 border-slate-200 dark:border-slate-800") if idx < len(matches) - 1 else None
+        ])
+        copy_parts.append(f"\n---\n\n## {rel}\n\n{raw_md}\n")
+
+    copy_text = "".join(copy_parts)
+    content = Div(
+        H1(f"Search Results: {q.strip() or 'All'}", cls="text-3xl font-bold mb-6"),
+        P(regex_error, cls="text-amber-600 dark:text-amber-400 text-sm mb-4") if regex_error else None,
+        Button(
+            UkIcon("copy", cls="w-5 h-5"),
+            Span("Copy all results", cls="text-sm font-semibold"),
+            type="button",
+            onclick="(function(){const el=document.getElementById('gather-clipboard');const toast=document.getElementById('gather-toast');if(!el){return;}el.focus();el.select();const text=el.value;const done=()=>{if(!toast){return;}toast.classList.remove('opacity-0');toast.classList.add('opacity-100');setTimeout(()=>{toast.classList.remove('opacity-100');toast.classList.add('opacity-0');},1400);};if(navigator.clipboard&&window.isSecureContext){navigator.clipboard.writeText(text).then(done).catch(()=>{document.execCommand('copy');done();});}else{document.execCommand('copy');done();}})()",
+            cls="inline-flex items-center gap-2 px-3 py-2 mb-6 rounded-md border border-slate-200 dark:border-slate-700 text-slate-700 dark:text-slate-200 hover:text-slate-900 dark:hover:text-white hover:border-slate-300 dark:hover:border-slate-500 transition-colors"
+        ),
+        Div(
+            "Copied!",
+            id="gather-toast",
+            cls="fixed top-6 right-6 bg-slate-900 text-white text-sm px-4 py-2 rounded shadow-lg opacity-0 transition-opacity duration-300"
+        ),
+        Textarea(
+            copy_text,
+            id="gather-clipboard",
+            cls="absolute left-[-9999px] top-0 opacity-0 pointer-events-none"
+        ),
+        *sections
+    )
+    return layout(content, htmx=htmx, title="Search Results", show_sidebar=True)
+
 # Route to serve static files (images, SVGs, etc.) from blog posts
 @rt("/posts/{path:path}.{ext:static}")
 def serve_post_static(path: str, ext: str):
@@ -1043,7 +1374,14 @@ def theme_toggle():
 def navbar(show_mobile_menus=False):
     """Navbar with mobile menu buttons for file tree and TOC"""
     left_section = Div(
-        A(get_blog_title(), href="/"),
+        A(
+            get_blog_title(),
+            href="/",
+            hx_get="/",
+            hx_target="#main-content",
+            hx_push_url="true",
+            hx_swap="outerHTML show:window:top settle:0.1s"
+        ),
         cls="flex items-center gap-2"
     )
     
@@ -1059,14 +1397,14 @@ def navbar(show_mobile_menus=False):
                 UkIcon("menu", cls="w-5 h-5"),
                 title="Toggle file tree",
                 id="mobile-posts-toggle",
-                cls="md:hidden p-2 hover:bg-slate-800 rounded transition-colors",
+                cls="xl:hidden p-2 hover:bg-slate-800 rounded transition-colors",
                 type="button"
             ),
             Button(
                 UkIcon("list", cls="w-5 h-5"),
                 title="Toggle table of contents",
                 id="mobile-toc-toggle",
-                cls="md:hidden p-2 hover:bg-slate-800 rounded transition-colors",
+                cls="xl:hidden p-2 hover:bg-slate-800 rounded transition-colors",
                 type="button"
             ),
             cls="flex items-center gap-1"
@@ -1087,18 +1425,166 @@ def _posts_sidebar_fingerprint():
     except Exception:
         return 0
 
+def _normalize_search_text(text):
+    text = (text or "").lower()
+    text = text.replace("-", " ").replace("_", " ")
+    return " ".join(text.split())
+
+def _parse_search_query(query):
+    trimmed = (query or "").strip()
+    if len(trimmed) >= 2 and trimmed.startswith("/") and trimmed.endswith("/"):
+        pattern = trimmed[1:-1].strip()
+        if not pattern:
+            return None, ""
+        try:
+            return re.compile(pattern, re.IGNORECASE), ""
+        except re.error:
+            return None, "Invalid regex. Showing normal matches instead."
+    return None, ""
+
+@lru_cache(maxsize=256)
+def _cached_search_matches(fingerprint, query, limit):
+    return _find_search_matches_uncached(query, limit)
+
+def _find_search_matches(query, limit=40):
+    fingerprint = _posts_sidebar_fingerprint()
+    return _cached_search_matches(fingerprint, query, limit)
+
+def _find_search_matches_uncached(query, limit=40):
+    trimmed = (query or "").strip()
+    if not trimmed:
+        return [], ""
+    regex, regex_error = _parse_search_query(trimmed)
+    query_norm = _normalize_search_text(trimmed) if not regex else ""
+    root = get_root_folder()
+    index_file = find_index_file()
+    results = []
+    for item in chain(root.rglob("*.md"), root.rglob("*.pdf")):
+        if any(part.startswith('.') for part in item.relative_to(root).parts):
+            continue
+        if ".bloggy" in item.parts:
+            continue
+        if index_file and item.resolve() == index_file.resolve():
+            continue
+        rel = item.relative_to(root).with_suffix("")
+        if regex:
+            haystack = f"{item.name} {rel.as_posix()}"
+            is_match = regex.search(haystack)
+        else:
+            haystack = _normalize_search_text(f"{item.name} {rel.as_posix()}")
+            is_match = query_norm in haystack
+        if is_match:
+            results.append(item)
+            if len(results) >= limit:
+                break
+    return tuple(results), regex_error
+
+def _render_posts_search_results(query):
+    trimmed = (query or "").strip()
+    if not trimmed:
+        return Ul(
+            Li("Type to search file names.", cls="text-[0.7rem] text-center text-slate-500 dark:text-slate-400 bg-transparent"),
+            cls="posts-search-results-list space-y-1 bg-white/0 dark:bg-slate-950/0"
+        )
+
+    matches, regex_error = _find_search_matches(trimmed)
+    if not matches:
+        return Ul(
+            Li(f'No matches for "{trimmed}".', cls="text-xs text-slate-500 dark:text-slate-400 bg-transparent"),
+            Li(regex_error, cls="text-[0.7rem] text-center text-amber-600 dark:text-amber-400") if regex_error else None,
+            cls="posts-search-results-list space-y-1 bg-white/0 dark:bg-slate-950/0"
+        )
+
+    root = get_root_folder()
+    items = []
+    gather_href = f"/search/gather?q={quote_plus(trimmed)}"
+    items.append(Li(
+        A(
+            Span(UkIcon("layers", cls="w-4 h-4 text-slate-400"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
+            Span("Gather all search results for LLM", cls="truncate min-w-0 text-xs text-slate-600 dark:text-slate-300"),
+            href=gather_href,
+            hx_get=gather_href,
+            hx_target="#main-content",
+            hx_push_url="true",
+            hx_swap="outerHTML show:window:top settle:0.1s",
+            cls="post-search-link flex items-center py-1 px-2 rounded bg-transparent hover:bg-slate-100 dark:hover:bg-slate-800 text-slate-700 dark:text-slate-300 hover:text-blue-600 transition-colors min-w-0"
+        ),
+        cls="bg-transparent"
+    ))
+    for item in matches:
+        slug = str(item.relative_to(root).with_suffix(""))
+        if item.suffix == ".pdf":
+            display = item.relative_to(root).as_posix()
+        else:
+            display = item.relative_to(root).with_suffix("").as_posix()
+        items.append(Li(
+            A(
+                Span(UkIcon("search", cls="w-4 h-4 text-slate-400"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
+                Span(display, cls="truncate min-w-0 font-mono text-xs text-slate-600 dark:text-slate-300", title=display),
+                href=f'/posts/{slug}',
+                hx_get=f'/posts/{slug}', hx_target="#main-content", hx_push_url="true", hx_swap="outerHTML show:window:top settle:0.1s",
+                cls="post-search-link flex items-center py-1 px-2 rounded hover:bg-slate-100 dark:hover:bg-slate-800 text-slate-700 dark:text-slate-300 hover:text-blue-600 transition-colors min-w-0"
+            )
+        ))
+    if regex_error:
+        items.append(Li(regex_error, cls="text-[0.7rem] text-center text-amber-600 dark:text-amber-400 mt-1 bg-transparent"))
+    return Ul(*items, cls="posts-search-results-list space-y-1 bg-white/0 dark:bg-slate-950/0")
+
+def _posts_search_block():
+    return Div(
+        Div("Filter", cls="text-xs uppercase tracking-widest text-slate-500 dark:text-slate-400 mb-2"),
+        Div(
+            Input(
+                type="search",
+                name="q",
+                placeholder="Search file names…",
+                autocomplete="off",
+                data_placeholder_cycle="1",
+                data_placeholder_primary="Search file names…",
+                data_placeholder_alt="Search regex with /pattern/ syntax",
+                data_search_key="posts",
+                hx_get="/_sidebar/posts/search",
+                hx_trigger="input changed delay:300ms",
+                hx_target="next .posts-search-results",
+                hx_swap="innerHTML",
+                cls="w-full px-3 py-2 text-sm rounded-md border border-slate-200 dark:border-slate-700 bg-white/80 dark:bg-slate-900/60 text-slate-700 dark:text-slate-200 focus:outline-none focus:ring-2 focus:ring-blue-500"
+            ),
+            Button(
+                "×",
+                type="button",
+                aria_label="Clear search",
+                cls="posts-search-clear-button absolute right-2 top-1/2 -translate-y-1/2 h-6 w-6 rounded text-slate-400 hover:text-slate-600 dark:text-slate-500 dark:hover:text-slate-300 hover:bg-slate-100 dark:hover:bg-slate-800 transition-colors"
+            ),
+            cls="relative"
+        ),
+        Div(
+            _render_posts_search_results(""),
+            id="posts-search-results",
+            cls="posts-search-results mt-4 max-h-64 overflow-y-auto bg-white/0 dark:bg-slate-950/0"
+        ),
+        cls="posts-search-block sticky top-0 z-10 bg-white/20 dark:bg-slate-950/70 mb-3"
+    )
+
 @lru_cache(maxsize=1)
 def _cached_posts_sidebar_html(fingerprint):
+    sidebars_open = get_config().get_sidebars_open()
     sidebar = collapsible_sidebar(
         "menu",
-        "Posts",
+        "Library",
         get_posts(),
-        is_open=False,
-        data_sidebar="posts"
+        is_open=sidebars_open,
+        data_sidebar="posts",
+        shortcut_key="Z",
+        extra_content=[
+            _posts_search_block(),
+            Div(cls="h-px w-full bg-slate-200/80 dark:bg-slate-700/70 my-2"),
+            Div("Posts", cls="text-xs uppercase tracking-widest text-slate-500 dark:text-slate-400 mb-1")
+        ],
+        scroll_target="list"
     )
     return to_xml(sidebar)
 
-def collapsible_sidebar(icon, title, items_list, is_open=False, data_sidebar=None):
+def collapsible_sidebar(icon, title, items_list, is_open=False, data_sidebar=None, shortcut_key=None, extra_content=None, scroll_target="container"):
     """Reusable collapsible sidebar component with sticky header"""
     # Build the summary content
     summary_content = [
@@ -1109,22 +1595,45 @@ def collapsible_sidebar(icon, title, items_list, is_open=False, data_sidebar=Non
         Span(title, cls="flex-1 leading-none")
     ]
     
+    # Add keyboard shortcut indicator if provided
+    if shortcut_key:
+        summary_content.append(
+            Kbd(
+                shortcut_key,
+                cls="kbd-key px-2.5 py-1.5 text-xs font-mono font-semibold bg-gradient-to-b from-slate-50 to-slate-200 dark:from-slate-700 dark:to-slate-900 text-slate-800 dark:text-slate-200 rounded-md border-2 border-slate-300 dark:border-slate-600 shadow-[0_2px_0_0_rgba(0,0,0,0.1),inset_0_1px_0_0_rgba(255,255,255,0.5)] dark:shadow-[0_2px_0_0_rgba(0,0,0,0.5),inset_0_1px_0_0_rgba(255,255,255,0.1)]"
+            )
+        )
+    
     # Sidebar styling configuration
     common_frost_style = "bg-white/20 dark:bg-slate-950/70 backdrop-blur-lg border border-slate-900/10 dark:border-slate-700/25 ring-1 ring-white/20 dark:ring-slate-900/30 shadow-[0_24px_60px_-40px_rgba(15,23,42,0.45)] dark:shadow-[0_28px_70px_-45px_rgba(2,6,23,0.85)]"
     summary_classes = f"flex items-center gap-2 font-semibold cursor-pointer py-2.5 px-3 hover:bg-slate-100/80 dark:hover:bg-slate-800/80 rounded-lg select-none list-none {common_frost_style} min-h-[56px]"
-    content_classes = f"p-3 {common_frost_style} rounded-lg overflow-y-auto max-h-[calc(100vh-18rem)]"
+    if scroll_target == "list":
+        content_classes = f"p-3 {common_frost_style} rounded-lg max-h-[calc(100vh-18rem)] flex flex-col overflow-hidden min-h-0"
+        list_classes = "list-none pt-2 flex-1 min-h-0 overflow-y-auto sidebar-scroll-container"
+    else:
+        content_classes = f"p-3 {common_frost_style} rounded-lg overflow-y-auto max-h-[calc(100vh-18rem)] sidebar-scroll-container"
+        list_classes = "list-none pt-4"
     
+    extra_content = extra_content or []
+    content_id = "sidebar-scroll-container" if scroll_target != "list" else None
     return Details(
         Summary(*summary_content, cls=summary_classes, style="margin: 0 0 0.5rem 0;"),
         Div(
-            Ul(*items_list, cls="list-none"),
+            *extra_content,
+            Ul(*items_list, cls=list_classes, id="sidebar-scroll-container" if scroll_target == "list" else None),
             cls=content_classes,
-            id="sidebar-scroll-container"
+            id=content_id,
+            style="will-change: auto;"
         ),
         open=is_open,
-        data_sidebar=data_sidebar
+        data_sidebar=data_sidebar,
+        style="will-change: auto;"
     )
 
+@rt("/_sidebar/posts/search")
+def posts_sidebar_search(q: str = ""):
+    return _render_posts_search_results(q)
+
 def is_active_toc_item(anchor):
     """Check if a TOC item is currently active based on URL hash"""
     # This will be enhanced client-side with JavaScript
@@ -1140,11 +1649,13 @@ def extract_toc(content):
     # Parse headings from the cleaned content
     heading_pattern = re.compile(r'^(#{1,6})\s+(.+)$', re.MULTILINE)
     headings = []
+    counts = {}
     for match in heading_pattern.finditer(content_no_code):
         level = len(match.group(1))
-        text = match.group(2).strip()
+        raw_text = match.group(2).strip()
+        text = _strip_inline_markdown(raw_text)
         # Create anchor from heading text using shared function
-        anchor = text_to_anchor(text)
+        anchor = _unique_anchor(text_to_anchor(text), counts)
         headings.append((level, text, anchor))
     return headings
 
@@ -1204,7 +1715,7 @@ def get_custom_css_links(current_path=None, section_class=None):
     
     return css_elements
 
-def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, current_path=None):
+def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, current_path=None, show_toc=True):
     import time
     layout_start_time = time.time()
     logger.debug("[LAYOUT] layout() start")
@@ -1212,23 +1723,30 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
     section_class = f"section-{current_path.replace('/', '-')}" if current_path else ""
     t_section = time.time()
     logger.debug(f"[LAYOUT] section_class computed in {(t_section - layout_start_time)*1000:.2f}ms")
+    layout_config = _resolve_layout_config(current_path)
+    layout_max_class, layout_max_style = _width_class_and_style(layout_config.get("layout_max_width"), "max")
+    layout_fluid_class = "layout-fluid" if layout_max_style else ""
 
     # HTMX short-circuit: build only swappable fragments, never build full page chrome/sidebars tree
     if htmx and getattr(htmx, "request", None):
         if show_sidebar:
-            toc_items = build_toc_items(extract_toc(toc_content)) if toc_content else []
-            t_toc = time.time()
-            logger.debug(f"[LAYOUT] TOC built in {(t_toc - t_section)*1000:.2f}ms")
-
-            toc_attrs = {
-                "cls": "hidden md:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
-                "id": "toc-sidebar",
-                "hx_swap_oob": "true",
-            }
-            toc_sidebar = Aside(
-                collapsible_sidebar("list", "Contents", toc_items, is_open=False) if toc_items else Div(),
-                **toc_attrs
-            )
+            toc_sidebar = None
+            t_toc = t_section
+            if show_toc:
+                toc_items = build_toc_items(extract_toc(toc_content)) if toc_content else []
+                t_toc = time.time()
+                logger.debug(f"[LAYOUT] TOC built in {(t_toc - t_section)*1000:.2f}ms")
+
+                sidebars_open = get_config().get_sidebars_open()
+                toc_attrs = {
+                    "cls": "hidden xl:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
+                    "id": "toc-sidebar",
+                    "hx_swap_oob": "true",
+                }
+                toc_sidebar = Aside(
+                    collapsible_sidebar("list", "Contents", toc_items, is_open=sidebars_open, shortcut_key="X") if toc_items else Div(),
+                    **toc_attrs
+                )
 
             custom_css_links = get_custom_css_links(current_path, section_class)
             t_css = time.time()
@@ -1243,7 +1761,12 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
                 result.append(Div(*custom_css_links, id="scoped-css-container", hx_swap_oob="true"))
             else:
                 result.append(Div(id="scoped-css-container", hx_swap_oob="true"))
-            result.extend([main_content_container, toc_sidebar])
+            if toc_sidebar:
+                result.extend([main_content_container, toc_sidebar])
+            else:
+                result.append(main_content_container)
+                result.append(Div(id="toc-sidebar", hx_swap_oob="true"))
+                result.append(Div(id="mobile-toc-panel", hx_swap_oob="true"))
 
             t_htmx = time.time()
             logger.debug(f"[LAYOUT] HTMX response assembled in {(t_htmx - t_main)*1000:.2f}ms")
@@ -1269,18 +1792,22 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
 
     if show_sidebar:
         # Build TOC if content provided
-        toc_items = build_toc_items(extract_toc(toc_content)) if toc_content else []
-        t_toc = time.time()
-        logger.debug(f"[LAYOUT] TOC built in {(t_toc - t_section)*1000:.2f}ms")
-        # Right sidebar TOC component with out-of-band swap for HTMX
-        toc_attrs = {
-            "cls": "hidden md:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
-            "id": "toc-sidebar"
-        }
-        toc_sidebar = Aside(
-            collapsible_sidebar("list", "Contents", toc_items, is_open=False) if toc_items else Div(),
-            **toc_attrs
-        )
+        toc_sidebar = None
+        t_toc = t_section
+        if show_toc:
+            toc_items = build_toc_items(extract_toc(toc_content)) if toc_content else []
+            t_toc = time.time()
+            logger.debug(f"[LAYOUT] TOC built in {(t_toc - t_section)*1000:.2f}ms")
+            # Right sidebar TOC component with out-of-band swap for HTMX
+            sidebars_open = get_config().get_sidebars_open()
+            toc_attrs = {
+                "cls": "hidden xl:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
+                "id": "toc-sidebar"
+            }
+            toc_sidebar = Aside(
+                collapsible_sidebar("list", "Contents", toc_items, is_open=sidebars_open, shortcut_key="X") if toc_items else Div(),
+                **toc_attrs
+            )
         # Container for main content only (for HTMX swapping)
         # Add section class to identify the section for CSS scoping
         section_class = f"section-{current_path.replace('/', '-')}" if current_path else ""
@@ -1307,27 +1834,33 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
                 cls="p-4 overflow-y-auto"
             ),
             id="mobile-posts-panel",
-            cls="fixed inset-0 bg-white dark:bg-slate-950 z-[9999] md:hidden transform -translate-x-full transition-transform duration-300"
+            cls="fixed inset-0 bg-white dark:bg-slate-950 z-[9999] xl:hidden transform -translate-x-full transition-transform duration-300"
         )
-        mobile_toc_panel = Div(
-            Div(
-                Button(
-                    UkIcon("x", cls="w-5 h-5"),
-                    id="close-mobile-toc",
-                    cls="p-2 hover:bg-slate-200 dark:hover:bg-slate-700 rounded transition-colors ml-auto",
-                    type="button"
+        mobile_toc_panel = None
+        if show_toc:
+            mobile_toc_panel = Div(
+                Div(
+                    Button(
+                        UkIcon("x", cls="w-5 h-5"),
+                        id="close-mobile-toc",
+                        cls="p-2 hover:bg-slate-200 dark:hover:bg-slate-700 rounded transition-colors ml-auto",
+                        type="button"
+                    ),
+                    cls="flex justify-end p-2 bg-white dark:bg-slate-950 border-b border-slate-200 dark:border-slate-800"
                 ),
-                cls="flex justify-end p-2 bg-white dark:bg-slate-950 border-b border-slate-200 dark:border-slate-800"
-            ),
-            Div(
-                collapsible_sidebar("list", "Contents", toc_items, is_open=False) if toc_items else Div(P("No table of contents available.", cls="text-slate-500 dark:text-slate-400 text-sm p-4")),
-                cls="p-4 overflow-y-auto"
-            ),
-            id="mobile-toc-panel",
-            cls="fixed inset-0 bg-white dark:bg-slate-950 z-[9999] md:hidden transform translate-x-full transition-transform duration-300"
-        )
+                Div(
+                    collapsible_sidebar("list", "Contents", toc_items, is_open=sidebars_open, shortcut_key="X") if toc_items else Div(P("No table of contents available.", cls="text-slate-500 dark:text-slate-400 text-sm p-4")),
+                    cls="p-4 overflow-y-auto"
+                ),
+                id="mobile-toc-panel",
+                cls="fixed inset-0 bg-white dark:bg-slate-950 z-[9999] xl:hidden transform translate-x-full transition-transform duration-300"
+            )
         # Full layout with all sidebars
-        content_with_sidebars = Div(cls="w-full max-w-7xl mx-auto px-4 flex gap-6 flex-1")(
+        content_with_sidebars = Div(
+            cls=f"layout-container {layout_fluid_class} w-full {layout_max_class} mx-auto px-4 flex gap-6 flex-1".strip(),
+            id="content-with-sidebars",
+            **_style_attr(layout_max_style)
+        )(
             # Left sidebar - lazy load with HTMX, show loader placeholder
             Aside(
                 Div(
@@ -1335,7 +1868,7 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
                     Span("Loading posts…", cls="ml-2 text-sm"),
                     cls="flex items-center justify-center h-32 text-slate-400"
                 ),
-                cls="hidden md:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
+                cls="hidden xl:block w-72 shrink-0 sticky top-24 self-start max-h-[calc(100vh-10rem)] overflow-hidden z-[1000]",
                 id="posts-sidebar",
                 hx_get="/_sidebar/posts",
                 hx_trigger="load",
@@ -1344,27 +1877,46 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
             # Main content (swappable)
             main_content_container,
             # Right sidebar - TOC (swappable out-of-band)
-            toc_sidebar
+            toc_sidebar if toc_sidebar else None
         )
         t_sidebars = time.time()
         logger.debug(f"[LAYOUT] Sidebars container built in {(t_sidebars - t_main)*1000:.2f}ms")
         # Layout with sidebar for blog posts
         body_content = Div(id="page-container", cls="flex flex-col min-h-screen")(
-            Div(navbar(show_mobile_menus=True), cls="w-full max-w-7xl mx-auto px-4 sticky top-0 z-50 mt-4"),
+            Div(
+                navbar(show_mobile_menus=True),
+                cls=f"layout-container {layout_fluid_class} w-full {layout_max_class} mx-auto px-4 sticky top-0 z-50 mt-4".strip(),
+                id="site-navbar",
+                **_style_attr(layout_max_style)
+            ),
             mobile_posts_panel,
-            mobile_toc_panel,
+            mobile_toc_panel if mobile_toc_panel else None,
             content_with_sidebars,
-            Footer(Div(f"Powered by Bloggy", cls="bg-slate-900 text-white rounded-lg p-4 my-4 dark:bg-slate-800 text-right"), # right justified footer
-                   cls="w-full max-w-7xl mx-auto px-6 mt-auto mb-6")
+            Footer(Div(NotStr('Powered by <a href="https://github.com/sizhky/bloggy" class="underline hover:text-white/80" target="_blank" rel="noopener noreferrer">Bloggy</a> and ❤️'), cls="bg-slate-900 text-white rounded-lg p-4 my-4 dark:bg-slate-800 text-right"), # right justified footer
+                   cls=f"layout-container {layout_fluid_class} w-full {layout_max_class} mx-auto px-6 mt-auto mb-6".strip(),
+                   id="site-footer",
+                   **_style_attr(layout_max_style))
         )
     else:
         # Default layout without sidebar
         custom_css_links = get_custom_css_links(current_path, section_class) if current_path else []
         body_content = Div(id="page-container", cls="flex flex-col min-h-screen")(
-            Div(navbar(), cls="w-full max-w-2xl mx-auto px-4 sticky top-0 z-50 mt-4"),
-            Main(*content, cls="w-full max-w-2xl mx-auto px-6 py-8 space-y-8", id="main-content"),
-            Footer(Div("Powered by Bloggy", cls="bg-slate-900 text-white rounded-lg p-4 my-4 dark:bg-slate-800 text-right"), 
-                   cls="w-full max-w-2xl mx-auto px-6 mt-auto mb-6")
+            Div(
+                navbar(),
+                cls=f"layout-container {layout_fluid_class} w-full {layout_max_class} mx-auto px-4 sticky top-0 z-50 mt-4".strip(),
+                id="site-navbar",
+                **_style_attr(layout_max_style)
+            ),
+            Main(
+                *content,
+                cls=f"layout-container {layout_fluid_class} w-full {layout_max_class} mx-auto px-6 py-8 space-y-8".strip(),
+                id="main-content",
+                **_style_attr(layout_max_style)
+            ),
+            Footer(Div(NotStr('Powered by <a href="https://github.com/sizhky/bloggy" class="underline hover:text-white/80" target="_blank" rel="noopener noreferrer">Bloggy</a> and ❤️'), cls="bg-slate-900 text-white rounded-lg p-4 my-4 dark:bg-slate-800 text-right"), 
+                   cls=f"layout-container {layout_fluid_class} w-full {layout_max_class} mx-auto px-6 mt-auto mb-6".strip(),
+                   id="site-footer",
+                   **_style_attr(layout_max_style))
         )
         t_body = time.time()
         logger.debug(f"[LAYOUT] Body content (no sidebar) built in {(t_body - layout_start_time)*1000:.2f}ms")
@@ -1398,7 +1950,7 @@ def build_post_tree(folder):
                 if item.name.startswith('.'):
                     continue
                 entries.append(item)
-            elif item.suffix == '.md':
+            elif item.suffix in ('.md', '.pdf'):
                 # Skip the file being used for home page (index.md takes precedence over readme.md)
                 if index_file and item.resolve() == index_file.resolve():
                     continue
@@ -1443,6 +1995,17 @@ def build_post_tree(folder):
                 hx_get=f'/posts/{slug}', hx_target="#main-content", hx_push_url="true", hx_swap="outerHTML show:window:top settle:0.1s",
                 cls="post-link flex items-center py-1 px-2 rounded hover:bg-slate-100 dark:hover:bg-slate-800 text-slate-700 dark:text-slate-300 hover:text-blue-600 transition-colors min-w-0",
                 data_path=slug)))
+        elif item.suffix == '.pdf':
+            slug = str(item.relative_to(root).with_suffix(''))
+            title = slug_to_title(item.stem)
+            items.append(Li(A(
+                Span(cls="w-4 mr-2 shrink-0"),
+                Span(UkIcon("file-text", cls="text-slate-400 w-4 h-4"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
+                Span(f"{title} (PDF)", cls="truncate min-w-0", title=title),
+                href=f'/posts/{slug}',
+                hx_get=f'/posts/{slug}', hx_target="#main-content", hx_push_url="true", hx_swap="outerHTML show:window:top settle:0.1s",
+                cls="post-link flex items-center py-1 px-2 rounded hover:bg-slate-100 dark:hover:bg-slate-800 text-slate-700 dark:text-slate-300 hover:text-blue-600 transition-colors min-w-0",
+                data_path=slug)))
     
     elapsed = (time.time() - start_time) * 1000
     logger.debug(f"[DEBUG] build_post_tree for {folder.relative_to(root) if folder != root else '.'} completed in {elapsed:.2f}ms")
@@ -1452,8 +2015,9 @@ def _posts_tree_fingerprint():
     root = get_root_folder()
     try:
         md_mtime = max((p.stat().st_mtime for p in root.rglob("*.md")), default=0)
+        pdf_mtime = max((p.stat().st_mtime for p in root.rglob("*.pdf")), default=0)
         bloggy_mtime = max((p.stat().st_mtime for p in root.rglob(".bloggy")), default=0)
-        return max(md_mtime, bloggy_mtime)
+        return max(md_mtime, pdf_mtime, bloggy_mtime)
     except Exception:
         return 0
 
@@ -1491,6 +2055,10 @@ def not_found(htmx=None):
                 UkIcon("home", cls="w-5 h-5 mr-2"),
                 "Go to Home",
                 href="/",
+                hx_get="/",
+                hx_target="#main-content",
+                hx_push_url="true",
+                hx_swap="outerHTML show:window:top settle:0.1s",
                 cls="inline-flex items-center px-6 py-3 bg-blue-600 hover:bg-blue-700 text-white rounded-lg font-medium transition-colors mr-4"
             ),
             A(
@@ -1528,9 +2096,39 @@ def post_detail(path: str, htmx):
     logger.info(f"\n[DEBUG] ########## REQUEST START: /posts/{path} ##########")
     
     file_path = get_root_folder() / f'{path}.md'
+    pdf_path = get_root_folder() / f'{path}.pdf'
     
     # Check if file exists
     if not file_path.exists():
+        if pdf_path.exists():
+            post_title = f"{slug_to_title(Path(path).name)} (PDF)"
+            pdf_src = f"/posts/{path}.pdf"
+            pdf_content = Div(
+                Div(
+                    H1(post_title, cls="text-4xl font-bold"),
+                    Button(
+                        "Focus PDF",
+                        cls="pdf-focus-toggle inline-flex items-center gap-2 px-3 py-1.5 text-sm font-medium rounded-md border border-slate-200 dark:border-slate-700 bg-white dark:bg-slate-900 hover:bg-slate-50 dark:hover:bg-slate-800 transition-colors",
+                        type="button",
+                        data_pdf_focus_toggle="true",
+                        data_pdf_focus_label="Focus PDF",
+                        data_pdf_exit_label="Exit focus",
+                        aria_pressed="false"
+                    ),
+                    cls="flex items-center justify-between gap-4 flex-wrap mb-6"
+                ),
+                NotStr(
+                    f'<object data="{pdf_src}" type="application/pdf" '
+                    'class="pdf-viewer w-full h-[calc(100vh-14rem)] rounded-lg border border-slate-200 '
+                    'dark:border-slate-700 bg-white dark:bg-slate-900">'
+                    '<p class="p-4 text-sm text-slate-600 dark:text-slate-300">'
+                    'PDF preview not available. '
+                    f'<a href="{pdf_src}" class="text-blue-600 hover:underline">Download PDF</a>.'
+                    '</p></object>'
+                )
+            )
+            return layout(pdf_content, htmx=htmx, title=f"{post_title} - {get_blog_title()}",
+                          show_sidebar=True, toc_content=None, current_path=path, show_toc=False)
         return not_found(htmx)
     
     metadata, raw_content = parse_frontmatter(file_path)
@@ -1544,7 +2142,31 @@ def post_detail(path: str, htmx):
     md_time = (time.time() - md_start) * 1000
     logger.debug(f"[DEBUG] Markdown rendering took {md_time:.2f}ms")
     
-    post_content = Div(H1(post_title, cls="text-4xl font-bold mb-8"), content)
+    copy_button = Button(
+        UkIcon("copy", cls="w-4 h-4"),
+        type="button",
+        title="Copy raw markdown",
+        onclick="(function(){const el=document.getElementById('raw-md-clipboard');const toast=document.getElementById('raw-md-toast');if(!el){return;}el.focus();el.select();const text=el.value;const done=()=>{if(!toast){return;}toast.classList.remove('opacity-0');toast.classList.add('opacity-100');setTimeout(()=>{toast.classList.remove('opacity-100');toast.classList.add('opacity-0');},1400);};if(navigator.clipboard&&window.isSecureContext){navigator.clipboard.writeText(text).then(done).catch(()=>{document.execCommand('copy');done();});}else{document.execCommand('copy');done();}})()",
+        cls="inline-flex items-center justify-center p-2 rounded-md border border-slate-200 dark:border-slate-700 text-slate-600 dark:text-slate-300 hover:text-slate-900 dark:hover:text-white hover:border-slate-300 dark:hover:border-slate-500 transition-colors"
+    )
+    post_content = Div(
+        Div(
+            H1(post_title, cls="text-4xl font-bold"),
+            copy_button,
+            cls="flex flex-col gap-3 md:flex-row md:items-center md:justify-between mb-8"
+        ),
+        Div(
+            "Copied Raw Markdown!",
+            id="raw-md-toast",
+            cls="fixed top-6 right-6 bg-slate-900 text-white text-sm px-4 py-2 rounded shadow-lg opacity-0 transition-opacity duration-300"
+        ),
+        Textarea(
+            raw_content,
+            id="raw-md-clipboard",
+            cls="absolute left-[-9999px] top-0 opacity-0 pointer-events-none"
+        ),
+        content
+    )
     
     # Always return complete layout with sidebar and TOC
     layout_start = time.time()