@docsector/docsector-reader 0.7.2 → 0.7.3

package/README.md

@@ -18,13 +18,19 @@ Transform Markdown content into beautiful, navigable documentation sites — wit
 
 ---
 
+## 🤖 AI-Friendly Features
+
+- 📋 **Copy Page** — One-click button copies the current page as raw Markdown, ready to paste into LLMs
+- 📄 **View as Markdown** — Open any page as plain text by appending `.md` to the URL, with locale support (`?lang=`)
+- 🕷️ **LLM Bot Detection** — Automatically serves raw Markdown to known AI crawlers (GPTBot, ClaudeBot, PerplexityBot, GrokBot, and others)
+
+---
+
 ## ✨ Features
 
 - 📝 **Markdown Rendering** — Write docs in Markdown, rendered with syntax highlighting (Prism.js)
 - 🧩 **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]`
-- 🤖 **AI-Friendly** — "Copy page" button copies raw Markdown for LLMs; "View as Markdown" opens any page as plain text via `.md` URL suffix
-- 📅 **Last Updated Date** — Automatic per-page "last updated" date from git commit history, locale-formatted
 - 🌍 **Internationalization (i18n)** — Multi-language support with HJSON locale files and per-page translations
 - 🌗 **Dark/Light Mode** — Automatic theme switching with Quasar Dark Plugin
 - 🔗 **Anchor Navigation** — Right-side Table of Contents tree with scroll tracking
@@ -32,6 +38,7 @@ Transform Markdown content into beautiful, navigable documentation sites — wit
 - 📱 **Responsive** — Mobile-friendly with collapsible sidebar and drawers
 - 🏷️ **Status Badges** — Mark pages as `done`, `draft`, or `empty` with visual indicators
 - ✏️ **Edit on GitHub** — Direct links to edit pages on your repository
+- 📅 **Last Updated Date** — Automatic per-page "last updated" date from git commit history, locale-formatted
 - 📊 **Translation Progress** — Automatic translation percentage based on header coverage
 - ⚙️ **Single Config File** — Customize branding, links, and languages via `docsector.config.js`
 

package/bin/docsector.js

@@ -23,7 +23,7 @@ const packageRoot = resolve(__dirname, '..')
 const args = process.argv.slice(2)
 const command = args[0]
 
-const VERSION = '0.7.2'
+const VERSION = '0.7.3'
 
 const HELP = `
   Docsector Reader v${VERSION}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docsector/docsector-reader",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "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/DPageBar.vue

@@ -73,7 +73,7 @@ const viewAsMarkdown = () => {
 <template>
 <div class="d-page-bar">
   <span v-if="formattedDate" class="d-page-bar__date">
-    {{ t('page.lastUpdated') }}: {{ formattedDate }}
+    {{ t('page.lastUpdated') }}: <br class="d-page-bar__date-break"> {{ formattedDate }}
   </span>
   <span v-else class="d-page-bar__date"></span>
 
@@ -126,10 +126,17 @@ const viewAsMarkdown = () => {
     font-size: 0.8rem
     opacity: 0.6
 
+  &__date-break
+    display: none
+
   &__actions
     font-size: 0.75rem
 
 body.body--dark
   .d-page-bar__date
     color: rgba(255, 255, 255, 0.7)
+
+@media (max-width: 376px)
+  .d-page-bar__date-break
+    display: block
 </style>

package/src/quasar.factory.js

@@ -331,6 +331,9 @@ function createMarkdownEndpointPlugin (projectRoot) {
     return null
   }
 
+  // LLM bot user-agent patterns
+  const LLM_BOT_PATTERN = /GPTBot|ChatGPT-User|OAI-SearchBot|ClaudeBot|Claude-User|Claude-SearchBot|anthropic-ai|Google-Extended|Gemini-Deep-Research|PerplexityBot|Perplexity-User|Bytespider|CCBot|Meta-ExternalAgent|FacebookBot|Amazonbot|Applebot-Extended|cohere-ai|DuckAssistBot|GrokBot|AI2Bot|YouBot|PetalBot/i
+
   return {
     name: 'docsector-markdown-endpoint',
 
@@ -349,15 +352,35 @@ function createMarkdownEndpointPlugin (projectRoot) {
 
       server.middlewares.use((req, res, next) => {
         const url = new URL(req.url, 'http://localhost')
-        if (!url.pathname.endsWith('.md')) return next()
 
-        const lang = url.searchParams.get('lang') || defaultLang
-        const file = resolveMarkdownFile(url.pathname, lang)
-        if (!file) return next()
+        // Explicit .md request
+        if (url.pathname.endsWith('.md')) {
+          const lang = url.searchParams.get('lang') || defaultLang
+          const file = resolveMarkdownFile(url.pathname, lang)
+          if (!file) return next()
+
+          const content = readFileSync(file, 'utf-8')
+          res.setHeader('Content-Type', 'text/plain; charset=utf-8')
+          res.end(content)
+          return
+        }
+
+        // Auto-serve markdown to LLM bot crawlers
+        const ua = req.headers['user-agent'] || ''
+        if (LLM_BOT_PATTERN.test(ua)) {
+          const lang = url.searchParams.get('lang') || defaultLang
+          // Try appending /overview as the default subpage
+          const mdPath = url.pathname.replace(/\/$/, '') + '/overview.md'
+          const file = resolveMarkdownFile(mdPath, lang)
+          if (file) {
+            const content = readFileSync(file, 'utf-8')
+            res.setHeader('Content-Type', 'text/plain; charset=utf-8')
+            res.end(content)
+            return
+          }
+        }
 
-        const content = readFileSync(file, 'utf-8')
-        res.setHeader('Content-Type', 'text/plain; charset=utf-8')
-        res.end(content)
+        next()
       })
     },