docnest 0.1.23 → 0.1.24

package/README.md

@@ -147,6 +147,7 @@ startServer(3000)
 Markdown 或 HTML 中明确引用的本地附件，不按文件扩展名设置业务白名单；外链、文档链接、隐藏路径、路径穿越和代码块中的伪引用会被忽略，缺失的附件默认会让构建失败。
 常见凭据文件（如 `.env`、私钥和证书容器）属于公共安全阻断项，即使被误写进文档链接也不会进入静态产物。
 静态生成 HTML 时，可再调用 `rewriteDocumentAttachmentUrls`，将正文中的附件链接统一改写到 `/doc-asset/` 端点。
+正文中的附件链接使用浏览器完整导航；独立 HTML 页面保持自己的样式和脚本，不进入 Markdown 局部刷新流程，挂载在子路径时也遵循这一规则。
 
 ## 开发
 

package/package.json

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

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?') ||