I just bumped the version so I could test.

I needed a fast test to make sure the Gitea server repository was
working.

.gitea/workflows/build.yaml

@@ -0,0 +1,41 @@
+name: Build Tavernworks
+run-name: Building on Silverymoon by ${{ gitea.actor }}.
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  Explore-Gitea-Actions:
+    runs-on: FreeBSD-14.1
+    env:
+      SOURCE_DIR: tavernworks
+      TARGET_DIR: /home/gitea/bin
+    steps:
+      - name: Setup Workspace
+        run: |
+          rm -rf ${{ github.workspace }}/*
+          echo "Source Dir: $SOURCE_DIR"
+      - name: Clone Repo
+        uses: https://gitea.com/actions/checkout@v4
+        with:
+          repository: CyberMages/tavernworks
+          token: ${{ secrets.CM_GIT_TOKEN }}
+          path: ${{ env.SOURCE_DIR }}
+      - name: Build Repo
+        run: |
+          pwd
+          ls -la
+          cd "$SOURCE_DIR"
+          echo "Current Shell: $SHELL"
+          echo "PATH=$PATH"
+          . ~/.profile
+          echo "PATH=$PATH"
+          echo "Building release."
+          cargo build --release
+          echo "Installing loreweaver."
+          cp ./target/release/loreweaver "$TARGET_DIR"
+      - name: Clean Workspace
+        run: |
+          rm -rf ${{ github.workspace }}/*
+          ls -la

Cargo.toml

@@ -2,7 +2,7 @@
 members = [
     "tavern",
     "bard",
-    "loremaster",
+    "loreweaver",
     "blog_test"]
 
 resolver = "2"  # Enables modern dependency resolution

README.md

@@ -0,0 +1,49 @@
+# Tavernworks
+
+Tavernworks is a modular blog system written in Rust. It is designed to parse,
+compile, and serve structured blog content using a cohesive set of themed
+libraries. The system is centered around the `tavern` content engine and is
+supported by a publisher CLI and a rendering frontend.
+
+## Overview
+
+TavernWorks consists of the following components:
+
+### tavern
+
+The core library that defines the data model, parses content, and provides the
+API to read and write blog data. It is responsible for turning a repository of
+Markdown files and metadata into an in-memory structure or database.
+
+### loreweaver
+
+A command-line tool that uses `tavern` to compile a blog repository into a
+SQLite database. It reads a `Tavern.toml` metadata file and outputs a portable
+database that can be served or inspected.
+
+### bard
+
+A Dioxus-based frontend library that renders blog content from the database.
+It provides components to create a full blog UI using data produced by
+`loreweaver`.
+
+### blog_test
+
+A test project that verifies the full system from content to rendering. It is
+used to validate that blog repositories are parsed, compiled, and rendered
+correctly across all components.
+
+---
+
+## Copyright & License
+
+Copyright 2025 CyberMages LLC
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this library except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS

bard/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "bard"
-version = "0.0.23"
+version = "0.3.17"
 edition = "2024"
 description = "Dioxus components that will display a Tavern blogging system Blog."
 repository = "/CyberMages/tavern"
@@ -14,12 +14,12 @@ name = "blog"
 path = "examples/blog.rs"
 
 [dependencies]
-dioxus = { version = "*", features = ["router", "fullstack"] }
+dioxus = { version = "=0.7.0-rc.1", features = ["router", "fullstack"] }
-tavern = { version = "0.2.9", path = "../tavern", optional = true}
+tavern = { version = "0.3.0", path = "../tavern", registry="cybermages", optional = true}
 tokio = { version = "1.0", features = ["rt", "macros"], optional = true }
 
 
 [features]
-default = ["web"]
+default = ["tavern"]
 web = ["tavern", "dioxus/web"]
 server = ["tavern/database", "dioxus/server", "tokio"]

bard/README.md

@@ -1,7 +1,72 @@
-# Tavern
+# Bard
 
-A blogging system that will allow you to write your blog in Markdown and then
+Bard is the frontend rendering library for the Tavernworks blog system.  
-display it in HTML using Dioxus.
+It provides Dioxus components for rendering blog content that has been compiled  
+into a SQLite database by Loreweaver and parsed by the Tavern engine.
+
+Bard supports both server-side and client-side rendering and is designed to be  
+integrated into Dioxus applications.
+
+## Features
+
+- Dioxus components for routing and rendering blog pages
+- Works with content stored in a SQLite database
+- Compatible with `dioxus-web` and `dioxus-desktop`
+- Optional server integration via Axum for local hosting
+
+## Usage
+
+To use Bard in a Dioxus application, you must:
+
+1. Initialize the database using `bard::init_database`.
+2. Add the `Router::<bard::Page>` component to your app.
+3. Optionally, define routes that include Bard under your own layout.
+
+### Example
+
+```rust
+#[component]
+fn App() -> Element {
+    rsx! {
+        Router::<Page> {}
+    }
+}
+
+#[derive(Routable, Clone, PartialEq)]
+pub enum Page {
+    #[layout(Navbar)]
+    #[route("/")]
+    Home {},
+
+    #[child("/blog")]
+    Bard
+    {
+       child: bard::Page
+    },
+
+    #[route("/:..route")]
+    PageNotFound { route: Vec<String> }
+}
+```
+
+### Server-side Initialization
+
+To serve the blog using Axum and load the database:
+
+```rust
+tokio::runtime::Runtime::new()
+    .unwrap()
+    .block_on(async move {
+        bard::init_database("path/to/tavern.db").await;
+    });
+```
+
+## Features
+
+Enable the following Cargo features as needed:
+
+- `server`: Enables Axum support for database-backed serving
+- `web`: Enables Dioxus web support
 
 ---
 

bard/assets/css/blog.css

@@ -1,3 +1,16 @@
+.visually_hidden
+{
+   position: absolute !important;
+   width: 1px !important;
+   height: 1px !important;
+   padding: 0 !important;
+   margin: -1px !important;
+   overflow: hidden !important;
+   clip: rect(0, 0, 0, 0) !important;
+   border: 0 !important;
+   white-space: nowrap !important;
+}
+
 .blog_style
 {
    display: flex;
@@ -17,3 +30,257 @@
       container-type: inline-size;
    }
 }
+
+
+
+.blog_list
+{
+   display: flex;
+   flex-direction: column;
+   width: 100%;
+   order: 5;
+
+   .blog_title
+   {
+      margin-top: 0px;
+      color: var(--accent-color);
+   }
+
+   .blog_title_image
+   {
+      width: 23rem;
+      align-self: center;
+      margin-bottom: 25px;
+   }
+
+   .blog_item
+   {
+      margin-bottom: 30px;
+
+      h2
+      {
+         margin: 0px;
+         color: var(--accent-color);
+
+         a:link, a:visited
+         {
+            color: var(--accent-color);
+         }
+
+         a:hover
+         {
+            color: var(--text-color);
+         }
+      }
+
+      p
+      {
+         margin: 5px 0px 0px 0px;
+         display: block;
+      }
+   }
+}
+
+
+
+.blog_post
+{
+   order: 5;
+
+   h1
+   {
+      margin: 0px;
+      color: var(--accent-color);
+   }
+
+   h4
+   {
+      margin-top: 10px;
+      margin-bottom: 30px;
+   }
+
+   li
+   {
+      margin-bottom: 5px;
+   }
+
+   p
+   {
+      margin-top: 0px;
+      margin-bottom: 20px;
+   }
+
+   .blog_post_tale
+   {
+      pre
+      {
+         padding-left: 20px;
+      }
+
+      .embedded_video
+      {
+         margin-top: 50px;
+         display: flex;
+         align-content: center;
+         justify-content: center;
+
+         iframe
+         {
+            box-shadow: 0 0 80px var(--accent-color);
+         }
+      }
+   }
+}
+
+
+
+/* Tags will have a class of "tag_{tag_name}" that allows specific
+ * customization.
+ *
+ * .tag_easy
+ * {
+ *    background-color: #248721;
+ * }
+ *
+ * */
+.blog_tag
+{
+   display: flex;
+   flex-direction: row;
+
+   .tag_list
+   {
+      display: flex;
+      flex-direction: row;
+   }
+}
+
+.blog_nav
+{
+   order: 1;
+   display: flex;
+   flex-direction: column;
+   margin-top: 185px;
+   margin-right: 70px;
+   position:sticky;
+   top: 150px;
+   height: 50vh;
+
+   fieldset
+   {
+      border: none;
+      padding: 0;
+      margin: 0;
+      min-inline-size: unset;
+   }
+
+   legend
+   {
+      min-width: 130px;
+      padding: 0;
+      margin: 0;
+      font-weight: bold;
+   }
+
+   .tag_list
+   {
+      display: flex;
+      flex-direction: column;
+   }
+
+.toggle_button {
+  display: inline-block;
+  margin-top: 5px;
+  margin-right: 5px;
+  padding: 0px 6px;
+  border: 2px solid var(--text-color);
+  border-radius: 5px;
+  color: var(--text-color);
+  cursor: pointer;
+  user-select: none;
+  transition: 0.1s ease-in;
+}
+
+.toggle_button:hover {
+  color: var(--accent-color);
+  border-color: var(--accent-color);
+  transform: translateY(-2px);
+}
+
+.toggle_button input[type="checkbox"] {
+  position: absolute;
+  opacity: 0;
+  width: 0;
+  height: 0;
+  pointer-events: none;
+}
+
+/* Checked state using :has() — modern browsers only */
+.toggle_button:has(input:checked) {
+  color: var(--accent-color);
+  border-color: var(--accent-color);
+}
+
+
+   @container site (max-width: 1230px)
+   {
+      display: none;
+   }
+}
+
+.tag_list
+{
+   list-style: none;
+   padding: 0px;
+   margin: 0px;
+
+   .tag_item
+   {
+      margin-top: 5px;
+      margin-right: 5px;
+
+      a
+      {
+         display: inline-block;
+         padding: 0px 4px;
+         text-decoration: none;
+         border: 2px solid var(--text-color);
+         border-radius: 5px;
+
+         color: var(--text-color);
+         transition: 0.1s ease-in;
+
+         &:hover
+         {
+            color: var(--accent-color);
+            border: 2px solid var(--accent-color);
+            transform: translateY(-2px);
+         }
+      }
+   }
+}
+
+.video_link
+{
+   display: none;
+   width: 100%;
+   justify-content: center;
+}
+
+
+
+@media screen and (max-width: 1000px)
+{
+   .blog_post .blog_post_tale
+   {
+      .video_link
+      {
+         display: flex;
+      }
+
+      .embedded_video
+      {
+         display: none;
+      }
+   }
+}

bard/assets/css/blog_author.css

@@ -1,230 +0,0 @@
-.blog_style
-{
-   display: flex;
-   width: 100%;
-   height: 100%;
-   background: var(--bg-color);
-   padding: 50px 0px;
-   justify-content: center;
-   container-name: site;
-   container-type: inline-size;
-
-   .page_content
-   {
-      display: flex;
-      width: 67%;
-      container-name: page;
-      container-type: inline-size;
-   }
-}
-
-
-
-.blog_nav
-{
-   width: 15%;
-   padding: 0px 20px;
-
-   h3
-   {
-      margin-bottom: 10px;
-   }
-
-   ul
-   {
-      list-style: none;
-
-      li
-      {
-      }
-   }
-
-   @container site (max-width: 1230px)
-   {
-      display: none;
-   }
-
-   .social
-   {
-      /* Hide .social until the font is loaded */
-      display: flex;
-      align-items: center;
-      gap: 15px;
-      margin: 25px 0;
-      font-family: cm_social;
-
-      a
-      {
-         color: var(--text-color);
-         font-size: 46px;
-         text-decoration: none;
-         background: transparent;
-         width: 65px;
-         height: 65px;
-         border-radius: 50%;
-         display: flex;
-         align-items: flex-end;
-         justify-content: center;
-         transition: 0.4s ease;
-         border: 4px solid var(--text-color);
-
-         &:hover
-         {
-            color: var(--accent-color);
-            border: 4px solid var(--accent-color);
-            transform: translateY(-7px);
-         }
-      }
-   }
-}
-}
-
-
-
-.blog_item_area
-{
-   .blog_list
-   {
-      list-style: none;
-
-      .blog_item
-      {
-         margin-bottom: 50px;
-
-         h1
-         {
-            color: var(--accent-color);
-         }
-
-         h4
-         {
-            margin: 10px 0px;
-         }
-
-         p
-         {
-            display: block;
-         }
-      }
-   }
-}
-
-
-
-.blog_article
-{
-   h1
-   {
-      color: var(--accent-color);
-   }
-
-   h4
-   {
-      margin-top: 10px;
-      margin-bottom: 30px;
-   }
-
-   p
-   {
-      margin-bottom: 20px;
-   }
-
-   .embeded_video
-   {
-      margin-top: 50px;
-      display: flex;
-      align-content: center;
-      justify-content: center;
-
-      iframe
-      {
-         box-shadow: 0 0 80px var(--accent-color);
-      }
-   }
-}
-
-
-
-.tag_style
-{
-   display: block;
-
-   .tag_list
-   {
-      list-style: none;
-
-      .tag_item
-      {
-         display: inline-block;
-         margin: 5px 5px 0px 0px;
-
-         a
-         {
-            display: block;
-            padding: 0px 4px;
-            text-decoration: none;
-            border: 2px solid var(--text-color);
-            border-radius: 5px;
-
-            color: var(--text-color);
-            transition: 0.1s ease-in;
-
-            &:hover
-            {
-               color: var(--accent-color);
-               border: 2px solid var(--accent-color);
-               transform: translateY(-2px);
-            }
-         }
-      }
-   }
-}
-
-
-
-.easy
-{
-   background-color: #248721;
-}
-
-.medium
-{
-   background-color: #d6a318;
-}
-
-.hard
-{
-   background-color: #d92121;
-}
-
-
-
-.social
-{
-   background: transparent;
-   font-family: cm_social;
-   margin: 15px 0px;
-
-   a
-   {
-      color: var(--text-color);
-      font-size: 30px;
-      text-decoration: none;
-      background: transparent;
-      width: 45px;
-      height: 45px;
-      border-radius: 50%;
-      display: flex;
-      align-items: flex-end;
-      justify-content: center;
-      transition: 0.4s ease;
-      border: 4px solid var(--text-color);
-
-      &:hover
-      {
-         color: var(--accent-color);
-         border: 4px solid var(--accent-color);
-         transform: translateY(-7px);
-      }
-   }
-}

bard/assets/css/blog_list.css

@@ -1,27 +0,0 @@
-.blog_list_style
-{
-   .blog_list
-   {
-      list-style: none;
-
-      .blog_item
-      {
-         margin-bottom: 50px;
-
-         h1
-         {
-            color: var(--accent-color);
-         }
-
-         h4
-         {
-            margin: 10px 0px;
-         }
-
-         p
-         {
-            display: block;
-         }
-      }
-   }
-}

bard/assets/css/blog_nav.css

@@ -1,117 +0,0 @@
-.blog_style
-{
-   display: flex;
-   width: 100%;
-   height: 100%;
-   background: var(--bg-color);
-   padding: 50px 0px;
-   justify-content: center;
-   container-name: site;
-   container-type: inline-size;
-
-   .page_content
-   {
-      display: flex;
-      width: 67%;
-      container-name: page;
-      container-type: inline-size;
-   }
-}
-
-
-
-.blog_nav_style
-{
-   width: 15%;
-   padding: 0px 20px;
-   order: 5;
-
-   h3
-   {
-      margin-bottom: 10px;
-   }
-
-   ul
-   {
-      list-style: none;
-
-      li
-      {
-      }
-   }
-
-   @container site (max-width: 1230px)
-   {
-      display: none;
-   }
-
-   .social
-   {
-      /* Hide .social until the font is loaded */
-      display: flex;
-      align-items: center;
-      gap: 15px;
-      margin: 25px 0;
-      font-family: cm_social;
-
-      a
-      {
-         color: var(--text-color);
-         font-size: 22px;
-         text-decoration: none;
-         background: transparent;
-         width: 35px;
-         height: 35px;
-         border-radius: 50%;
-         display: flex;
-         align-items: flex-end;
-         justify-content: center;
-         transition: 0.4s ease;
-         border: 4px solid var(--text-color);
-
-         &:hover
-         {
-            color: var(--accent-color);
-            border: 4px solid var(--accent-color);
-            transform: translateY(-7px);
-         }
-      }
-   }
-
-.tag_style
-{
-   display: block;
-
-   .tag_list
-   {
-      display: inline-flex;
-      flex-direction: column;
-      list-style: none;
-
-      .tag_item
-      {
-         display: inline-block;
-         margin: 5px 5px 0px 0px;
-
-         a
-         {
-            display: inline-flex;
-            padding: 0px 4px;
-            text-decoration: none;
-            border: 2px solid var(--text-color);
-            border-radius: 5px;
-
-            color: var(--text-color);
-            transition: 0.1s ease-in;
-
-            &:hover
-            {
-               color: var(--accent-color);
-               border: 2px solid var(--accent-color);
-               transform: translateY(-2px);
-            }
-         }
-      }
-   }
-}
-}

bard/assets/css/blog_post.css

@@ -1,119 +0,0 @@
-.blog_post_style
-{
-   order: 1;
-
-   h1
-   {
-      color: var(--accent-color);
-   }
-
-   h4
-   {
-      margin-top: 10px;
-      margin-bottom: 30px;
-   }
-
-   p
-   {
-      margin-bottom: 20px;
-   }
-
-   .embeded_video
-   {
-      margin-top: 50px;
-      display: flex;
-      align-content: center;
-      justify-content: center;
-
-      iframe
-      {
-         box-shadow: 0 0 80px var(--accent-color);
-      }
-   }
-}
-
-
-
-.tag_style
-{
-   display: block;
-
-   .tag_list
-   {
-      list-style: none;
-
-      .tag_item
-      {
-         display: inline-block;
-         margin: 5px 5px 0px 0px;
-
-         a
-         {
-            display: block;
-            padding: 0px 4px;
-            text-decoration: none;
-            border: 2px solid var(--text-color);
-            border-radius: 5px;
-
-            color: var(--text-color);
-            transition: 0.1s ease-in;
-
-            &:hover
-            {
-               color: var(--accent-color);
-               border: 2px solid var(--accent-color);
-               transform: translateY(-2px);
-            }
-         }
-      }
-   }
-}
-
-
-
-.easy
-{
-   background-color: #248721;
-}
-
-.medium
-{
-   background-color: #d6a318;
-}
-
-.hard
-{
-   background-color: #d92121;
-}
-
-
-
-.social
-{
-   background: transparent;
-   font-family: cm_social;
-   margin: 15px 0px;
-
-   a
-   {
-      color: var(--text-color);
-      font-size: 30px;
-      text-decoration: none;
-      background: transparent;
-      width: 45px;
-      height: 45px;
-      border-radius: 50%;
-      display: flex;
-      align-items: flex-end;
-      justify-content: center;
-      transition: 0.4s ease;
-      border: 4px solid var(--text-color);
-
-      &:hover
-      {
-         color: var(--accent-color);
-         border: 4px solid var(--accent-color);
-         transform: translateY(-7px);
-      }
-   }
-}

bard/assets/css/blog_tag.css

@@ -1,54 +0,0 @@
-.blog_tag_style
-{
-   display: block;
-
-   .tag_list
-   {
-      list-style: none;
-
-      .tag_item
-      {
-         display: inline-block;
-         margin: 5px 5px 0px 0px;
-
-         a
-         {
-            display: block;
-            padding: 0px 4px;
-            text-decoration: none;
-            border: 2px solid var(--text-color);
-            border-radius: 5px;
-
-            color: var(--text-color);
-            transition: 0.1s ease-in;
-
-            &:hover
-            {
-               color: var(--accent-color);
-               border: 2px solid var(--accent-color);
-               transform: translateY(-2px);
-            }
-         }
-      }
-   }
-
-   .none
-   {
-      background-color: var(--bg-color);
-   }
-
-   .easy
-   {
-      background-color: #248721;
-   }
-
-   .medium
-   {
-      background-color: #d6a318;
-   }
-
-   .hard
-   {
-      background-color: #d92121;
-   }
-}

bard/src/components/list.rs

@@ -1,47 +1,41 @@
-use std::borrow::Borrow;
 use std::collections::HashSet;
-use std::hash::Hash;
 
 use dioxus::prelude::*;
-use tavern::{Adventurer, Legend, Lore, Tale};
 
 use crate::togglable::Togglable;
 use crate::page::Page;
 use crate::server::*;
+use crate::settings::{BardSettings};
 use super::tags::*;
 
 
 
-#[component]
-pub fn BlogAuthor() -> Element
-{
-   rsx!
-   {
-      section
-      {
-         class: "blog_author_style",
-      }
-   }
-}
-
-
 #[component]
 pub fn BlogItem(title: String, slug: String, author: String, summary: String,
                 tags: Vec<String>)
                 -> Element
 {
-               println!("Blog Item: {title}  --  [{tags:?}]");
+   let author_future = use_server_future(move ||
+   {
+      let handle: String = author.clone();
+
+      async move { get_author(handle).await }
+   })?;
+
    rsx!
    {
-      li
+      article
       {
-         key: "{slug}",
          class: "blog_item",
 
+         h2
+         {
             Link
             {
                to: Page::Post { slug: slug.clone() },
-            h1 { "{title}" }
+
+               "{title}"
+            }
          }
 
          TagList
@@ -55,7 +49,24 @@ pub fn BlogItem(title: String, slug: String, author: String, summary: String,
             }
          }
 
-         h4 { "Author: {author}" }
+         if let Some(Ok(Some(adventurer))) = (author_future.value())()
+         {
+            p
+            {
+               b
+               {
+                  "Author: "
+                  a
+                  {
+                     href: "{adventurer.legend.profile}", "{adventurer.name}"
+                  }
+               }
+            }
+         }
+         else
+         {
+            p { "Loading author..." }
+         }
 
          p { "{summary}" }
       }
@@ -66,27 +77,79 @@ pub fn BlogItem(title: String, slug: String, author: String, summary: String,
 #[component]
 pub fn BlogList(tags: Signal<HashSet<String>>, children: Element) -> Element
 {
-   let list = use_server_future(move || {
+   // Retrieve the provided settings from context.
-      let categories = tags().iter().cloned().collect();
+   let settings = use_context::<BardSettings>();
+
+   let list = use_resource(move ||
+   {
+      let tags = tags();
+      let categories: Vec<String> = tags.iter().cloned().collect();
 
       async move { get_blog_list(categories).await }
-   })?;
+   });
 
    rsx!
    {
       section
-      {
-         class: "blog_list_style",
-         ul
       {
          class: "blog_list",
 
+         match settings.blog_image
+         {
+            Some(image) =>
+            {
+               match settings.blog_name
+               {
+                  Some(title) =>
+                  {
+                     rsx!
+                     {
+                        h1 { class: "blog_title visually_hidden", "{title}" }
+                        img { class: "blog_title_image", alt: "{title} blog logo", src: image }
+                     }
+                  }
+
+                  None =>
+                  {
+                     rsx!
+                     {
+                        h1 { class: "blog_title visually_hidden", "Blog" }
+                        img { class: "blog_title_image", alt: "Blog logo", src: image }
+                     }
+                  }
+               }
+            }
+
+            None =>
+            {
+               match settings.blog_name
+               {
+                  Some(title) =>
+                  {
+                     rsx!
+                     {
+                        h1 { class: "blog_title", "{title}" }
+                     }
+                  }
+
+                  None =>
+                  {
+                     rsx!
+                     {
+                        h1 { class: "blog_title visually_hidden", "Blog" }
+                     }
+                  }
+               }
+            }
+         }
+
          if let Some(Ok(lores)) = &*list.read()
          {
             for lore in lores
             {
                BlogItem
                {
+                  key: "{lore.slug}",
                   title: lore.title.clone(),
                   slug: lore.slug.clone(),
                   author: lore.author.clone(),
@@ -95,10 +158,9 @@ pub fn BlogList(tags: Signal<HashSet<String>>, children: Element) -> Element
                }
             }
          }
-            else if let Some(Err(e)) = &*list.read()
+         else if let Some(Err(_e)) = &*list.read()
          {
-               p { "Unable to show post header." }
+            p { "Please choose a category to see related blog posts." }
-               p { "{e}" }
          }
          else
          {
@@ -109,11 +171,12 @@ pub fn BlogList(tags: Signal<HashSet<String>>, children: Element) -> Element
       }
    }
 }
-}
+
 
 #[component]
 pub fn ToggleTag(tag: String, toggled_tags: Signal<HashSet<String>>) -> Element
 {
+   let is_checked = toggled_tags.read().is_toggled(&tag);
    rsx!
    {
       label
@@ -123,56 +186,115 @@ pub fn ToggleTag(tag: String, toggled_tags: Signal<HashSet<String>>) -> Element
          input
          {
             r#type: "checkbox",
-            checked: toggled_tags.read().is_toggled(&tag),
+            checked: is_checked,
             onchange: move |_|
                       {
                          toggled_tags.write().toggle(&tag.clone());
                       },
          }
 
-         span { "{tag}" }
+         "{tag}"
       }
    }
 }
 
+
+// Using use_resource instead of use_server_future for URL-dependent tag selection
+//
+// While use_server_future should theoretically be reactive when reading signals in the
+// closure (per Dioxus docs), in practice it doesn't reliably re-run when the url_tag
+// signal changes, especially during direct URL navigation (typing URLs in browser).
+//
+// use_resource provides more reliable reactivity for this use case because:
+// 1. It explicitly depends on url_tag and consistently re-runs when it changes
+// 2. It handles both async data fetching AND selection logic in a single atomic operation
+// 3. It works consistently across all navigation methods (links, direct URLs, etc.)
+// 4. It avoids timing coordination issues between separate hooks
+//
+// This approach combines fetching available tags from the server with determining
+// which tags should be selected based on the current URL, returning both pieces
+// of data together for clean state management.
 #[component]
-pub fn TagSelector(show_all: Signal<bool>, toggled_tags: Signal<HashSet<String>>) -> Element
+pub fn TagSelector(url_tag: ReadSignal<String>,
+                   toggled_tags: Signal<HashSet<String>>) -> Element
 {
-   let toggle_all: bool = show_all();
+   // Use use_resource to handle both fetching tags AND initializing selection
+   let tags_and_selection = use_resource(move ||
+   {
+      let current_url = url_tag();
 
-   println!("Tag Selector toggled tags: {:?}", toggled_tags());
+      async move
-   let tags_future = use_server_future(move || async move { get_tags().await })?;
+      {
+         match get_tags().await
+         {
+            Ok(available_tags) =>
+            {
+               // Determine what should be selected based on URL
+               let should_show_all = current_url.is_empty() || current_url == "all";
 
-   use_effect(move ||
+               let selected_tags: HashSet<String> = if should_show_all
                {
-      if let Some(Ok(tags)) = &*tags_future.read()
+                  available_tags.iter().cloned().collect()
+               }
+               else
                {
-         if toggle_all
+                  let url_categories = convert_categories(&current_url);
+
+                  let filtered: HashSet<String> = url_categories.into_iter()
+                     .filter(|tag| available_tags.contains(tag))
+                     .collect();
+
+                  filtered
+               };
+
+               Ok((available_tags, selected_tags))
+            }
+
+            Err(e) =>
             {
-            for tag in tags
+               eprintln!("RESOURCE - Error: {}", e);
-            {
+               Err(e)
-               toggled_tags.write().insert(tag.clone());
             }
          }
       }
    });
 
+   // Separate effect to update toggled_tags when resource completes
+   // This separates reading the resource from writing to toggled_tags
+   use_effect(move ||
+   {
+      if let Some(Ok((_, selected_tags))) = &*tags_and_selection.read()
+      {
+         toggled_tags.set(selected_tags.clone());
+      }
+   });
+
+
    rsx!
    {
       section
       {
-         class: "blog_nav_style",
+         class: "blog_nav",
-         div
+
+         h2 { class: "visually_hidden", "Filters and Navigation" }
+
+         fieldset
          {
             class: "tag_style",
-            h2 { "Categories" }
+
+            legend { "Category Filter" }
+
             ul
             {
                class: "tag_list",
 
-               if let Some(Ok(tags)) = tags_future()
+               match &*tags_and_selection.read()
                {
-                  for tag in tags
+                  Some(Ok((available_tags, _))) =>
+                  {
+                     rsx!
+                     {
+                        for tag in available_tags
                         {
                            li
                            {
@@ -181,14 +303,41 @@ pub fn TagSelector(show_all: Signal<bool>, toggled_tags: Signal<HashSet<String>>
 
                               ToggleTag
                               {
-                           tag: &tag,
+                                 tag: tag.clone(),
                                  toggled_tags: toggled_tags
                               }
                            }
                         }
                      }
                   }
+
+                  Some(Err(_)) =>
+                  {
+                     rsx!
+                     {
+                        li { "Error loading tags" }
+                     }
+                  }
+
+                  None =>
+                  {
+                     rsx!
+                     {
+                        li { "Loading tags..." }
                      }
                   }
                }
             }
+         }
+      }
+   }
+}
+
+fn convert_categories(categories: &str) -> HashSet<String>
+{
+   categories
+      .split('+')
+      .filter(|s| !s.is_empty() && *s != "all")
+      .map(str::to_string)
+      .collect()
+}

bard/src/components/post.rs

@@ -1,12 +1,9 @@
-use std::borrow::Borrow;
+use tavern::{Adventurer, Tale};
-use std::collections::HashSet;
-use std::hash::Hash;
 
 use dioxus::prelude::*;
-use tavern::{Adventurer, Legend, Lore, Tale};
 
-use crate::togglable::Togglable;
 use crate::page::Page;
+use crate::settings::BardSettings;
 use crate::server::*;
 use super::tags::*;
 
@@ -26,30 +23,87 @@ pub fn BlogAuthor() -> Element
 
 
 #[component]
-pub fn PostHeaderAuthor(adventurer: Adventurer) -> Element
+pub fn PostHeaderAuthor(author: Option<Adventurer>, publish_date: String) -> Element
+{
+   match author
+   {
+      Some(adventurer) =>
       {
          rsx!
          {
-      h4
+            document::Meta
+            {
+               name: "author",
+               content: "{adventurer.name}"
+            }
+
+            i
+            {
+               "Published: {publish_date}"
+            }
+
+            p
+            {
+               b
                {
                   "Author: ",
-         a { href: "{adventurer.legend.profile}", "{adventurer.name} @{adventurer.handle}" }
+                  a { href: "{adventurer.legend.profile}", "{adventurer.name}" }
+               }
+            }
+         }
+      }
+
+      None=>
+      {
+         rsx!
+         {
+            document::Meta
+            {
+               name: "author",
+               content: "Unknown"
+            }
+
+            i
+            {
+               "Published: {publish_date}"
+            }
+
+            p
+            {
+               b
+               {
+                  "Author: Unknown"
+               }
+            }
+         }
       }
    }
 }
 
 #[component]
-pub fn PostHeader(tale: Tale) -> Element
+pub fn PostHeader(tale: Tale, adventurer: Option<Adventurer>) -> Element
 {
-   let author_future = use_server_future(move ||
+   // Get the pages URL.
-   {
+   let url: Page = use_route();
-      let handle: String = tale.lore.author.clone();
 
-      async move { get_author(handle).await }
+   // Get the blog's image to use as a placeholder if there isn't one for the
-   })?;
+   // blog post.
+   // Retrieve the provided settings from context.
+   let settings = use_context::<BardSettings>();
 
    rsx!
    {
+      // Open Graph (used by LinkedIn, Bluesky, Discord, etc.)
+      document::Meta { property: "og:locale", content: "en_US" }
+      document::Meta { name: "title", property: "og:title", content: "{tale.lore.title}" }
+      document::Meta { name: "description", property: "og:description", content: "{tale.lore.summary}" }
+      document::Meta { property: "og:type", content: "article" }
+      document::Meta { property: "og:url", content: "{url}" }
+      if let Some(image) = settings.default_post_image
+      {
+         document::Meta { name: "image", property: "og:image", content: "{image}" }
+      }
+
       h1 { {tale.lore.title} }
 
       TagList
@@ -63,13 +117,10 @@ pub fn PostHeader(tale: Tale) -> Element
          }
       }
 
-      if let Some(Ok(Some(adventurer))) = (author_future.value())()
+      PostHeaderAuthor
       {
-         PostHeaderAuthor { adventurer: adventurer }
+         author: adventurer,
-      }
+         publish_date: tale.lore.publish_date.format("%m/%d/%Y").to_string()
-      else
-      {
-         p { "Loading author..." }
       }
    }
 }
@@ -79,7 +130,12 @@ pub fn Story(text: String) -> Element
 {
    rsx!
    {
-      div { dangerous_inner_html: "{text}" }
+      div
+      {
+         class: "blog_post_tale",
+
+         dangerous_inner_html: "{text}"
+      }
    }
 }
 
@@ -92,20 +148,26 @@ pub fn BlogPost(slug: Signal<String>, children: Element) -> Element
       // Make this reactive so that as the page changes it should rerun this.
       let url_slug = slug();
 
-      async move { get_blog_post(url_slug).await }
+      async move
+      {
+         let post = get_blog_post(url_slug).await?;
+         let author = get_author(post.lore.author.clone()).await?;
+         Ok::<_, ServerFnError>((post, author))
+      }
    })?;
 
    rsx!
    {
       article
       {
-         class: "blog_post_style",
+         class: "blog_post",
 
-         if let Some(Ok(tale)) = (post_future.value())()
+         if let Some(Ok((tale, adventurer))) = (post_future.value())()
          {
             PostHeader
             {
-               tale: tale.clone()
+               tale: tale.clone(),
+               adventurer: adventurer.clone()
             }
 
             Story { text: tale.story }
@@ -137,36 +199,30 @@ pub fn TagNav() -> Element
    {
       section
       {
-         class: "blog_nav_style",
+         class: "blog_nav",
-         div
+
-         {
+         fieldset
-            class: "tag_style",
-            h2 { "Categories" }
-            ul
          {
             class: "tag_list",
+
+            legend { "Category Filter" }
+
             if let Some(Ok(categories)) = &*tags.read()
+            {
+               TagList
                {
                   for tag in categories
                   {
-                     li
+                     TagItem
                      {
-                        key: "{tag}",
+                        tag: tag.clone()
-                        class: "tag_item",
-                        Link
-                        {
-                           to: Page::Blog { tag: tag.clone() },
-
-                           "{tag}"
                      }
-
-                        //a { href: "/blog/{tag}", "{tag}" }
                   }
                }
             }
             else if let Some(Err(e)) = &*tags.read()
             {
-                  p { "Unable to show desired post." }
+               p { "Unable to load tags." }
                p { "{e}" }
             }
             else
@@ -177,4 +233,3 @@ pub fn TagNav() -> Element
       }
    }
 }
-}

bard/src/components/tags.rs

@@ -22,7 +22,7 @@ pub fn TagItem(tag: String, style: Option<String>) -> Element
 
          Link
          {
-            class: "{tag_style}",
+            class: "{tag_style} tag_{tag}",
 
             to: Page::Blog { tag: tag.clone() },
 
@@ -37,15 +37,10 @@ pub fn TagList(children: Element) -> Element
 {
    rsx!
    {
-      h5
-      {
-         class: "blog_tag_style",
-
       ul
       {
-            class: "tag_list",
+         class: "blog_tag tag_list",
          {children}
       }
    }
 }
-}

bard/src/lib.rs

@@ -6,6 +6,7 @@ mod components;
 mod page;
 mod pages;
 mod server;
+mod settings;
 mod togglable;
 
 
@@ -14,5 +15,6 @@ pub use crate::components::*;
 pub use crate::info::{get_name, get_version};
 pub use crate::page::Page;
 pub use crate::pages::*;
+pub use crate::settings::*;
 #[cfg(feature = "server")]
 pub use crate::server::*;

bard/src/page.rs

@@ -1,6 +1,7 @@
 use dioxus::prelude::*;
 
 use crate::pages::{Blog, Post, Root};
+use crate::settings::{BardSettings, StylesheetBehavior};
 
 
 
@@ -10,10 +11,39 @@ const BLOG_CSS: Asset = asset!("/assets/css/blog.css");
 
 #[component]
 fn BlogLayout() -> Element
+{
+   // Retrieve the provided settings from context.
+   let settings = use_context::<BardSettings>();
+
+   rsx!
+   {
+      match settings.stylesheet
+      {
+         StylesheetBehavior::Override(asset) =>
+         {
+            rsx!
+            {
+                document::Stylesheet { href: asset }
+            }
+         }
+
+         StylesheetBehavior::Extend(asset) =>
          {
             rsx!
             {
                 document::Stylesheet { href: BLOG_CSS }
+                document::Stylesheet { href: asset }
+            }
+         }
+
+         StylesheetBehavior::None =>
+         {
+            rsx!
+            {
+                document::Stylesheet { href: BLOG_CSS }
+            }
+         }
+      }
 
       Outlet::<Page> {}
    }

bard/src/pages/blog.rs

@@ -3,38 +3,15 @@ use std::collections::HashSet;
 use dioxus::prelude::*;
 
 use crate::components::{BlogList, TagSelector};
-use crate::page::Page;
-
-
-
-fn convert_categories(categories: &str) -> HashSet<String>
-{
-   categories
-      .split('+')
-      .filter(|s| !s.is_empty() && *s != "all")
-      .map(str::to_string)
-      .collect()
-}
 
 
 
 /// Blog page
 #[component]
-pub fn Blog(tag: ReadOnlySignal<String>) -> Element
+pub fn Blog(tag: ReadSignal<String>) -> Element
 {
-   let mut show_all: Signal<bool> =
+   let categories: Signal<HashSet<String>> =
-      use_signal(|| tag().is_empty() || tag() == "all");
+      use_signal(|| HashSet::new());
-
-   let mut categories: Signal<HashSet<String>> =
-      use_signal(|| convert_categories(&tag()));
-
-   use_effect(move ||
-   {
-      let new_tags = convert_categories(&tag());
-      categories.set(new_tags);
-   });
-
-   println!("Blog Categories: {:?}", categories());
 
    rsx!
    {
@@ -47,13 +24,13 @@ pub fn Blog(tag: ReadOnlySignal<String>) -> Element
 
             BlogList
             {
-               tags: categories.clone()
+               tags: categories
             }
 
             TagSelector
             {
-               show_all: show_all.clone(),
+               url_tag: tag,
-               toggled_tags: categories.clone()
+               toggled_tags: categories
             }
          }
       }

bard/src/pages/post.rs

@@ -1,16 +1,15 @@
 use dioxus::prelude::*;
 
 use crate::components::{BlogPost, TagNav};
-use crate::page::Page;
 
 
 
 /// Blog page
 #[component]
-pub fn Post(slug: ReadOnlySignal<String>) -> Element
+pub fn Post(slug: ReadSignal<String>) -> Element
 {
    // Create a copy of the current slug to detect changes.
-   let mut url_slug = use_signal(|| slug());
+   let url_slug = use_signal(|| slug());
 
    rsx!
    {

bard/src/pages/root.rs

@@ -1,8 +1,5 @@
-use std::collections::HashSet;
-
 use dioxus::prelude::*;
 
-use crate::page::Page;
 use crate::pages::Blog;
 
 

bard/src/settings.rs

@@ -0,0 +1,46 @@
+use dioxus::prelude::*;
+
+
+
+#[derive(Copy, Clone)]
+pub enum StylesheetBehavior
+{
+   /// Overrides the default stylesheet.
+   Override(Asset),
+
+   /// Extends the default stylesheet. The library will load both.
+   Extend(Asset),
+
+   /// Uses the library's default stylesheet.
+   None
+}
+
+
+#[derive(Clone, Default)]
+pub struct BardSettings
+{
+   /// The name to use for the blog.
+   /// If None, then the name will be Blog, but made invisible so that
+   /// it is still available for screen readers.
+   pub blog_name: Option<String>,
+
+   /// The image to use for the blog title instead of just the name.
+   pub blog_image: Option<Asset>,
+
+   /// The image to use for the default post image in open graph. This is what
+   /// is shown when sharing the article.
+   pub default_post_image: Option<Asset>,
+
+   /// A user defined stylesheet and how the library should include it.
+   pub stylesheet: StylesheetBehavior
+}
+
+
+
+impl Default for StylesheetBehavior
+{
+   fn default() -> Self
+   {
+      StylesheetBehavior::None
+   }
+}

blog_test/Cargo.toml

@@ -1,23 +1,22 @@
 [package]
 name = "blog_test"
-version = "0.1.0"
+version = "0.3.2"
 authors = ["Myrddin Dundragon <myrddin@cybermages.tech>"]
 edition = "2021"
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [dependencies]
-axum = { version = "0.7.0", optional = true }
+axum = { version = "0.8.4", optional = true }
-axum-server = { version = "0.7.1", optional = true }
+axum-server = { version = "0.7.2", optional = true }
-dioxus = { version = "*", features = ["router", "fullstack"] }
+dioxus = { version = "=0.7.0-rc.1", features = ["router", "fullstack"] }
-dioxus-cli-config = { version = "*", optional = true }
 bard = { version = "*", path="../bard", optional = true }
 tokio = { version = "1.0", optional = true }
 
 [features]
-default = ["web"]
+default = ["bard"]
-web = ["dioxus/web", "bard"]
+web = ["dioxus/web", "bard/web"]
-server = ["dioxus/server", "axum", "axum-server", "tokio/rt-multi-thread", "tokio/macros", "dioxus-cli-config", "bard/server"]
+server = ["dioxus/server", "axum", "axum-server", "tokio/rt-multi-thread", "tokio/macros", "bard/server"]
 
 [profile.wasm-dev]
 inherits = "dev"

blog_test/assets/blog.css

@@ -0,0 +1,45 @@
+:root
+{
+   --text-color: #000000;
+   --bg-color: #FFFFFF;
+
+   --primary-color: #ffffff;
+   --secondary-color: #000000;
+   --accent-color: #7dfdfe; /* Tron grid  or try 00a8ff 00eaff 26b4ca 59b4c7 5584AC*/
+   --mobile-color: #363636;
+
+   --desktop-size: 1230px;
+}
+
+.toggle_button {
+  display: inline-block;
+  margin-top: 5px;
+  margin-right: 5px;
+  padding: 0px 6px;
+  border: 2px solid var(--text-color);
+  border-radius: 5px;
+  color: var(--text-color);
+  cursor: pointer;
+  user-select: none;
+  transition: 0.1s ease-in;
+}
+
+.toggle_button:hover {
+  color: var(--accent-color);
+  border-color: var(--accent-color);
+  transform: translateY(-2px);
+}
+
+.toggle_button input[type="checkbox"] {
+  position: absolute;
+  opacity: 0;
+  width: 0;
+  height: 0;
+  pointer-events: none;
+}
+
+/* Checked state using :has() — modern browsers only */
+.toggle_button:has(input:checked) {
+  color: var(--accent-color);
+  border-color: var(--accent-color);
+}

blog_test/blog.css

@@ -0,0 +1,32 @@
+.toggle_button {
+  display: inline-block;
+  margin-top: 5px;
+  margin-right: 5px;
+  padding: 0px 6px;
+  border: 2px solid var(--text-color);
+  border-radius: 5px;
+  color: var(--text-color);
+  cursor: pointer;
+  user-select: none;
+  transition: 0.1s ease-in;
+}
+
+.toggle_button:hover {
+  color: var(--accent-color);
+  border-color: var(--accent-color);
+  transform: translateY(-2px);
+}
+
+.toggle_button input[type="checkbox"] {
+  position: absolute;
+  opacity: 0;
+  width: 0;
+  height: 0;
+  pointer-events: none;
+}
+
+/* Checked state using :has() — modern browsers only */
+.toggle_button:has(input:checked) {
+  color: var(--accent-color);
+  border-color: var(--accent-color);
+}

blog_test/src/main.rs

@@ -1,27 +1,15 @@
-use std::net::SocketAddr;
-
 use dioxus::prelude::*;
 
-#[cfg(feature = "server")]
-use axum::Router;
-#[cfg(feature = "server")]
-use axum::ServiceExt;
-#[cfg(feature = "server")]
-use axum::extract::{Extension, Host};
-#[cfg(feature = "server")]
-use axum::http::uri::{Parts, Uri};
-#[cfg(feature = "server")]
-use axum::http::StatusCode;
-#[cfg(feature = "server")]
-use axum::response::{IntoResponse, Redirect};
-#[cfg(feature = "server")]
-use axum::routing::get;
-
 use bard::*;
 
 
 
 const FAVICON: Asset = asset!("/assets/favicon.ico");
+const BLOG: Asset = asset!("/assets/blog.css");
+const BLOG_IMAGE: Asset = asset!("/assets/runes_and_ramblings_text.png",
+                                 AssetOptions::builder().with_hash_suffix(false));
+const POST_IMAGE: Asset = asset!("/assets/runes_and_ramblings_logo.png",
+                                 AssetOptions::builder().with_hash_suffix(false));
 
 
 
@@ -29,18 +17,30 @@ fn main()
 {
    #[cfg(feature = "server")]
    {
-      tokio::runtime::Runtime::new()
+      let rt = tokio::runtime::Runtime::new().unwrap();
-         .unwrap()
+      rt.block_on(async
-         .block_on(async move { bard::init_database("/home/myrddin/cybermages/website/tavern.db").await });
+      {
+         let db_path = "/home/myrddin/cybermages/website/tavern.db";
+
+         let _ = bard::init_database(db_path).await;
+      });
    }
 
-   #[cfg(feature = "web")]
+   LaunchBuilder::new().launch(App);
-   dioxus::launch(App);
 }
 
 #[component]
 fn App() -> Element
 {
+   let custom_settings = BardSettings
+   {
+      blog_name: Some(String::from("Blog Test")),
+      blog_image: Some(BLOG_IMAGE),
+      default_post_image: Some(POST_IMAGE),
+      stylesheet: StylesheetBehavior::Extend(BLOG),
+   };
+   provide_context(custom_settings);
+
    rsx!
    {
       document::Link { rel: "icon", href: FAVICON }
@@ -52,8 +52,7 @@ fn App() -> Element
 #[component]
 fn Home() -> Element
 {
-   rsx!
+   rsx! {
-   {
       h1 { "Blog Test" }
    }
 }
@@ -62,8 +61,7 @@ fn Home() -> Element
 #[component]
 pub fn PageNotFound(route: Vec<String>) -> Element
 {
-   rsx!
+   rsx! {
-   {
       h1 { "Page not found" }
       p { "We are terribly sorry, but the page you requested doesn't exist." }
       pre { color: "red", "log:\nattemped to navigate to: {route:?}" }
@@ -94,7 +92,6 @@ fn Navbar() -> Element
 
 
 
-
 #[derive(Debug, Clone, Routable, PartialEq)]
 #[rustfmt::skip]
 pub enum Page
@@ -103,13 +100,11 @@ pub enum Page
    #[route("/")]
    Home {},
 
-//   #[nest("/blog")]
    #[child("/blog")]
    Bard
    {
       child: bard::Page
    },
-//   #[end_nest]
 
    #[route("/:..route")]
    PageNotFound { route: Vec<String> }

loremaster/README.md

@@ -1,18 +0,0 @@
-# Loremaster
-
-Converts a blog repository into an SQLite database using the Tavern blog system.
-
----
-
-## Copyright & License
-
-Copyright 2025 CyberMages LLC
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this library except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS

loreweaver/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
-name = "loremaster"
+name = "loreweaver"
-version = "0.1.0"
+version = "0.3.2"
 edition = "2024"
 description = "Converts a blog repository into an SQLite database using the Tavern blog system."
 repository = "/CyberMages/tavern"
@@ -11,5 +11,5 @@ license = "Apache-2.0"
 
 [dependencies]
 clap = { version = "4.5.46", features = ["derive"] }
-tavern = { version = "0.2.4", path = "../tavern", registry = "cybermages", features = ["publisher"] }
+tavern = { version = "0.3.0", path = "../tavern", registry = "cybermages", features = ["publisher"] }
 tokio = { version = "1.47.1", features = ["rt-multi-thread", "macros"] }

loreweaver/README.md

@@ -0,0 +1,42 @@
+# Loreweaver
+
+Loreweaver is a command-line tool that compiles a blog repository into a SQLite  
+database using the Tavernworks blog system. It acts as a publisher that reads  
+a metadata configuration file and processes the blog content via the `tavern`  
+engine.
+
+## Features
+
+- Reads a `Tavern.toml` metadata file to configure the compilation
+- Converts Markdown blog repositories into portable SQLite databases
+- Simple CLI interface with configurable input and output paths
+- Built on top of the `tavern` library for content parsing and data handling
+
+## Usage
+
+Run Loreweaver with the default configuration file and output:
+
+```bash
+loreweaver --config Tavern.toml --output tavern.db
+```
+
+Specify custom paths for config or output files:
+
+```bash
+loreweaver --config path/to/config.toml --output path/to/output.db
+```
+
+---
+
+## Copyright & License
+
+Copyright 2025 CyberMages LLC
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this library except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS

loreweaver/src/info.rs

@@ -3,12 +3,15 @@
 
 
 /// The environment variable defined by Cargo for the name.
+#[allow(dead_code)]
 const NAME: Option<&str> = option_env!("CARGO_PKG_NAME");
 
 /// The environment variable defined by Cargo for the version.
+#[allow(dead_code)]
 const VERSION: Option<&str> = option_env!("CARGO_PKG_VERSION");
 
 /// The string to display if a value is not defined during compile time.
+#[allow(dead_code)]
 const NOT_DEFINED: &'static str = "UNDEFINED";
 
 
@@ -17,6 +20,7 @@ const NOT_DEFINED: &'static str = "UNDEFINED";
 /// set at compile time and comes from the Cargo.toml file.
 ///
 /// If a value is not found, then it will return the not defined value.
+#[allow(dead_code)]
 pub fn get_name() -> &'static str
 {
    NAME.unwrap_or(NOT_DEFINED)
@@ -27,6 +31,7 @@ pub fn get_name() -> &'static str
 /// This is set at compile time and comes from the Cargo.toml file.
 ///
 /// If a value is not found, then it will return the not defined value.
+#[allow(dead_code)]
 pub fn get_version() -> &'static str
 {
    VERSION.unwrap_or(NOT_DEFINED)

rust-toolchain.toml

@@ -0,0 +1,2 @@
+[toolchain]
+channel = "nightly"

tavern/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "tavern"
-version = "0.2.9"
+version = "0.3.0"
 edition = "2024"
 description = "A blogging system that will allow you to write your blog in Markdown and then display it in HTML using Dioxus."
 repository = "/CyberMages/tavern"

tavern/README.md

@@ -1,7 +1,28 @@
 # Tavern
 
-A blogging system that will allow you to write your blog in Markdown and then
+Tavern is the core content engine of the Tavernworks blog system.
-display it in HTML using Dioxus.
+It provides the data model, parsing logic, and database interaction necessary
+to convert a Markdown-based blog repository into a structured, queryable form.
+
+## Features
+
+- Parses blog content from Markdown files and metadata.
+- Converts content into an in-memory model or stores it in SQLite.
+- Provides an async API to query and manipulate blog data.
+- Designed to be extensible and integrated into CLI tools or frontends.
+
+## Usage
+
+As a library, `tavern` can be embedded in Rust applications or CLI tools
+to handle blog content processing and storage.
+
+```rust
+use tavern::{Tavern, Database};
+
+let tavern = Tavern::from_config_file("Tavern.toml");
+let database = Database::open("blog.db").await?;
+database.insert_tavern(&tavern).await?;
+```
 
 ---