bloggy 0.1.39__tar.gz → 0.1.57__tar.gz

{bloggy-0.1.39/bloggy.egg-info → bloggy-0.1.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bloggy
-Version: 0.1.39
+Version: 0.1.57
 Summary: A lightweight, elegant blogging platform built with FastHTML
 Home-page: https://github.com/yeshwanth/bloggy
 Author: Yeshwanth
@@ -44,6 +44,15 @@ title: Bloggy - A FastHTML Blogging Platform
 
 A lightweight, elegant blogging platform built with FastHTML that renders Markdown files into beautiful web pages with advanced features.
 
+Simple Table
+
+| Feature                     | Description                                      |
+|-----------------------------|--------------------------------------------------|
+| FastHTML Integration        | Built on FastHTML for high performance and ease of use |
+| Advanced Markdown Support   | Footnotes as sidenotes, YouTube embeds, task lists, Mermaid diagrams, math notation, tabbed content, and more |
+| Modern UI                   | Responsive design, dark mode, three-panel layout, HTMX navigation |
+| Interactive Diagrams       | Zoomable, pannable Mermaid diagrams with fullscreen support |
+
 ## Architecture Overview
 
 ```mermaid
@@ -295,6 +304,7 @@ stateDiagram-v2
 - **Mermaid Frontmatter**: Configure diagram size with YAML frontmatter (width, height, min-height)
 - **Tabbed Content**: Create multi-tab sections using `:::tabs` and `::tab{title="..."}` syntax with smooth transitions
 - **Relative Links**: Full support for relative markdown links (`./file.md`, `../other.md`) with automatic path resolution
+- **Plain-Text Headings**: Inline markdown in headings is stripped for clean display and consistent anchor slugs
 - **Math Notation**: KaTeX support for inline `$E=mc^2$` and block `$$` math equations, auto-renders after HTMX swaps
 - **Superscript & Subscript**: Use `^text^` for superscript and `~text~` for subscript (preprocessed before rendering)
 - **Strikethrough**: Use `~~text~~` for strikethrough formatting
@@ -307,7 +317,9 @@ stateDiagram-v2
 - **Dark Mode**: Automatic theme switching with localStorage persistence and instant visual feedback
 - **HTMX Navigation**: Fast, SPA-like navigation without full page reloads using `hx-get`, `hx-target`, and `hx-push-url`
 - **Collapsible Folders**: Organize posts in nested directories with chevron indicators and smooth expand/collapse
+- **Sidebar Search**: HTMX-powered filename search with results shown below the search bar (tree stays intact)
 - **Auto-Generated TOC**: Table of contents automatically extracted from headings with scroll-based active highlighting
+- **TOC Autoscroll + Accurate Highlights**: Active TOC item stays in view and highlight logic handles duplicate headings
 - **Mobile Menus**: Slide-in panels for posts and TOC on mobile devices with smooth transitions
 - **Sticky Navigation**: Navbar stays at top while scrolling, with mobile menu toggles
 - **Active Link Highlighting**: Current post and TOC section highlighted with blue accents
@@ -328,8 +340,13 @@ stateDiagram-v2
 - **Performance Logging**: Debug-level logging tracks render times and bottlenecks to `/tmp/bloggy_core.log`
 - **Custom 404 Page**: Elegant error page with navigation options and helpful tips
 - **Static File Serving**: Serves images and assets from blog directories via `/posts/{path}.{ext}` routes
+- **Raw Markdown Access**: Append `.md` to any post URL (e.g. `/posts/demo.md`) to fetch source content
 - **Optional Authentication**: Session-based auth with Beforeware when username/password configured
 
+### Quick Usage Examples
+- Sidebar search: type a filename fragment like `write up` or `write-up` to filter results without collapsing the tree
+- Raw markdown: fetch a post's source via `/posts/demo.md`
+
 ## Content Writing Features
 
 ### Footnotes as Sidenotes
@@ -609,6 +626,24 @@ password = "hunter2"
 
 All settings in the `.bloggy` file are optional. The configuration is managed by the `Config` class in `bloggy/config.py`.
 
+### Custom Sidebar Ordering
+
+Place a `.bloggy` file in any folder to control the sidebar order for that folder. `.bloggy` uses TOML format. Use `order` to pin items first, then `sort` and `folders_first` for the remainder.
+
+```toml
+# Items listed in order are shown first. Use exact names (include extensions).
+order = ["todo.md", "static-build.md", "docs"]
+
+# Sorting for items not listed in order
+sort = "name_asc"          # name_asc, name_desc, mtime_asc, mtime_desc
+folders_first = true
+folders_always_first = false
+```
+
+Notes:
+- `folders_first` only affects the items not listed in `order`.
+- `folders_always_first` moves all folders to the top after ordering/sorting, while preserving their relative order.
+
 ### Environment Variables
 
 You can also use environment variables as a fallback:

{bloggy-0.1.39 → bloggy-0.1.57}/README.md

@@ -5,6 +5,15 @@ title: Bloggy - A FastHTML Blogging Platform
 
 A lightweight, elegant blogging platform built with FastHTML that renders Markdown files into beautiful web pages with advanced features.
 
+Simple Table
+
+| Feature                     | Description                                      |
+|-----------------------------|--------------------------------------------------|
+| FastHTML Integration        | Built on FastHTML for high performance and ease of use |
+| Advanced Markdown Support   | Footnotes as sidenotes, YouTube embeds, task lists, Mermaid diagrams, math notation, tabbed content, and more |
+| Modern UI                   | Responsive design, dark mode, three-panel layout, HTMX navigation |
+| Interactive Diagrams       | Zoomable, pannable Mermaid diagrams with fullscreen support |
+
 ## Architecture Overview
 
 ```mermaid
@@ -256,6 +265,7 @@ stateDiagram-v2
 - **Mermaid Frontmatter**: Configure diagram size with YAML frontmatter (width, height, min-height)
 - **Tabbed Content**: Create multi-tab sections using `:::tabs` and `::tab{title="..."}` syntax with smooth transitions
 - **Relative Links**: Full support for relative markdown links (`./file.md`, `../other.md`) with automatic path resolution
+- **Plain-Text Headings**: Inline markdown in headings is stripped for clean display and consistent anchor slugs
 - **Math Notation**: KaTeX support for inline `$E=mc^2$` and block `$$` math equations, auto-renders after HTMX swaps
 - **Superscript & Subscript**: Use `^text^` for superscript and `~text~` for subscript (preprocessed before rendering)
 - **Strikethrough**: Use `~~text~~` for strikethrough formatting
@@ -268,7 +278,9 @@ stateDiagram-v2
 - **Dark Mode**: Automatic theme switching with localStorage persistence and instant visual feedback
 - **HTMX Navigation**: Fast, SPA-like navigation without full page reloads using `hx-get`, `hx-target`, and `hx-push-url`
 - **Collapsible Folders**: Organize posts in nested directories with chevron indicators and smooth expand/collapse
+- **Sidebar Search**: HTMX-powered filename search with results shown below the search bar (tree stays intact)
 - **Auto-Generated TOC**: Table of contents automatically extracted from headings with scroll-based active highlighting
+- **TOC Autoscroll + Accurate Highlights**: Active TOC item stays in view and highlight logic handles duplicate headings
 - **Mobile Menus**: Slide-in panels for posts and TOC on mobile devices with smooth transitions
 - **Sticky Navigation**: Navbar stays at top while scrolling, with mobile menu toggles
 - **Active Link Highlighting**: Current post and TOC section highlighted with blue accents
@@ -289,8 +301,13 @@ stateDiagram-v2
 - **Performance Logging**: Debug-level logging tracks render times and bottlenecks to `/tmp/bloggy_core.log`
 - **Custom 404 Page**: Elegant error page with navigation options and helpful tips
 - **Static File Serving**: Serves images and assets from blog directories via `/posts/{path}.{ext}` routes
+- **Raw Markdown Access**: Append `.md` to any post URL (e.g. `/posts/demo.md`) to fetch source content
 - **Optional Authentication**: Session-based auth with Beforeware when username/password configured
 
+### Quick Usage Examples
+- Sidebar search: type a filename fragment like `write up` or `write-up` to filter results without collapsing the tree
+- Raw markdown: fetch a post's source via `/posts/demo.md`
+
 ## Content Writing Features
 
 ### Footnotes as Sidenotes
@@ -570,6 +587,24 @@ password = "hunter2"
 
 All settings in the `.bloggy` file are optional. The configuration is managed by the `Config` class in `bloggy/config.py`.
 
+### Custom Sidebar Ordering
+
+Place a `.bloggy` file in any folder to control the sidebar order for that folder. `.bloggy` uses TOML format. Use `order` to pin items first, then `sort` and `folders_first` for the remainder.
+
+```toml
+# Items listed in order are shown first. Use exact names (include extensions).
+order = ["todo.md", "static-build.md", "docs"]
+
+# Sorting for items not listed in order
+sort = "name_asc"          # name_asc, name_desc, mtime_asc, mtime_desc
+folders_first = true
+folders_always_first = false
+```
+
+Notes:
+- `folders_first` only affects the items not listed in `order`.
+- `folders_always_first` moves all folders to the top after ordering/sorting, while preserving their relative order.
+
 ### Environment Variables
 
 You can also use environment variables as a fallback:

{bloggy-0.1.39 → bloggy-0.1.57}/bloggy/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.1.39"
+__version__ = "0.1.57"
 
 from .core import app, rt, get_root_folder, get_blog_title
 

{bloggy-0.1.39 → bloggy-0.1.57}/bloggy/build.py

@@ -14,7 +14,8 @@ from .core import (
     parse_frontmatter, get_post_title, slug_to_title, 
     from_md, extract_toc, build_toc_items, text_to_anchor,
     build_post_tree, ContentRenderer, extract_footnotes,
-    preprocess_super_sub, preprocess_tabs
+    preprocess_super_sub, preprocess_tabs,
+    get_bloggy_config, order_bloggy_entries
 )
 from .config import get_config, reload_config
 
@@ -27,8 +28,16 @@ def generate_static_html(title, body_content, blog_title):
     <style>
         body { font-family: 'IBM Plex Sans', sans-serif; margin: 0; padding: 0; }
         code, pre { font-family: 'IBM Plex Mono', monospace; }
-        .folder-chevron { transition: transform 0.2s; display: inline-block; }
-        details[open] > summary > .folder-chevron { transform: rotate(90deg); }
+        .folder-chevron {
+            display: inline-block;
+            width: 0.45rem;
+            height: 0.45rem;
+            border-right: 2px solid rgb(148 163 184);
+            border-bottom: 2px solid rgb(148 163 184);
+            transform: rotate(-45deg);
+            transition: transform 0.2s;
+        }
+        details.is-open > summary .folder-chevron { transform: rotate(45deg); }
         details { border: none !important; box-shadow: none !important; }
         h1, h2, h3, h4, h5, h6 { scroll-margin-top: 7rem; }
         
@@ -323,8 +332,32 @@ def generate_static_html(title, body_content, blog_title):
 def build_post_tree_static(folder, root_folder):
     """Build post tree with static .html links instead of HTMX"""
     items = []
-    try: 
-        entries = sorted(folder.iterdir(), key=lambda x: (not x.is_dir(), x.name))
+    try:
+        index_file = None
+        if folder == root_folder:
+            for candidate in root_folder.iterdir():
+                if candidate.is_file() and candidate.suffix == '.md' and candidate.stem.lower() == 'index':
+                    index_file = candidate
+                    break
+            if index_file is None:
+                for candidate in root_folder.iterdir():
+                    if candidate.is_file() and candidate.suffix == '.md' and candidate.stem.lower() == 'readme':
+                        index_file = candidate
+                        break
+
+        entries = []
+        for item in folder.iterdir():
+            if item.name == ".bloggy":
+                continue
+            if item.is_dir():
+                if item.name.startswith('.'):
+                    continue
+                entries.append(item)
+            elif item.suffix == '.md':
+                if index_file and item.resolve() == index_file.resolve():
+                    continue
+                entries.append(item)
+        entries = order_bloggy_entries(entries, get_bloggy_config(folder))
     except (OSError, PermissionError): 
         return items
     
@@ -337,18 +370,13 @@ def build_post_tree_static(folder, root_folder):
                 folder_title = slug_to_title(item.name)
                 items.append(Li(Details(
                     Summary(
-                        Span(UkIcon("chevron-right", cls="folder-chevron w-4 h-4 text-slate-400"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
+                        Span(Span(cls="folder-chevron"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
                         Span(UkIcon("folder", cls="text-blue-500 w-4 h-4"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
                         Span(folder_title, cls="truncate min-w-0", title=folder_title),
                         cls="flex items-center font-medium cursor-pointer py-1 px-2 hover:text-blue-600 select-none list-none rounded hover:bg-slate-100 dark:hover:bg-slate-800 transition-colors min-w-0"),
-                    Ul(*sub_items, cls="ml-2 pl-2 space-y-1 border-l border-slate-100 dark:border-slate-800"), open=False), cls="my-1"))
+                    Ul(*sub_items, cls="ml-4 pl-2 space-y-1 border-l border-slate-100 dark:border-slate-800"),
+                    data_folder="true"), cls="my-1"))
         elif item.suffix == '.md':
-            # Skip the file being used for home page
-            if item.parent == root_folder:
-                # Check if this is index.md or readme.md (case insensitive)
-                if item.stem.lower() in ['index', 'readme']:
-                    continue
-            
             slug = str(item.relative_to(root_folder).with_suffix(''))
             title = get_post_title(item)
             

{bloggy-0.1.39 → bloggy-0.1.57}/bloggy/config.py

@@ -112,6 +112,14 @@ class BloggyConfig:
         user = self.get('username', 'BLOGGY_USER', None)
         pwd = self.get('password', 'BLOGGY_PASSWORD', None)
         return user, pwd
+    
+    def get_sidebars_open(self) -> bool:
+        """Get whether sidebars should be open by default."""
+        value = self.get('sidebars_open', 'BLOGGY_SIDEBARS_OPEN', True)
+        # Handle string values from environment variables
+        if isinstance(value, str):
+            return value.lower() in ('true', '1', 'yes', 'on')
+        return bool(value)
 
 
 

{bloggy-0.1.39 → bloggy-0.1.57}/bloggy/core.py

@@ -1,4 +1,4 @@
-import re, frontmatter, mistletoe as mst, pathlib, os
+import re, frontmatter, mistletoe as mst, pathlib, os, tomllib
 from functools import partial
 from functools import lru_cache
 from pathlib import Path
@@ -22,9 +22,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 = {}
@@ -62,6 +88,151 @@ def get_post_title(file_path):
     metadata, _ = parse_frontmatter(file_path)
     return metadata.get('title', slug_to_title(file_path.stem))
 
+@lru_cache(maxsize=128)
+def _cached_bloggy_config(path_str, mtime):
+    path = Path(path_str)
+    try:
+        with path.open("rb") as f:
+            return tomllib.load(f)
+    except Exception:
+        return {}
+
+def _normalize_bloggy_config(parsed):
+    config = {
+        "order": [],
+        "sort": "name_asc",
+        "folders_first": True,
+        "folders_always_first": False,
+    }
+    if not isinstance(parsed, dict):
+        return config
+
+    order = parsed.get("order")
+    if order is not None:
+        if isinstance(order, (list, tuple)):
+            config["order"] = [str(item).strip() for item in order if str(item).strip()]
+        else:
+            config["order"] = []
+
+    sort = parsed.get("sort")
+    if isinstance(sort, str) and sort in ("name_asc", "name_desc", "mtime_asc", "mtime_desc"):
+        config["sort"] = sort
+
+    folders_first = parsed.get("folders_first")
+    if isinstance(folders_first, bool):
+        config["folders_first"] = folders_first
+    elif isinstance(folders_first, str):
+        lowered = folders_first.lower()
+        if lowered in ("true", "false"):
+            config["folders_first"] = lowered == "true"
+
+    folders_always_first = parsed.get("folders_always_first")
+    if isinstance(folders_always_first, bool):
+        config["folders_always_first"] = folders_always_first
+    elif isinstance(folders_always_first, str):
+        lowered = folders_always_first.lower()
+        if lowered in ("true", "false"):
+            config["folders_always_first"] = lowered == "true"
+
+    return config
+
+def get_bloggy_config(folder):
+    bloggy_path = folder / ".bloggy"
+    if not bloggy_path.exists():
+        return _normalize_bloggy_config({})
+    try:
+        mtime = bloggy_path.stat().st_mtime
+    except OSError:
+        return _normalize_bloggy_config({})
+    parsed = _cached_bloggy_config(str(bloggy_path), mtime)
+    config = _normalize_bloggy_config(parsed)
+    logger.debug(
+        "[DEBUG] .bloggy config for %s: order=%s sort=%s folders_first=%s",
+        folder,
+        config.get("order"),
+        config.get("sort"),
+        config.get("folders_first"),
+    )
+    return config
+
+def order_bloggy_entries(entries, config):
+    if not entries:
+        return []
+
+    order_list = [name.strip().rstrip("/") for name in config.get("order", []) if str(name).strip()]
+    if not order_list:
+        sorted_entries = _sort_bloggy_entries(entries, config.get("sort"), config.get("folders_first", True))
+        if config.get("folders_always_first"):
+            sorted_entries = _group_folders_first(sorted_entries)
+        logger.debug(
+            "[DEBUG] .bloggy order empty; sorted entries: %s",
+            [item.name for item in sorted_entries],
+        )
+        return sorted_entries
+
+    exact_map = {}
+    stem_map = {}
+    for item in entries:
+        exact_map.setdefault(item.name, item)
+        if item.suffix == ".md":
+            stem_map.setdefault(item.stem, item)
+
+    ordered = []
+    used = set()
+    for name in order_list:
+        if name in exact_map:
+            item = exact_map[name]
+        elif name in stem_map:
+            item = stem_map[name]
+        else:
+            item = None
+        if item and item not in used:
+            ordered.append(item)
+            used.add(item)
+
+    remaining = [item for item in entries if item not in used]
+    remaining_sorted = _sort_bloggy_entries(
+        remaining,
+        config.get("sort"),
+        config.get("folders_first", True)
+    )
+    combined = ordered + remaining_sorted
+    if config.get("folders_always_first"):
+        combined = _group_folders_first(combined)
+    logger.debug(
+        "[DEBUG] .bloggy ordered=%s remaining=%s",
+        [item.name for item in ordered],
+        [item.name for item in remaining_sorted],
+    )
+    return combined
+
+def _group_folders_first(entries):
+    folders = [item for item in entries if item.is_dir()]
+    files = [item for item in entries if not item.is_dir()]
+    return folders + files
+
+def _sort_bloggy_entries(entries, sort_method, folders_first):
+    method = sort_method or "name_asc"
+    reverse = method.endswith("desc")
+    by_mtime = method.startswith("mtime")
+
+    def sort_key(item):
+        if by_mtime:
+            try:
+                return item.stat().st_mtime
+            except OSError:
+                return 0
+        return item.name.lower()
+
+    if folders_first:
+        folders = [item for item in entries if item.is_dir()]
+        files = [item for item in entries if not item.is_dir()]
+        folders_sorted = sorted(folders, key=sort_key, reverse=reverse)
+        files_sorted = sorted(files, key=sort_key, reverse=reverse)
+        return folders_sorted + files_sorted
+
+    return sorted(entries, key=sort_key, reverse=reverse)
+
 # Markdown rendering setup
 try: FrankenRenderer
 except NameError:
@@ -197,6 +368,7 @@ 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 = {}
     
     def render_list_item(self, token):
         """Render list items with task list checkbox support"""
@@ -264,10 +436,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"""
@@ -521,7 +695,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:
@@ -646,7 +821,7 @@ hdrs = (
     Link(rel="preconnect", href="https://fonts.gstatic.com", crossorigin=""),
     Link(rel="stylesheet", href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=IBM+Plex+Mono&display=swap"),
     Style("body { font-family: 'IBM Plex Sans', sans-serif; } code, pre { font-family: 'IBM Plex Mono', monospace; }"),
-    Style(".folder-chevron { transition: transform 0.2s; display: inline-block; } details[open] > summary > .folder-chevron { transform: rotate(90deg); } details { border: none !important; box-shadow: none !important; }"),
+    Style(".folder-chevron { display: inline-block; width: 0.45rem; height: 0.45rem; border-right: 2px solid rgb(148 163 184); border-bottom: 2px solid rgb(148 163 184); transform: rotate(-45deg); transition: transform 0.2s; } details.is-open > summary .folder-chevron { transform: rotate(45deg); } details { border: none !important; box-shadow: none !important; }"),
     Style("h1, h2, h3, h4, h5, h6 { scroll-margin-top: 7rem; }"),  # Offset for sticky navbar
     Style("""
         /* Ultra thin scrollbar styles */
@@ -658,6 +833,15 @@ hdrs = (
         .dark *::-webkit-scrollbar-thumb { background-color: rgb(71 85 105); }
         .dark *::-webkit-scrollbar-thumb:hover { background-color: rgb(100 116 139); }
         .dark * { scrollbar-color: rgb(71 85 105) transparent; }
+
+        /* Sidebar active link highlight */
+        .sidebar-highlight {
+            box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.35);
+            transition: box-shadow 10s ease, background-color 10s ease;
+        }
+        .sidebar-highlight.fade-out {
+            box-shadow: 0 0 0 2px rgba(59, 130, 246, 0);
+        }
         
         /* Tabs styles */
         .tabs-container { 
@@ -764,6 +948,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 () {
@@ -867,6 +1088,15 @@ def posts_sidebar_lazy():
         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)
+
 # 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):
@@ -933,41 +1163,152 @@ 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 _search_post_files(query, limit=40):
+    query = _normalize_search_text(query)
+    if not query:
+        return []
+    root = get_root_folder()
+    index_file = find_index_file()
+    results = []
+    for item in root.rglob("*.md"):
+        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("")
+        haystack = _normalize_search_text(f"{item.name} {rel.as_posix()}")
+        if query in haystack:
+            results.append(item)
+            if len(results) >= limit:
+                break
+    return results
+
+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 = _search_post_files(trimmed)
+    if not matches:
+        return Ul(
+            Li(f'No matches for "{trimmed}".', cls="text-xs 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"
+        )
+
+    root = get_root_folder()
+    items = []
+    for item in matches:
+        slug = str(item.relative_to(root).with_suffix(""))
+        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"
+            )
+        ))
+    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(
+        Input(
+            type="search",
+            name="q",
+            placeholder="Search file names…",
+            autocomplete="off",
+            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"
+        ),
+        Div(
+            _render_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 backdrop-blur-lg shadow-[0_24px_60px_-40px_rgba(15,23,42,0.45)] dark:shadow-[0_28px_70px_-45px_rgba(2,6,23,0.85)]"
+    )
+
 @lru_cache(maxsize=1)
 def _cached_posts_sidebar_html(fingerprint):
+    sidebars_open = get_config().get_sidebars_open()
     sidebar = collapsible_sidebar(
         "menu",
         "Posts",
         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")
+        ],
+        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 = [
-        UkIcon(icon, cls="w-5 h-5 mr-2"),
-        Span(title, cls="flex-1")
+        Span(
+            UkIcon(icon, cls="w-5 h-5 block"),
+            cls="flex items-center justify-center w-5 h-5 shrink-0 leading-none"
+        ),
+        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/10 dark:bg-slate-950/70 backdrop-blur-lg border border-slate-900/20 dark:border-slate-700/20 shadow-lg"
-    summary_classes = f"flex items-center font-semibold cursor-pointer py-2 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 border border-black dark:border-black overflow-y-auto max-h-[calc(100vh-18rem)]"
+    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]"
+    if scroll_target == "list":
+        content_classes = f"p-3 {common_frost_style} rounded-lg max-h-[calc(100vh-18rem)] flex flex-col gap-4 overflow-hidden min-h-0"
+        list_classes = "list-none pt-4 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
@@ -983,11 +1324,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
 
@@ -1063,13 +1406,14 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
             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 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(),
+                collapsible_sidebar("list", "Contents", toc_items, is_open=sidebars_open, shortcut_key="X") if toc_items else Div(),
                 **toc_attrs
             )
 
@@ -1116,12 +1460,13 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
         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 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(),
+            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)
@@ -1163,7 +1508,7 @@ def layout(*content, htmx, title=None, show_sidebar=False, toc_content=None, cur
                 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")),
+                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",
@@ -1231,8 +1576,28 @@ def build_post_tree(folder):
     start_time = time.time()
     root = get_root_folder()
     items = []
-    try: 
-        entries = sorted(folder.iterdir(), key=lambda x: (not x.is_dir(), x.name))
+    try:
+        index_file = find_index_file() if folder == root else None
+        entries = []
+        for item in folder.iterdir():
+            if item.name == ".bloggy":
+                continue
+            if item.is_dir():
+                if item.name.startswith('.'):
+                    continue
+                entries.append(item)
+            elif item.suffix == '.md':
+                # 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
+                entries.append(item)
+        config = get_bloggy_config(folder)
+        entries = order_bloggy_entries(entries, config)
+        logger.debug(
+            "[DEBUG] build_post_tree entries for %s: %s",
+            folder,
+            [item.name for item in entries],
+        )
         logger.debug(f"[DEBUG] Scanning directory: {folder.relative_to(root) if folder != root else '.'} - found {len(entries)} entries")
     except (OSError, PermissionError): 
         return items
@@ -1245,18 +1610,13 @@ def build_post_tree(folder):
                 folder_title = slug_to_title(item.name)
                 items.append(Li(Details(
                     Summary(
-                        Span(UkIcon("chevron-right", cls="folder-chevron w-4 h-4 text-slate-400"), cls="w-4 mr-1 flex items-center justify-center shrink-0"),
-                        Span(UkIcon("folder", cls="text-blue-500 w-4 h-4"), cls="w-4 mr-1 flex items-center justify-center shrink-0"),
+                        Span(Span(cls="folder-chevron"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
+                        Span(UkIcon("folder", cls="text-blue-500 w-4 h-4"), cls="w-4 mr-2 flex items-center justify-center shrink-0"),
                         Span(folder_title, cls="truncate min-w-0", title=folder_title),
                         cls="flex items-center font-medium cursor-pointer py-1 px-2 hover:text-blue-600 select-none list-none rounded hover:bg-slate-100 dark:hover:bg-slate-800 transition-colors min-w-0"),
-                    Ul(*sub_items, cls="ml-2 pl-2 space-y-1 border-l border-slate-100 dark:border-slate-800"), open=False), cls="my-1"))
+                    Ul(*sub_items, cls="ml-4 pl-2 space-y-1 border-l border-slate-100 dark:border-slate-800"),
+                    data_folder="true"), cls="my-1"))
         elif item.suffix == '.md':
-            # Skip the file being used for home page (index.md takes precedence over readme.md)
-            if item.parent == root:
-                index_file = find_index_file()
-                if index_file and item.resolve() == index_file.resolve():
-                    continue
-            
             slug = str(item.relative_to(root).with_suffix(''))
             title_start = time.time()
             title = get_post_title(item)
@@ -1279,7 +1639,9 @@ def build_post_tree(folder):
 def _posts_tree_fingerprint():
     root = get_root_folder()
     try:
-        return max((p.stat().st_mtime for p in root.rglob("*.md")), default=0)
+        md_mtime = max((p.stat().st_mtime for p in root.rglob("*.md")), default=0)
+        bloggy_mtime = max((p.stat().st_mtime for p in root.rglob(".bloggy")), default=0)
+        return max(md_mtime, bloggy_mtime)
     except Exception:
         return 0
 

{bloggy-0.1.39 → bloggy-0.1.57}/bloggy/main.py

@@ -89,8 +89,20 @@ def cli():
     print(f"Serving at: http://{host}:{port}")
     if host == '0.0.0.0':
         print(f"Server accessible from network at: http://<your-ip>:{port}")
+    
+    # Configure reload to watch markdown files in the blog directory
+    reload_kwargs = {}
+    if reload:
+        blog_root = config.get_root_folder()
+        reload_kwargs = {
+            "reload": True,
+            "reload_dirs": [str(blog_root)],
+            "reload_includes": ["*.md"]
+        }
+    else:
+        reload_kwargs = {"reload": False}
 
-    uvicorn.run("bloggy.main:app", host=host, port=port, reload=reload)
+    uvicorn.run("bloggy.main:app", host=host, port=port, **reload_kwargs)
 
 if __name__ == "__main__":
     cli()

{bloggy-0.1.39 → bloggy-0.1.57}/bloggy/static/scripts.js

@@ -346,7 +346,8 @@ function revealInSidebar(rootElement = document) {
         return;
     }
 
-    const currentPath = window.location.pathname.replace(/^\/posts\//, '');
+    // Decode the URL path to handle special characters and spaces
+    const currentPath = decodeURIComponent(window.location.pathname.replace(/^\/posts\//, ''));
     const activeLink = rootElement.querySelector(`.post-link[data-path="${currentPath}"]`);
     
     if (activeLink) {
@@ -375,20 +376,33 @@ function revealInSidebar(rootElement = document) {
         }
         
         // Highlight the active link temporarily
-        activeLink.classList.add('ring-2', 'ring-blue-500', 'ring-offset-2');
-        setTimeout(() => {
-            activeLink.classList.remove('ring-2', 'ring-blue-500', 'ring-offset-2');
-        }, 1500);
+        activeLink.classList.remove('fade-out');
+        activeLink.classList.add('sidebar-highlight');
+        requestAnimationFrame(() => {
+            setTimeout(() => {
+                activeLink.classList.add('fade-out');
+                setTimeout(() => {
+                    activeLink.classList.remove('sidebar-highlight', 'fade-out');
+                }, 10000);
+            }, 1000);
+        });
     }
 }
 
 function initPostsSidebarAutoReveal() {
     const postSidebars = document.querySelectorAll('details[data-sidebar="posts"]');
+    
     postSidebars.forEach((sidebar) => {
         if (sidebar.dataset.revealBound === 'true') {
             return;
         }
         sidebar.dataset.revealBound = 'true';
+        
+        // Reveal immediately if sidebar is already open
+        if (sidebar.open) {
+            revealInSidebar(sidebar);
+        }
+        
         sidebar.addEventListener('toggle', () => {
             if (!sidebar.open) {
                 return;
@@ -398,6 +412,23 @@ function initPostsSidebarAutoReveal() {
     });
 }
 
+function initFolderChevronState(rootElement = document) {
+    rootElement.querySelectorAll('details[data-folder="true"]').forEach((details) => {
+        details.classList.toggle('is-open', details.open);
+    });
+}
+
+document.addEventListener('toggle', (event) => {
+    const details = event.target;
+    if (!(details instanceof HTMLDetailsElement)) {
+        return;
+    }
+    if (!details.matches('details[data-folder="true"]')) {
+        return;
+    }
+    details.classList.toggle('is-open', details.open);
+}, true);
+
 // Update active post link in sidebar
 function updateActivePostLink() {
     const currentPath = window.location.pathname.replace(/^\/posts\//, '');
@@ -414,17 +445,27 @@ function updateActivePostLink() {
 }
 
 // Update active TOC link based on scroll position
+let lastActiveTocAnchor = null;
 function updateActiveTocLink() {
     const headings = document.querySelectorAll('h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]');
     const tocLinks = document.querySelectorAll('.toc-link');
     
     let activeHeading = null;
+    let nearestBelow = null;
+    let nearestBelowTop = Infinity;
+    const offset = 140;
     headings.forEach(heading => {
         const rect = heading.getBoundingClientRect();
-        if (rect.top <= 100) {
+        if (rect.top <= offset) {
             activeHeading = heading;
+        } else if (rect.top < nearestBelowTop) {
+            nearestBelowTop = rect.top;
+            nearestBelow = heading;
         }
     });
+    if (!activeHeading && nearestBelow) {
+        activeHeading = nearestBelow;
+    }
     
     tocLinks.forEach(link => {
         const anchor = link.getAttribute('data-anchor');
@@ -434,6 +475,14 @@ function updateActiveTocLink() {
             link.classList.remove('bg-blue-50', 'dark:bg-blue-900/20', 'text-blue-600', 'dark:text-blue-400', 'font-semibold');
         }
     });
+
+    const activeId = activeHeading ? activeHeading.id : null;
+    if (activeId && activeId !== lastActiveTocAnchor) {
+        document.querySelectorAll(`.toc-link[data-anchor="${activeId}"]`).forEach(link => {
+            link.scrollIntoView({ block: 'nearest' });
+        });
+        lastActiveTocAnchor = activeId;
+    }
 }
 
 // Listen for scroll events to update active TOC link
@@ -448,8 +497,50 @@ window.addEventListener('scroll', () => {
     }
 });
 
+// Sync TOC highlight on hash changes and TOC clicks
+window.addEventListener('hashchange', () => {
+    requestAnimationFrame(updateActiveTocLink);
+});
+
+document.addEventListener('click', (event) => {
+    const link = event.target.closest('.toc-link');
+    if (!link) {
+        return;
+    }
+    const anchor = link.getAttribute('data-anchor');
+    if (!anchor) {
+        return;
+    }
+    requestAnimationFrame(() => {
+        document.querySelectorAll('.toc-link').forEach(item => {
+            item.classList.toggle(
+                'bg-blue-50',
+                item.getAttribute('data-anchor') === anchor
+            );
+            item.classList.toggle(
+                'dark:bg-blue-900/20',
+                item.getAttribute('data-anchor') === anchor
+            );
+            item.classList.toggle(
+                'text-blue-600',
+                item.getAttribute('data-anchor') === anchor
+            );
+            item.classList.toggle(
+                'dark:text-blue-400',
+                item.getAttribute('data-anchor') === anchor
+            );
+            item.classList.toggle(
+                'font-semibold',
+                item.getAttribute('data-anchor') === anchor
+            );
+        });
+        lastActiveTocAnchor = anchor;
+        updateActiveTocLink();
+    });
+});
+
 // Re-run mermaid on HTMX content swaps
-document.body.addEventListener('htmx:afterSwap', function() {
+document.body.addEventListener('htmx:afterSwap', function(event) {
     mermaid.run().then(() => {
         setTimeout(initMermaidInteraction, 100);
     });
@@ -457,6 +548,7 @@ document.body.addEventListener('htmx:afterSwap', function() {
     updateActiveTocLink();
     initMobileMenus(); // Reinitialize mobile menu handlers
     initPostsSidebarAutoReveal();
+    initFolderChevronState();
 });
 
 // Watch for theme changes and re-render mermaid diagrams
@@ -556,10 +648,44 @@ function initMobileMenus() {
     }
 }
 
+// Keyboard shortcuts for toggling sidebars
+function initKeyboardShortcuts() {
+    // Prewarm the selectors to avoid lazy compilation delays
+    const postsSidebars = document.querySelectorAll('details[data-sidebar="posts"]');
+    const tocSidebar = document.querySelector('#toc-sidebar details');
+    
+    document.addEventListener('keydown', (e) => {
+        // Skip if user is typing in an input field
+        if (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA' || e.target.isContentEditable) {
+            return;
+        }
+        
+        // Z: Toggle posts panel
+        if (e.key === 'z' || e.key === 'Z') {
+            e.preventDefault();
+            const postsSidebars = document.querySelectorAll('details[data-sidebar="posts"]');
+            postsSidebars.forEach(sidebar => {
+                sidebar.open = !sidebar.open;
+            });
+        }
+        
+        // X: Toggle TOC panel
+        if (e.key === 'x' || e.key === 'X') {
+            e.preventDefault();
+            const tocSidebar = document.querySelector('#toc-sidebar details');
+            if (tocSidebar) {
+                tocSidebar.open = !tocSidebar.open;
+            }
+        }
+    });
+}
+
 // Initialize on page load
 document.addEventListener('DOMContentLoaded', () => {
     updateActivePostLink();
     updateActiveTocLink();
     initMobileMenus();
     initPostsSidebarAutoReveal();
+    initFolderChevronState();
+    initKeyboardShortcuts();
 });

{bloggy-0.1.39 → bloggy-0.1.57/bloggy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bloggy
-Version: 0.1.39
+Version: 0.1.57
 Summary: A lightweight, elegant blogging platform built with FastHTML
 Home-page: https://github.com/yeshwanth/bloggy
 Author: Yeshwanth
@@ -44,6 +44,15 @@ title: Bloggy - A FastHTML Blogging Platform
 
 A lightweight, elegant blogging platform built with FastHTML that renders Markdown files into beautiful web pages with advanced features.
 
+Simple Table
+
+| Feature                     | Description                                      |
+|-----------------------------|--------------------------------------------------|
+| FastHTML Integration        | Built on FastHTML for high performance and ease of use |
+| Advanced Markdown Support   | Footnotes as sidenotes, YouTube embeds, task lists, Mermaid diagrams, math notation, tabbed content, and more |
+| Modern UI                   | Responsive design, dark mode, three-panel layout, HTMX navigation |
+| Interactive Diagrams       | Zoomable, pannable Mermaid diagrams with fullscreen support |
+
 ## Architecture Overview
 
 ```mermaid
@@ -295,6 +304,7 @@ stateDiagram-v2
 - **Mermaid Frontmatter**: Configure diagram size with YAML frontmatter (width, height, min-height)
 - **Tabbed Content**: Create multi-tab sections using `:::tabs` and `::tab{title="..."}` syntax with smooth transitions
 - **Relative Links**: Full support for relative markdown links (`./file.md`, `../other.md`) with automatic path resolution
+- **Plain-Text Headings**: Inline markdown in headings is stripped for clean display and consistent anchor slugs
 - **Math Notation**: KaTeX support for inline `$E=mc^2$` and block `$$` math equations, auto-renders after HTMX swaps
 - **Superscript & Subscript**: Use `^text^` for superscript and `~text~` for subscript (preprocessed before rendering)
 - **Strikethrough**: Use `~~text~~` for strikethrough formatting
@@ -307,7 +317,9 @@ stateDiagram-v2
 - **Dark Mode**: Automatic theme switching with localStorage persistence and instant visual feedback
 - **HTMX Navigation**: Fast, SPA-like navigation without full page reloads using `hx-get`, `hx-target`, and `hx-push-url`
 - **Collapsible Folders**: Organize posts in nested directories with chevron indicators and smooth expand/collapse
+- **Sidebar Search**: HTMX-powered filename search with results shown below the search bar (tree stays intact)
 - **Auto-Generated TOC**: Table of contents automatically extracted from headings with scroll-based active highlighting
+- **TOC Autoscroll + Accurate Highlights**: Active TOC item stays in view and highlight logic handles duplicate headings
 - **Mobile Menus**: Slide-in panels for posts and TOC on mobile devices with smooth transitions
 - **Sticky Navigation**: Navbar stays at top while scrolling, with mobile menu toggles
 - **Active Link Highlighting**: Current post and TOC section highlighted with blue accents
@@ -328,8 +340,13 @@ stateDiagram-v2
 - **Performance Logging**: Debug-level logging tracks render times and bottlenecks to `/tmp/bloggy_core.log`
 - **Custom 404 Page**: Elegant error page with navigation options and helpful tips
 - **Static File Serving**: Serves images and assets from blog directories via `/posts/{path}.{ext}` routes
+- **Raw Markdown Access**: Append `.md` to any post URL (e.g. `/posts/demo.md`) to fetch source content
 - **Optional Authentication**: Session-based auth with Beforeware when username/password configured
 
+### Quick Usage Examples
+- Sidebar search: type a filename fragment like `write up` or `write-up` to filter results without collapsing the tree
+- Raw markdown: fetch a post's source via `/posts/demo.md`
+
 ## Content Writing Features
 
 ### Footnotes as Sidenotes
@@ -609,6 +626,24 @@ password = "hunter2"
 
 All settings in the `.bloggy` file are optional. The configuration is managed by the `Config` class in `bloggy/config.py`.
 
+### Custom Sidebar Ordering
+
+Place a `.bloggy` file in any folder to control the sidebar order for that folder. `.bloggy` uses TOML format. Use `order` to pin items first, then `sort` and `folders_first` for the remainder.
+
+```toml
+# Items listed in order are shown first. Use exact names (include extensions).
+order = ["todo.md", "static-build.md", "docs"]
+
+# Sorting for items not listed in order
+sort = "name_asc"          # name_asc, name_desc, mtime_asc, mtime_desc
+folders_first = true
+folders_always_first = false
+```
+
+Notes:
+- `folders_first` only affects the items not listed in `order`.
+- `folders_always_first` moves all folders to the top after ordering/sorting, while preserving their relative order.
+
 ### Environment Variables
 
 You can also use environment variables as a fallback:

{bloggy-0.1.39 → bloggy-0.1.57}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bloggy"
-version = "0.1.39"
+version = "0.1.57"
 description = "A lightweight, elegant blogging platform built with FastHTML"
 readme = "README.md"
 requires-python = ">=3.9"

{bloggy-0.1.39 → bloggy-0.1.57}/settings.ini

@@ -1,6 +1,6 @@
 [DEFAULT]
 lib_name = bloggy
-version = 0.1.39
+version = 0.1.57
 min_python = 3.9
 license = apache2
 status = 4