docnest 0.1.19 → 0.1.21

package/README.md

@@ -69,6 +69,8 @@ export default defineConfig({
 搜索框为空时显示最近搜索：仅记录有结果的关键词，去重后保留最近 10 条，点击即可再次搜索。
 历史保存在当前浏览器，按 `site.storageKeyPrefix` 隔离；不上传服务器。
 
+多空间托管场景可设置 `DOCS_ALLOW_RAW_HTML=false`，把 Markdown 中的原始 HTML 显示为文本，避免文档内脚本取得宿主页面权限；Markdown 语法与 Mermaid 不受影响。默认保留原始 HTML 兼容行为。
+
 PDF、页面水印和图表外带能力由一个开关统一控制，默认使用普通阅读模式：
 
 ```js

package/dist/server.js

@@ -184,7 +184,7 @@ async function storageReadAsset(assetPath) {
 }
 // 配置 markdown-it
 const md = new MarkdownIt({
-    html: true,
+    html: process.env.DOCS_ALLOW_RAW_HTML !== 'false',
     linkify: true,
     typographer: true,
     highlight: function (str, lang) {

package/package.json

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

package/server/static/css/doc-reading-view.css

@@ -0,0 +1,29 @@
+.doc-reading-toggle {
+  position: absolute;
+  top: 4px;
+  right: var(--doc-reading-button-right, 40px);
+  z-index: 2;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  padding: 8px;
+  border: 1px solid var(--linear-border);
+  border-radius: 4px;
+  background: var(--linear-bg);
+  color: var(--linear-text);
+  cursor: pointer;
+}
+.doc-reading-toggle:hover { color: var(--linear-accent); }
+.doc-reading-toggle:focus-visible { outline: 2px solid var(--linear-accent); outline-offset: 2px; }
+.doc-reading-toggle svg { width: 20px; height: 20px; }
+body.doc-reading-expanded .sidebar,
+body.doc-reading-expanded .sidebar-chrome,
+body.doc-reading-expanded .doc-toc { display: none !important; }
+body.doc-reading-expanded .main-content {
+  padding-left: var(--doc-reading-left-margin) !important;
+  padding-right: var(--doc-reading-right-margin) !important;
+}
+body.doc-reading-expanded .doc-layout { width: 100% !important; max-width: none; }
+@media print { .doc-reading-toggle { display: none; } }

package/server/static/js/core/doc-reading-view.js

@@ -0,0 +1,42 @@
+(function () {
+  const layout = document.querySelector('.doc-layout');
+  const main = document.querySelector('.main-content');
+  const article = layout?.querySelector('.markdown-body');
+  if (!layout || !main || !article) return;
+
+  const button = document.createElement('button');
+  button.type = 'button';
+  button.className = 'doc-reading-toggle';
+  button.setAttribute('aria-controls', 'sidebar doc-toc');
+  function updateButton() {
+    const expanded = document.body.classList.contains('doc-reading-expanded');
+    const iconPath = expanded
+      ? 'M3 8h5V3M8 8 2 2M21 8h-5V3M16 8l6-6M3 16h5v5M8 16l-6 6M21 16h-5v5M16 16l6 6'
+      : 'M8 3H3v5M3 3l6 6M16 3h5v5M21 3l-6 6M3 16v5h5M3 21l6-6M21 16v5h-5M21 21l-6-6';
+    button.innerHTML = `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="${iconPath}"/></svg>`;
+    button.setAttribute('aria-label', expanded ? '缩小正文，恢复目录' : '放大正文，隐藏目录');
+    button.setAttribute('aria-pressed', String(expanded));
+    button.title = expanded ? '恢复默认阅读布局' : '扩大正文阅读区域';
+  }
+  function positionButton() {
+    const right = main.getBoundingClientRect().left + main.clientWidth - article.getBoundingClientRect().right;
+    main.style.setProperty('--doc-reading-button-right', `${Math.max(0, right)}px`);
+  }
+  window.addEventListener('resize', positionButton);
+  button.addEventListener('click', function () {
+    if (!document.body.classList.contains('doc-reading-expanded')) {
+      const mainBounds = main.getBoundingClientRect();
+      const articleRight = article.getBoundingClientRect().right;
+      const rightPadding = mainBounds.left + main.clientWidth - articleRight;
+      const outerMargin = document.documentElement.clientWidth - articleRight;
+      main.style.setProperty('--doc-reading-left-margin', `${Math.max(0, outerMargin)}px`);
+      main.style.setProperty('--doc-reading-right-margin', `${Math.max(0, rightPadding)}px`);
+    }
+    document.body.classList.toggle('doc-reading-expanded');
+    updateButton();
+    positionButton();
+  });
+  updateButton();
+  main.appendChild(button);
+  positionButton();
+})();

package/server/views/doc.ejs

@@ -9,6 +9,8 @@
   <link rel="stylesheet" href="/static/css/styles.css?v=<%= assetVersion %>">
   <link rel="stylesheet" href="/static/css/highlight.css?v=<%= assetVersion %>">
   <link rel="stylesheet" href="/static/css/themes.css?v=<%= assetVersion %>">
+  <link rel="stylesheet" href="/static/css/doc-reading-view.css?v=<%= assetVersion %>">
+  <script defer src="/static/js/core/doc-reading-view.js?v=<%= assetVersion %>"></script>
   <script src="/mermaid/mermaid.min.js?v=<%= assetVersion %>"></script>
   <%- include('partials/appearance-head') %>
   <!-- 基础功能模块 -->