docnest 0.1.22 → 0.1.24

package/README.md

@@ -84,6 +84,8 @@ export default defineConfig({
 
 受限模式只移除 DocNest 提供的页面入口和脚本，不承诺对浏览器开发者工具或系统级截图提供绝对防护。
 
+页面水印使用 4% 透明度，保持可辨识而不遮挡正文和图表。Mermaid 代码围栏按独立图表渲染，不继承普通代码块的等宽字体；节点内的 HTML 换行与图表字体测量保持一致。
+
 ### 极简单口令授权
 
 需要让文档中心只对知道口令的人开放时，可以启用单口令授权：
@@ -145,6 +147,7 @@ startServer(3000)
 Markdown 或 HTML 中明确引用的本地附件，不按文件扩展名设置业务白名单；外链、文档链接、隐藏路径、路径穿越和代码块中的伪引用会被忽略，缺失的附件默认会让构建失败。
 常见凭据文件（如 `.env`、私钥和证书容器）属于公共安全阻断项，即使被误写进文档链接也不会进入静态产物。
 静态生成 HTML 时，可再调用 `rewriteDocumentAttachmentUrls`，将正文中的附件链接统一改写到 `/doc-asset/` 端点。
+正文中的附件链接使用浏览器完整导航；独立 HTML 页面保持自己的样式和脚本，不进入 Markdown 局部刷新流程，挂载在子路径时也遵循这一规则。
 
 ## 开发
 

package/dist/server.js

@@ -188,10 +188,6 @@ const md = new MarkdownIt({
     linkify: true,
     typographer: true,
     highlight: function (str, lang) {
-        // 特殊处理 Mermaid 图表
-        if (lang === 'mermaid') {
-            return `<div class="mermaid">${str}</div>`;
-        }
         // 其他代码块使用 highlight.js
         if (lang && hljs.getLanguage(lang)) {
             try {
@@ -202,6 +198,16 @@ const md = new MarkdownIt({
         return `<pre class="hljs"><code>${md.utils.escapeHtml(str)}</code></pre>`;
     },
 });
+// Mermaid is a diagram, not highlighted code. A code/pre ancestor changes
+// the inherited font after Mermaid measures HTML labels, clipping their text.
+const renderCodeFence = md.renderer.rules.fence;
+md.renderer.rules.fence = function (tokens, index, options, env, renderer) {
+    const token = tokens[index];
+    if (token.info.trim().split(/\s+/)[0] === 'mermaid') {
+        return `<div class="mermaid">${md.utils.escapeHtml(token.content)}</div>\n`;
+    }
+    return renderCodeFence(tokens, index, options, env, renderer);
+};
 function slugifyHeading(text) {
     return (text || '')
         .replace(/`([^`]+)`/g, '$1')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docnest",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "可复用的本地 Markdown 文档中心",
   "repository": {
     "type": "git",

package/server/static/css/styles.css

@@ -1339,6 +1339,9 @@ body[data-theme="dark"] .not-found-path {
 
 /* Mermaid 图表样式 */
 .markdown-body .mermaid {
+  /* Match Mermaid's measurement fallback when a diagram font is omitted or
+     rejected by its directive sanitizer. Explicit SVG fonts still take priority. */
+  font-family: "trebuchet ms", verdana, arial, sans-serif;
   margin: 24px 0;
   text-align: center;
   background: var(--linear-bg-subtle);

package/server/static/css/themes.css

@@ -89,7 +89,7 @@ html.docnest-restricted .markdown-body .mermaid-download-btn {
   color: var(--linear-text, rgba(15, 23, 42, 0.42));
   font: 700 clamp(0.75rem, 1.5vw, 1.5rem)/1 var(--doc-font-mono);
   letter-spacing: 0.08em;
-  opacity: 0.12;
+  opacity: 0.04;
   transform: rotate(-24deg);
   white-space: nowrap;
 }

package/server/views/doc.ejs

@@ -294,6 +294,15 @@
           // 检查是否是文档系统内的链接
           const href = link.getAttribute('href');
           if (!href) return;
+
+          // Assets, including standalone HTML pages, need full browser navigation;
+          // they do not contain the Markdown article expected by navigateToDoc.
+          try {
+            const linkUrl = new URL(href, document.baseURI || window.location.href);
+            if (/(^|\/)doc-asset\//.test(linkUrl.pathname)) return;
+          } catch (_) {
+            return;
+          }
           
           // 判断是否是文档系统内的链接（排除外部链接、锚点、目录页链接）
           const isDocLink = (href.startsWith('/doc?') ||