https://vista-research-group.pages.dev/categories/website-maintenance/Website-MaintenanceHugo Blox Builder (https://hugoblox.com)enMon, 22 Jun 2026 22:32:00 +0800https://vista-research-group.pages.dev/media/icon_hu_831f3df7c45fd3fa.pnghttps://vista-research-group.pages.dev/categories/website-maintenance/https://vista-research-group.pages.dev/post/vista/Mon, 22 Jun 2026 22:32:00 +0800https://vista-research-group.pages.dev/post/vista/ <blockquote class="border-l-4 border-neutral-300 dark:border-neutral-600 pl-4 italic text-neutral-600 dark:text-neutral-400 my-6"> <p>2026-06-22 | 修复 tag/category 链接 404 和布局错位；修复文件下载被 Tampermonkey 拦截</p> </blockquote> <h2 id="修复的问题">修复的问题</h2> <ul> <li>修复详情页底部 tag / category 标签点击后 404 的问题（渲染器直接用原始值拼 URL，未经 urlize，与 Hugo taxonomy 实际路径不符；如 <code>/categories/News/</code> 实为 <code>/categories/news/</code>，中文 tag 需 percent-encode）——现改用 <code>urlizeTitle + encodeURIComponent</code>，与 Hugo 保持一致</li> <li>修复详情页底部 tag / category 标签布局错位的问题（多余的 <code>container mx-auto prose max-w-prose</code> 包装导致在 <code>&lt;main&gt;</code> 内部再次缩窄）——已去掉多余包装，标签与正文对齐</li> <li>修复 post 正文中 <code>[下载代码](./xxx.user.js)</code> 点击后跳转到 Tampermonkey 安装页而非下载文件的问题——Markdown 链接会让浏览器导航到 URL，被 Tampermonkey 扩展拦截；改用 <code>&lt;a href=&quot;...&quot; download&gt;</code> 标签，浏览器直接触发保存，绕过拦截</li> </ul> <hr> <blockquote class="border-l-4 border-neutral-300 dark:border-neutral-600 pl-4 italic text-neutral-600 dark:text-neutral-400 my-6"> <p>2026-06-22 | 新增右侧目录面板（On this page）；删除页脚分享图标</p> </blockquote> <h2 id="修复的问题-1">修复的问题</h2> <ul> <li>修复同一天发布的多篇文章排序不确定的问题——<code>date</code> 字段改为带时分秒格式（<code>2026-06-22T20:00:00+08:00</code>），Hugo 列表页按精确时间降序排列，最新发布的文章出现在最前</li> <li>CMS 后台 date 字段启用时间选择器（post/publication/project 均已更新），编辑文章时可同时选日期和时间，保存后 frontmatter 携带精确时间戳</li> <li>本地写作模板（<code>docs/local-authoring-templates.md</code>）更新日期规则：推荐 <code>date: YYYY-MM-DDThh:mm:ss+08:00</code> 格式，说明纯日期的适用场景</li> </ul> <h2 id="新增能力">新增能力</h2> <ul> <li>论文/动态/项目详情页右侧新增「On this page」目录面板，自动提取文章二三级标题并生成锚点链接，点击可跳转到对应章节；无标题内容时面板不显示，不影响布局</li> <li>删除文章页脚的「Share on X」分享按钮图标</li> </ul> <hr> <blockquote class="border-l-4 border-neutral-300 dark:border-neutral-600 pl-4 italic text-neutral-600 dark:text-neutral-400 my-6"> <p>2026-06-21 | 作者页面系列修复：头像、社交图标、成果列表、CMS 删除联动</p> </blockquote> <h2 id="修复的问题-2">修复的问题</h2> <ul> <li>修复通过拼音 URL 访问作者页面（如 <code>/author/WangBoyu/</code>）显示 404 的问题（URL 映射表缺少 pinyin 键）</li> <li>修复文章顶部无头像作者（如陈旭涧、张硕）仍显示裂图缩略图的问题（空头像字段错误回退到默认图）</li> <li>修复作者页社交链接图标与「团队」列表页图标不一致的问题（图标样式已统一）</li> <li>修复 <code>social: null</code>、<code>email: null</code> 等空字段被误解析为字符串，导致作者页出现多余 NULL 文字/图标的问题</li> <li>修复 CMS 删除头像后图片文件遗留在服务器文件夹、未随之清理的问题</li> <li>修复作者 KV 数据来自硬编码脚本、CMS 修改后不更新的问题（现已自动从内容文件读取）</li> <li>修复 KV 未及时更新时旧头像 URL 导致裂图的问题（浏览器加载失败时自动隐藏，不显示破损图标）</li> <li>修复 <code>sync-kv</code> 自动任务因权限不足无法提交孤立文件删除的问题</li> </ul> <h2 id="新增能力-1">新增能力</h2> <ul> <li>作者详情页「成果列表」从占位文字改为真实成果卡片，显示标题、类型（论文/博客/项目）、发表场馆、日期，点击直接跳转详情页；无成果时显示「暂无成果」</li> <li>CMS 中删除作者头像后，<code>sync-kv</code> 任务会自动清理文件夹内遗留的图片文件，不再需要手动处理</li> </ul> <hr> <blockquote class="border-l-4 border-neutral-300 dark:border-neutral-600 pl-4 italic text-neutral-600 dark:text-neutral-400 my-6"> <p>2026-06-18 | Phase 4 渲染对齐：面包屑、链接按钮、publication 字段补全</p> </blockquote> <h2 id="修复的问题-3">修复的问题</h2> <ul> <li>修复 publication 摘要（Abstract）中加粗、斜体、链接等格式在详情页不生效的问题</li> <li>修复 publication 链接按钮只显示手动填写的链接、未读取 DOI / arXiv 等标准字段的问题</li> </ul> <h2 id="新增能力-2">新增能力</h2> <ul> <li>论文/动态/项目详情页顶部新增面包屑导航（首页 &gt; 分区 &gt; 当前页），方便返回上级</li> <li>链接按钮自动识别更多来源：<code>hugoblox.ids</code>（DOI、arXiv、OpenReview、DBLP 等）以及旧版 <code>url_pdf</code>、<code>url_code</code>、<code>url_slides</code> 等字段，无需手动在 <code>links</code> 中重复填写</li> <li>publication 详情页新增「会议」和「地点」信息展示（对应 <code>event</code> / <code>event_url</code> / <code>location</code> 字段）</li> <li>封面图加载优化：增加尺寸属性，减少页面加载时的布局抖动</li> </ul> <hr> <blockquote class="border-l-4 border-neutral-300 dark:border-neutral-600 pl-4 italic text-neutral-600 dark:text-neutral-400 my-6"> <p>2026-06-17 | 围绕&quot;CMS 提交后内容秒级可见&quot;的一轮集中修复</p> </blockquote> <h2 id="修复的问题-4">修复的问题</h2> <ul> <li>修复所有论文/动态/项目详情页打开显示 Not Found 的问题(URL 与文件夹名不一致导致)</li> <li>修复详情页加载失败时无法回退到静态页、反复 404 的问题</li> <li>修复页面样式错乱(CSS 报 MIME type 错误)——改为渲染时自动获取最新样式文件,不再因构建变动而失效</li> <li>修复 GitHub Action 构建失败(Hugo 版本号写错、wrangler 命令过时、脚本漏提交)</li> <li>修复中文标题新建文章时报&quot;malformed path component&quot;无法保存的问题</li> <li>修复新发布文章在列表页不显示的问题(时区导致被误判为&quot;未来日期&quot;)</li> <li>修复两篇标题相同的文章会撞同一网址、互相覆盖的问题——网址改由「URL 标识」决定,各篇唯一</li> <li>修复成果动态(post)网址带日期前缀导致 URL 标识查重失效的问题——post 改为与论文/项目一致的命名(网址不再带日期),查重对 post 同样生效</li> </ul> <h2 id="新增能力-3">新增能力</h2> <ul> <li><strong>编辑已有内容秒级可见</strong>:CMS 保存后约 10 秒内刷新即可看到新内容,不再等整站构建</li> <li><strong>新建文章秒级可见</strong>:新文章详情页发布即可访问、分享,无需等待 40-60 秒构建</li> <li>新建文章「URL 标识」字段:决定网址末段(如 <code>/publication/trvp/</code>),网址更简洁、可控</li> <li>现有文章网址统一为简短英文(如 TRVP 论文页从一长串标题变为 <code>/publication/trvp/</code>)</li> <li>列表页&quot;最新发布&quot;横幅:新文章发布后,列表页顶部立即出现入口链接(指向秒级可见的详情页),不必等整站构建;构建完成后横幅自动消失,文章进入正式列表</li> <li>URL 标识查重:新建文章填「URL 标识」时实时检查是否已被占用,撞名即标红、阻止保存(避免新文章因撞名无法显示);另有构建巡检兜底</li> <li>论文著作可在 CMS 添加 BibTeX 引用:新建论文时「BibTeX 引用」字段可<strong>直接粘贴</strong> bib 文本,或<strong>导入 .bib 文件</strong>(读入内容),随论文一起保存;无需再本地手动建 cite.bib</li> <li>论文详情页 Cite 按钮改为「点击复制 BibTeX 到剪贴板」(原为新标签打开文件):内容已内联在页面,点一下即复制,可直接粘进文献管理器(边缘渲染版 + Hugo 静态页版均已生效)</li> </ul>