Samool Future双栏主题

Samool Future

面向 Typecho 1.3 的个人品牌主题，将软件产品、行业技术新闻、博客日志和摄影作品融合在一套统一的阅读系统里。

演示

在线预览

下载

页面结构

• index.php：个人品牌首页、双产品卡片、最新文章（最多 4 篇）、技术新闻、摄影入口和回到顶部按钮；首页顺序为产品在上、文章在下。
• archive.php：分类、标签、搜索结果和分页共用的内容列表页。
• post.php / page.php：Markdown 长文阅读页、Reading Map、Mermaid 三标签视图、代码复制、图片预览、回到顶部按钮和 AI Assist 入口。
• comments.php：标准 Typecho 评论列表和评论表单，并以主题卡片样式呈现评论、空状态和评论关闭状态。

评论提交仍遵循 Typecho 的全局讨论设置：需要在 Typecho 后台允许评论，并在本主题设置中将“文章评论”设为“显示”；若某篇文章单独关闭评论，页面会显示关闭状态而不会伪造输入框。

首页 Hero 右侧由三层线框组成，分别以 20s / 10s / 5s 的不同速度和方向旋转；中心菱形保持方向不变，仅做缩放与光晕呼吸。检测到用户偏好减少动画时会自动停用动效。

安装

1. 将 SamoolFuture 文件夹复制到 Typecho 的 usr/themes/ 目录。
2. 在后台“控制台 → 外观”中启用 Samool Future。
3. 进入主题设置，填写首页宣言、宣言链接和两个软件产品的信息。heroLink 会作为首页宣言区 “Explore the journal” 按钮的跳转地址；留空时回退到最新文章区。第一、第二个产品分别对应 software* 与 softwareTwo* 设置项，未填写时会使用内置默认值。首页底部四张图片会从已发布文章的图片附件中随机选择，卡片文字显示所属文章标题并链接到该文章；附件不足四张时，剩余位置显示无链接占位卡片。
4. 侧栏会通过 Typecho 分类组件自动读取全部分类，并使用分类自身的永久链接（因此会跟随站点的 .html 伪静态设置）。分类标题直接显示 slug，也就是 /category/<slug>.html 中的 <slug>；分类右侧显示文章数，首页不显示数量。Typecho 独立页会继续按相同导航样式列出，但不显示数量。
5. 主题设置中的“友情链接”支持每行一条 名称|https://example.com|简短说明，说明可省略，也可以直接粘贴单独 URL 或富文本链接；保存后显示在侧栏 Link 栏目。解析器兼容全角分隔符、旧的 friendLink/links 字段和 JSON 链接导入，并只输出 HTTP/HTTPS 地址。“建站日期”会显示在侧栏“博客统计”中。统计栏目按文章、评论、分类、独立页、建站日期逐行以卡片选项卡排列。
6. 分类和独立页导航使用 20 个主题相关的 SVG 小图标，按名称做稳定的伪随机分配；同一次渲染中会尽量避免重复，刷新页面不会无故跳变。

Markdown 增强

• 代码块支持 language-* class，页面会自动在右上角添加 Copy 按钮。
• Markdown 表格会自动显示外框、表头背景、单元格分隔线和隔行底色；宽表格在手机端保留独立横向滚动区域。
• language-mermaid / lang-mermaid 代码块会按需从 jsDelivr 加载 Mermaid 11，并提供“图形 / 代码 / 全屏”三个标签：普通页面只显示图形，代码只显示 Mermaid 源码（含复制按钮）；进入全屏后只保留“退出”按钮，并启用缩放按钮、滚轮缩放和拖拽平移；CDN 不可用时仍保留原始代码。
• 文章图片支持点击打开大图；多图可用上一张/下一张或键盘方向键翻页，并提供缩放、旋转和全屏预览。
• 首页、文章页和独立页面提供滚动后出现的“回到顶部”按钮，点击后平滑返回页面顶部。
• 浏览器页面滚动条会跟随夜间/日间主题切换；文章右侧 Reading Map 使用更窄的线条滚动条，避免目录滚动条抢占阅读空间。
• 兼容 Handsome 风格的 .aisummary AI 摘要标记：自动复用主题的夜间/日间颜色和打字机效果；摘要正文需由插件、自定义字段或服务端逻辑提供，主题本身不调用模型 API。
• 主题 CSS/JS 地址自动追加文件时间戳参数，部署覆盖后可避免继续使用旧缓存资源。
• 页面头部自动输出描述、robots、canonical、Open Graph、Twitter Card 和 WebSite/WebPage/Article JSON-LD；搜索结果页与 404 页面使用 noindex,follow，文章页优先使用正文摘要。头部同时提供 /llms.txt 的纯文本站点指南入口，便于 AI 检索器从静态 HTML、canonical 和结构化数据中建立内容索引。
• H2-H4 自动生成右侧 Reading Map，没有标题时自动显示空目录提示；桌面端目录贴近正文右侧并在滚动时距视口顶部 24px 粘性固定，窄屏则改为正文前的静态目录以保持阅读空间。
• 首页和归档优先使用 Typecho 标准分类、文章字段和分页能力，不依赖 Handsome 专属函数。
• 分类归档页会按当前分类（含子分类）内已发布文章的标签使用次数，显示最多 10 个热门标签；点击标签进入 Typecho 对应标签归档，普通总归档页仍保留分类筛选。

可选文章字段

如果在 Typecho 文章自定义字段中加入 cover，归档列表会优先使用该图片作为封面；没有字段时显示抽象科技占位图。

SEO 与站点根目录文件

主题设置中的“ICP备案号”会在页脚显示备案号，并链接到工信部备案管理系统 https://beian.miit.gov.cn/；留空时不显示。deploy/robots.txt 和 deploy/llms.txt 需要复制到 Typecho 文档根目录（不是 usr/themes/SamoolFuture/），详细步骤见 deploy/README.md。如使用 sitemap 插件，请把真实 sitemap 地址追加到根目录 robots.txt。