@docsector/docsector-reader 1.7.0 → 1.7.1

package/README.md

@@ -41,6 +41,7 @@ Transform Markdown content into beautiful, navigable documentation sites — wit
 ## ✨ Features
 
 - 📝 **Markdown Rendering** — Write docs in Markdown, rendered with syntax highlighting (Prism.js)
+- 🧱 **Raw HTML in Markdown** — Renders inline and block HTML tags inside markdown sections (including homepage remote README content)
 - 🧩 **Mermaid Diagrams** — Native support for fenced ` ```mermaid ` blocks, with automatic dark/light theme switching
 - 🚨 **GitHub-Style Alerts** — Native support for `[!NOTE]`, `[!TIP]`, `[!IMPORTANT]`, `[!WARNING]`, and `[!CAUTION]`
 - 🌍 **Internationalization (i18n)** — Multi-language support with HJSON locale files and per-page translations
@@ -59,6 +60,7 @@ Transform Markdown content into beautiful, navigable documentation sites — wit
 - 🧭 **Content Signals** — Injects `Content-Signal` policy in `robots.txt` with deterministic, idempotent build output
 - 🏠 **Markdown Home at Root** — Homepage is rendered from `src/pages/Homepage.{lang}.md` directly at `/`
 - 🌍 **Remote README as Home** — Optional build-time remote README source for homepage with automatic local fallback
+- 🧬 **Scaffolded Homepage Override Wiring** — New consumer projects automatically wire `virtual:docsector-homepage-override` into i18n message building
 - 🧭 **Quick Links Custom Element** — Use `<d-quick-links>` and `<d-quick-link>` in Markdown to render rich home navigation cards
 - 🗂️ **API Catalog Well-Known** — Auto-generates `/.well-known/api-catalog` as Linkset JSON for machine-readable API discovery
 - ⚙️ **Single Config File** — Customize branding, links, and languages via `docsector.config.js`
@@ -767,6 +769,7 @@ Consumer projects use the `buildMessages` helper from the engine:
 
 ```javascript
 import { buildMessages } from '@docsector/docsector-reader/i18n'
+import homePageOverride from 'virtual:docsector-homepage-override'
 
 const langModules = import.meta.glob('./languages/*.hjson', { eager: true })
 const mdModules = import.meta.glob('../pages/**/*.md', { eager: true, query: '?raw', import: 'default' })
@@ -774,7 +777,7 @@ const mdModules = import.meta.glob('../pages/**/*.md', { eager: true, query: '?r
 import boot from 'pages/boot'
 import pages from 'pages'
 
-export default buildMessages({ langModules, mdModules, pages, boot })
+export default buildMessages({ langModules, mdModules, pages, boot, homePageOverride })
 ```
 
 ### Language files

package/bin/docsector.js

@@ -23,7 +23,7 @@ const packageRoot = resolve(__dirname, '..')
 const args = process.argv.slice(2)
 const command = args[0]
 
-const VERSION = '1.7.0'
+const VERSION = '1.7.1'
 
 const HELP = `
   Docsector Reader v${VERSION}
@@ -264,6 +264,7 @@ const TEMPLATE_CSS_STUB = `\
 const TEMPLATE_I18N_INDEX = `\
 // @ Import i18n message builder from Docsector Reader
 import { buildMessages } from '@docsector/docsector-reader/i18n'
+import homePageOverride from 'virtual:docsector-homepage-override'
 
 // @ Import language HJSON files (Vite-compatible eager import)
 const langModules = import.meta.glob('./languages/*.hjson', { eager: true })
@@ -274,7 +275,7 @@ const mdModules = import.meta.glob('../pages/**/*.md', { eager: true, query: '?r
 import boot from 'pages/boot'
 import pages from 'pages'
 
-export default buildMessages({ langModules, mdModules, pages, boot })
+export default buildMessages({ langModules, mdModules, pages, boot, homePageOverride })
 `
 
 const TEMPLATE_I18N_HJSON = `\

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docsector/docsector-reader",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "A documentation rendering engine built with Vue 3, Quasar v2 and Vite. Transform Markdown into beautiful, navigable documentation sites.",
   "productName": "Docsector Reader",
   "author": "Rodrigo de Araujo Vieira",

package/src/components/DPageSection.vue

@@ -140,9 +140,11 @@ const tokenized = computed(() => {
     allowedAttributes: ['filename']
   })
 
-  // Use a plain inline renderer to avoid markdown-it-attrs edge cases
-  // when rendering isolated inline fragments.
-  const MarkdownInline = new MarkdownIt()
+  // Keep inline rendering aligned with block parsing so raw HTML inline
+  // fragments (e.g. <b>, <a>) are rendered instead of escaped.
+  const MarkdownInline = new MarkdownIt({
+    html: true
+  })
 
   const markdownEnv = {}
 
@@ -326,6 +328,12 @@ const tokenized = computed(() => {
           })
           break
         }
+        case 'html_block':
+          tokens.push({
+            tag: 'html',
+            content: element.content
+          })
+          break
       }
     } else if (level === 1) {
       const parent = tokens[tokens.length - 1]
@@ -373,6 +381,10 @@ const tokenized = computed(() => {
         case 'inline':
           parent.content += element.content
           break
+        case 'html_inline':
+        case 'html_block':
+          parent.content += element.content
+          break
 
         case 'list_item_close':
           parent.content += '</li>'
@@ -453,6 +465,11 @@ const tokenized = computed(() => {
       <table v-html="token.content"></table>
     </div>
 
+    <div
+      v-else-if="token.tag === 'html'"
+      v-html="token.content"
+    ></div>
+
     <p
       v-else-if="token.tag === 'p'"
       v-html="token.content"