labbdocs 0.4.0__tar.gz → 0.4.2__tar.gz

{labbdocs-0.4.0 → labbdocs-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labbdocs
-Version: 0.4.0
+Version: 0.4.2
 Summary: Documentation for the labb project
 License: MIT
 License-File: LICENSE

{labbdocs-0.4.0 → labbdocs-0.4.2}/labbdocs/content/blog/index.md

@@ -19,8 +19,9 @@ doc_hide_drawer: true
       <c-lbdocs.doc_card
         title="{{ post.title }}"
         summary="{{ post.description }}"
-        href="{{ post.url_path }}"
-        icon="rmx.article"
+        href="{% if post.is_external %}{{ post.external_url }}{% else %}{{ post.url_path }}{% endif %}"
+        {% if post.is_external %}external="1"{% endif %}
+        icon="{{ post.card_icon }}"
       />
     {% endfor %}
   </c-lbdocs.doc_card.grid>

labbdocs-0.4.2/labbdocs/content/blog/posts/2_labb-featured-on-youtube.md

@@ -0,0 +1,19 @@
+---
+title: labb featured on BugBytes
+description: "labb featured on BugBytes — django-cotton, Tailwind CSS, and daisyUI for Django."
+published_time: 2026-05-10
+modified_time: 2026-05-10
+author: zadiq
+doc_layout: blog
+doc_show_toc: false
+external_url: "https://www.youtube.com/watch?v=ZZd7cvbJ-1w"
+card_icon: "rmx.youtube"
+tags:
+  - external
+  - django
+  - community
+  - bugbytes
+keywords: "labb django, BugBytes labb, django ui components, django-cotton, labb.io, Django component library"
+---
+
+Check out the [BugBytes overview of labb](https://www.youtube.com/watch?v=ZZd7cvbJ-1w).

{labbdocs-0.4.0 → labbdocs-0.4.2}/labbdocs/templates/cotton/lbdocs/doc_card/index.html

@@ -5,9 +5,14 @@
     variant=""
     icon=""
     class=""
+    external=""
 />
 
-<a href="{{ href }}" class="block no-underline hover:no-underline {{ class }} group">
+<a
+    href="{{ href }}"
+    class="block no-underline hover:no-underline {{ class }} group"
+    {% if external %}target="_blank" rel="noopener noreferrer"{% endif %}
+>
     <c-lb.card
         class="h-full transition-all duration-300 ease-out hover:shadow-2xl hover:shadow-primary/10 cursor-pointer border-2 border-base-300/50 hover:border-primary/70 bg-gradient-to-br from-base-100 to-base-200/30 hover:from-primary/5 hover:to-primary/10 backdrop-blur-sm overflow-hidden relative"
         variant="{{ variant }}"

labbdocs-0.4.2/labbdocs/templates/cotton/lbdocs/nav/topnav.html

@@ -0,0 +1,148 @@
+{% load lb_tags %}
+{% load static %}
+
+<c-vars
+    topnavTitle
+    showDrawerToggle
+    :themeOptions="{
+        '__system__': 'System',
+        'labb-light': 'Light',
+        'labb-dark': 'Dark',
+        'light': 'Daisy Light',
+        'dark': 'Daisy Dark'
+    }"
+/>
+
+{% labb_theme_val as theme %}
+
+<div class="fixed top-0 inset-x-0 z-50 bg-base-100 py-1">
+    <div class="flex justify-center">
+        <c-labbio.section.press_callout/>
+    </div>
+
+    <c-lb.navbar>
+        <c-lb.navbar.start class="flex items-center gap-2 lg:w-full">
+            {% if showDrawerToggle %}
+                <c-lb.drawer.toggle for="docs-drawer" class="btn btn-ghost btn-sm btn-square lg:hidden">
+                    <c-lbi.rmx.menu-4 w="1.75em" h="1.75em" />
+                </c-lb.drawer.toggle>
+            {% endif %}
+            <a class="text-2xl font-bold tracking-widest flex items-center" href="{% url 'index' %}">
+                <c-lbdocs.ui.logo height="26" />
+            </a>
+
+            {% comment %} Desktop menu {% endcomment %}
+            <c-lb.menu direction="horizontal" class="items-center gap-2 lg:flex hidden">
+                <c-lb.menu.item title="guide" href="{% url 'guide_docs' %}" />
+                <c-lb.menu.item title="ui" href="{% url 'ui_docs' %}" />
+                <c-lb.menu.item title="charts" href="{% doc_url '8_charts/0_charts.md' 'ui' %}" />
+                <c-lb.menu.item title="icons" href="{% url 'icons_docs' %}" />
+                <c-lb.menu.item title="blog" href="{% url 'blog_docs' %}" />
+                {% comment %}
+                <li>
+                    <c-lb.dropdown alignment="start" size="sm">
+                        <c-lb.dropdown.trigger class="flex items-center gap-1" style="cursor: pointer; text-decoration: none; color: inherit;">
+                            community
+                        </c-lb.dropdown.trigger>
+                        <c-lb.dropdown.content class="bg-base-100 rounded-box w-52 shadow-md border border-base-200">
+                            <c-lb.menu direction="vertical" class="w-full -pl-2">
+                                <c-lb.menu.item class="pr-2" href="{% url 'blog_docs' %}" title="blog" />
+                                <c-lb.menu.item class="pr-2" href="https://github.com/labbhq/labb" target="_blank" title="github" />
+                            </c-lb.menu>
+                        </c-lb.dropdown.content>
+                    </c-lb.dropdown>
+                </li>
+                {% endcomment %}
+            </c-lb.menu>
+
+        </c-lb.navbar.start>
+
+        <c-lb.navbar.center>
+            {% comment %} Mobile menu {% endcomment %}
+            <c-lb.dropdown alignment="center" size="sm" class="lg:hidden">
+                <c-lb.dropdown.trigger class="btn btn-ghost text-base-content/50">
+                    <span class="tracking-widest lg:hidden lowercase">{{topnavTitle|default:"Explore"}}</span>
+                    <c-lbi.rmx.arrow-down-s w="1em" h="1em" />
+                </c-lb.dropdown.trigger>
+                <c-lb.dropdown.content class="bg-base-100 rounded-box w-52 shadow-md border border-base-200">
+                    <c-lb.menu class="w-full">
+                        <c-lb.menu.item title="guide" href="{% url 'guide_docs' %}" />
+                        <c-lb.menu.item title="ui" href="{% url 'ui_docs' %}" />
+                        <c-lb.menu.item title="charts" href="{% doc_url '8_charts/0_charts.md' 'ui' %}" />
+                        <c-lb.menu.item title="icons" href="{% url 'icons_docs' %}" />
+                        <c-lb.menu.item title="blog" href="{% url 'blog_docs' %}" />
+                        {% comment %} <c-lb.menu.item type="submenu-details" title="community" open>
+                            <c-lb.menu.item href="{% url 'blog_docs' %}" title="blog" />
+                            <c-lb.menu.item href="https://github.com/labbhq/labb" target="_blank" title="github" />
+                        </c-lb.menu.item> {% endcomment %}
+                    </c-lb.menu>
+                </c-lb.dropdown.content>
+            </c-lb.dropdown>
+        </c-lb.navbar.center>
+
+        <c-lb.navbar.end class="flex items-center gap-2">
+            <c-lb.button size="sm" btnStyle="ghost" icon="rmx.search" onclick="search_modal.showModal()">
+                Search
+            </c-lb.button>
+            <c-lb.dropdown alignment="end" size="sm">
+                <c-lb.dropdown.trigger class="btn btn-sm btn-ghost btn-circle">
+                    <c-lbi.rmx.sun w="1.25em" h="1.25em" />
+                </c-lb.dropdown.trigger>
+                <c-lb.dropdown.content class="bg-base-100 rounded-box w-52 shadow-md border border-base-200">
+                    <c-lb.menu class="w-full">
+                        {% for key, value in themeOptions.items %}
+                            <input
+                                type="radio"
+                                name="doc-theme"
+                                value="{{key}}"
+                                class="theme-controller btn btn-ghost btn-sm justify-start"
+                                aria-label="{{value}}"
+                                {% if key == theme %}checked{% endif %}
+                            />
+                        {% endfor %}
+                    </c-lb.menu>
+                </c-lb.dropdown.content>
+            </c-lb.dropdown>
+            <c-lb.button as="a" href="https://github.com/labbhq/labb" target="_blank" size="sm" btnStyle="ghost" modifier="circle" class="hidden lg:flex">
+                <c-lbi n="rmx.github" w="1.25em" h="1.25em" />
+            </c-lb.button>
+        </c-lb.navbar.end>
+    </c-lb.navbar>
+</div>
+<c-lb.modal id="search_modal" withBackdrop boxClass="border border-base-200 shadow">
+    <h3 class="text-lg font-bold">Search</h3>
+    <p class="py-4">Search features are coming soon!</p>
+    <c-lb.modal.action>
+        <form method="dialog">
+            <c-lb.button>Close</c-lb.button>
+        </form>
+    </c-lb.modal.action>
+</c-lb.modal>
+
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    const currentTheme = "{{ theme }}";
+    const themeInputs = document.querySelectorAll('input[name="doc-theme"].theme-controller');
+
+    function updateActiveState() {
+        themeInputs.forEach(function(input) {
+            if (input.value === currentTheme) {
+                input.classList.add('btn-active');
+            } else {
+                input.classList.remove('btn-active');
+            }
+        });
+    }
+
+    updateActiveState();
+
+    themeInputs.forEach(function(input) {
+        input.addEventListener('change', function() {
+            themeInputs.forEach(function(btn) {
+                btn.classList.remove('btn-active');
+            });
+            this.classList.add('btn-active');
+        });
+    });
+});
+</script>

{labbdocs-0.4.0 → labbdocs-0.4.2}/labbdocs/templatetags/docs_tags.py

@@ -286,6 +286,9 @@ def get_blog_posts(context, doc_name="blog"):
     Get all blog posts sorted by published_time (most recent first).
     Excludes the index page and returns posts with their metadata.
 
+    Each post may include ``card_icon`` (from frontmatter, or inferred:
+    YouTube URL → rmx.youtube, other external → rmx.external-link, else rmx.article).
+
     Usage: {% get_blog_posts as posts %}
     """
     config = context.get("config", {})
@@ -307,6 +310,19 @@ def get_blog_posts(context, doc_name="blog"):
                 "published_time"
             )
 
+            external_url = (frontmatter.get("external_url") or "").strip()
+
+            card_icon = (frontmatter.get("card_icon") or "").strip()
+            if not card_icon:
+                if external_url:
+                    u = external_url.lower()
+                    if "youtube.com" in u or "youtu.be" in u:
+                        card_icon = "rmx.youtube"
+                    else:
+                        card_icon = "rmx.external-link"
+                else:
+                    card_icon = "rmx.article"
+
             posts.append(
                 {
                     "url_path": url_path,
@@ -317,6 +333,9 @@ def get_blog_posts(context, doc_name="blog"):
                     "modified_time": frontmatter.get("modified_time", ""),
                     "tags": frontmatter.get("tags", []),
                     "og_image": seo.get("og_image", ""),
+                    "external_url": external_url,
+                    "is_external": bool(external_url),
+                    "card_icon": card_icon,
                 }
             )
 

{labbdocs-0.4.0 → labbdocs-0.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "labbdocs"
-version = "0.4.0"
+version = "0.4.2"
 description = "Documentation for the labb project"
 authors = [
     {name = "zadiq", email = "dev@zadiq.com"}

labbdocs-0.4.0/labbdocs/templates/cotton/lbdocs/nav/topnav.html

@@ -1,143 +0,0 @@
-{% load lb_tags %}
-{% load static %}
-
-<c-vars
-    topnavTitle
-    showDrawerToggle
-    :themeOptions="{
-        '__system__': 'System',
-        'labb-light': 'Light',
-        'labb-dark': 'Dark',
-        'light': 'Daisy Light',
-        'dark': 'Daisy Dark'
-    }"
-/>
-
-{% labb_theme_val as theme %}
-
-<c-lb.navbar class="fixed top-0 inset-x-0 z-50 bg-base-100 py-3">
-    <c-lb.navbar.start class="flex items-center gap-2 lg:w-full">
-        {% if showDrawerToggle %}
-            <c-lb.drawer.toggle for="docs-drawer" class="btn btn-ghost btn-sm btn-square lg:hidden">
-                <c-lbi.rmx.menu-4 w="1.75em" h="1.75em" />
-            </c-lb.drawer.toggle>
-        {% endif %}
-        <a class="text-2xl font-bold tracking-widest flex items-center" href="{% url 'index' %}">
-            <c-lbdocs.ui.logo height="26" />
-        </a>
-
-        {% comment %} Desktop menu {% endcomment %}
-        <c-lb.menu direction="horizontal" class="items-center gap-2 lg:flex hidden">
-            <c-lb.menu.item title="guide" href="{% url 'guide_docs' %}" />
-            <c-lb.menu.item title="ui" href="{% url 'ui_docs' %}" />
-            <c-lb.menu.item title="charts" href="{% doc_url '8_charts/0_charts.md' 'ui' %}" />
-            <c-lb.menu.item title="icons" href="{% url 'icons_docs' %}" />
-            <c-lb.menu.item title="blog" href="{% url 'blog_docs' %}" />
-            {% comment %}
-            <li>
-                <c-lb.dropdown alignment="start" size="sm">
-                    <c-lb.dropdown.trigger class="flex items-center gap-1" style="cursor: pointer; text-decoration: none; color: inherit;">
-                        community
-                    </c-lb.dropdown.trigger>
-                    <c-lb.dropdown.content class="bg-base-100 rounded-box w-52 shadow-md border border-base-200">
-                        <c-lb.menu direction="vertical" class="w-full -pl-2">
-                            <c-lb.menu.item class="pr-2" href="{% url 'blog_docs' %}" title="blog" />
-                            <c-lb.menu.item class="pr-2" href="https://github.com/labbhq/labb" target="_blank" title="github" />
-                        </c-lb.menu>
-                    </c-lb.dropdown.content>
-                </c-lb.dropdown>
-            </li>
-            {% endcomment %}
-        </c-lb.menu>
-
-    </c-lb.navbar.start>
-
-    <c-lb.navbar.center>
-        {% comment %} Mobile menu {% endcomment %}
-        <c-lb.dropdown alignment="center" size="sm" class="lg:hidden">
-            <c-lb.dropdown.trigger class="btn btn-ghost text-base-content/50">
-                <span class="tracking-widest lg:hidden lowercase">{{topnavTitle|default:"Explore"}}</span>
-                <c-lbi.rmx.arrow-down-s w="1em" h="1em" />
-            </c-lb.dropdown.trigger>
-            <c-lb.dropdown.content class="bg-base-100 rounded-box w-52 shadow-md border border-base-200">
-                <c-lb.menu class="w-full">
-                    <c-lb.menu.item title="guide" href="{% url 'guide_docs' %}" />
-                    <c-lb.menu.item title="ui" href="{% url 'ui_docs' %}" />
-                    <c-lb.menu.item title="charts" href="{% doc_url '8_charts/0_charts.md' 'ui' %}" />
-                    <c-lb.menu.item title="icons" href="{% url 'icons_docs' %}" />
-                    <c-lb.menu.item title="blog" href="{% url 'blog_docs' %}" />
-                    {% comment %} <c-lb.menu.item type="submenu-details" title="community" open>
-                        <c-lb.menu.item href="{% url 'blog_docs' %}" title="blog" />
-                        <c-lb.menu.item href="https://github.com/labbhq/labb" target="_blank" title="github" />
-                    </c-lb.menu.item> {% endcomment %}
-                </c-lb.menu>
-            </c-lb.dropdown.content>
-        </c-lb.dropdown>
-    </c-lb.navbar.center>
-
-    <c-lb.navbar.end class="flex items-center gap-2">
-        <c-lb.button size="sm" btnStyle="ghost" icon="rmx.search" onclick="search_modal.showModal()">
-            Search
-         </c-lb.button>
-        <c-lb.dropdown alignment="end" size="sm">
-            <c-lb.dropdown.trigger class="btn btn-sm btn-ghost btn-circle">
-                <c-lbi.rmx.sun w="1.25em" h="1.25em" />
-            </c-lb.dropdown.trigger>
-            <c-lb.dropdown.content class="bg-base-100 rounded-box w-52 shadow-md border border-base-200">
-                <c-lb.menu class="w-full">
-                    {% for key, value in themeOptions.items %}
-                        <input
-                            type="radio"
-                            name="doc-theme"
-                            value="{{key}}"
-                            class="theme-controller btn btn-ghost btn-sm justify-start"
-                            aria-label="{{value}}"
-                            {% if key == theme %}checked{% endif %}
-                        />
-                    {% endfor %}
-                </c-lb.menu>
-            </c-lb.dropdown.content>
-        </c-lb.dropdown>
-        <c-lb.button as="a" href="https://github.com/labbhq/labb" target="_blank" size="sm" btnStyle="ghost" modifier="circle" class="hidden lg:flex">
-            <c-lbi n="rmx.github" w="1.25em" h="1.25em" />
-        </c-lb.button>
-    </c-lb.navbar.end>
-</c-lb.navbar>
-
-<c-lb.modal id="search_modal" withBackdrop boxClass="border border-base-200 shadow">
-    <h3 class="text-lg font-bold">Search</h3>
-    <p class="py-4">Search features are coming soon!</p>
-    <c-lb.modal.action>
-        <form method="dialog">
-            <c-lb.button>Close</c-lb.button>
-        </form>
-    </c-lb.modal.action>
-</c-lb.modal>
-
-<script>
-document.addEventListener('DOMContentLoaded', function() {
-    const currentTheme = "{{ theme }}";
-    const themeInputs = document.querySelectorAll('input[name="doc-theme"].theme-controller');
-
-    function updateActiveState() {
-        themeInputs.forEach(function(input) {
-            if (input.value === currentTheme) {
-                input.classList.add('btn-active');
-            } else {
-                input.classList.remove('btn-active');
-            }
-        });
-    }
-
-    updateActiveState();
-
-    themeInputs.forEach(function(input) {
-        input.addEventListener('change', function() {
-            themeInputs.forEach(function(btn) {
-                btn.classList.remove('btn-active');
-            });
-            this.classList.add('btn-active');
-        });
-    });
-});
-</script>