Minimal Mistakes 布局实战使用author_profile: false禁用作者侧边栏【免费下载链接】minimal-mistakes:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.项目地址: https://gitcode.com/gh_mirrors/mi/minimal-mistakes作者侧边栏是 Minimal Mistakes 主题中展示站点作者姓名、头像、社交链接等的标准组件但在许多场景下如转载文章、多作者投稿、纯技术笔记或不想暴露作者信息的内容中你并不希望它出现。本文基于本仓库 docs/_posts/2012-03-15-layout-author-sidebar-disabled.md 这篇测试文档系统讲解如何通过 YAML Front Matter 中的author_profile: false精准关闭作者侧边栏并深入分析该开关在主题源码层面的判定逻辑、与全局默认配置Front Matter Defaults的优先级关系以及归档页、单篇页面等不同布局下的实际行为帮助你按需控制侧边栏渲染。一、原始测试文档解读一行配置的用途仓库中的测试文档 layout-author-sidebar-disabled.md 内容极为精简它只做了一件事——验证关闭作者侧边栏这一布局能力--- title: Layout: Author Sidebar Disabled excerpt: A post to test disabling author sidebar. author_profile: false --- This post has the author sidebar disabled. To disable add author_profile: false to YAML Front Matter.其正文明确指出要禁用作者侧边栏只需在 YAML Front Matter 中添加author_profile: false。这篇文档同时出现在 test/_posts/ 目录下见 test/_posts/2012-03-15-layout-author-sidebar-disabled.md说明它同时承担着主题测试样例的职责——用于验证构建结果中不渲染作者侧边栏。虽然文档本身只有一句话但作者侧边栏开关在主题中是一个贯穿配置、布局与包含文件的完整机制接下来我们从源码层面还原其完整工作原理。二、源码级原理author_profile在侧边栏渲染中的判定逻辑author_profile的实际生效点位于侧边栏包含文件 _includes/sidebar.html 的第 2–4 行{% assign locale include.locale | default: site.locale %} {% if page.author_profile or layout.author_profile or page.sidebar %} div classsidebar sticky {% if page.author_profile or layout.author_profile %}{% include author-profile.html localelocale %}{% endif %}这段逻辑揭示了三个关键事实侧边栏容器是否渲染取决于page.author_profile、layout.author_profile或page.sidebar三者中任意一个为真。也就是说即使作者档案被禁用只要页面还定义了自定义sidebar整个侧边栏含自定义内容仍然会显示。作者档案模块author-profile.html是否被包含则只看page.author_profile或layout.author_profile——当两者都为false时作者档案部分被完全跳过。page.*页面 Front Matter 值优先于layout.*布局 Front Matter 值参与判定这与 Jekyll 变量优先级一致。因此设置author_profile: false的效果是在既没有自定义 sidebar、也没有从布局层继承开启 author_profile 的前提下整个侧边栏区域都不再渲染正文内容将占据完整宽度。对应的作者档案渲染实现位于 _includes/author-profile.html它负责输出作者姓名、头像、简介、社交链接等当被禁用时这段输出被完全跳过。三、三个开关来源page / layout / site 三层的组合关系author_profile可以从三个层面设置理解它们的组合方式才能准确控制行为设置层级设置位置示例优先级页面级文章/页面的 YAML Front Matterauthor_profile: false最高覆盖布局与默认值布局级_layouts/下布局文件的 Front Matterauthor_profile: true次之页面未设置时生效站点默认_config.yml的defaults段author_profile: true最低作为全站兜底判定顺序为page.author_profile页面 Front Matter→layout.author_profile布局 Front Matter→ 站点defaults注入的值。你在单篇文章里写的author_profile: false会覆盖来自布局和站点默认的任何true值这正是本篇测试文档能够一行关闭的根本原因。布局层的默认值并非所有布局都默认开启作者档案。以归档布局 _layouts/archive-taxonomy.html 为例它的 Front Matter 中显式声明了author_profile: false--- layout: default author_profile: false ---这意味着即使全站默认开启了author_profile分类/标签归档页默认也不显示作者侧边栏——除非在具体页面中重新显式开启。而单篇文章常用的 single 布局 本身未在 Front Matter 中声明该值完全依赖页面设置或站点默认值。四、全局开启 单篇关闭与 Front Matter Defaults 的配合Minimal Mistakes 官方推荐在_config.yml中使用 Front Matter Defaults 第 322–333 行就是这样配置的# Defaults defaults: # _posts - scope: path: type: posts values: layout: single author_profile: true read_time: true comments: # true share: true related: true即所有文章默认启用作者侧边栏author_profile: true。此时若某篇文章需要例外处理只需在其 Front Matter 中写author_profile: false页面级值即可覆盖站点默认值——这正是本测试文档的典型应用场景。这种全局默认 局部覆盖模式同样适用于其他内容类型# 页面类型仅指定布局作者侧边栏按需在单个页面中控制 defaults: - scope: path: type: pages values: layout: single提示文档 docs/_docs/05-configuration.md 的 Front Matter Defaults 一节还给出了将author_profile应用于 jekyll-archives 生成的分类/标签归档页的写法——对type: tag或type: category的 scope 设置author_profile: true即可在归档页启用作者侧边栏。五、哪些场景建议禁用作者侧边栏基于author_profile: false的语义以下几类内容通常适合关闭转载或翻译文章作者非本站作者展示本站作者档案会产生误导多作者协作站点若作者信息通过_data/authors.yml与author:键逐个指定某些内容如站点公告可能不需要任何作者档案多作者配置方法可参考 docs/_docs/09-authors.md纯技术速记、Changelog、FAQ正文即全部内容不需要作者元信息占用侧栏空间希望正文获得完整宽度的页面禁用侧边栏后正文区不再被压缩阅读体验更舒展隐私考量不想在页面中暴露作者社交链接或头像的场合。六、完整操作步骤与验证方法1. 在单个文章中禁用编辑任意文章的 YAML Front Matter--- title: 我的文章 excerpt: 文章摘要 author_profile: false ---保存后重新构建站点即可。2. 在页面Page中禁用对使用single布局的独立页面如 docs/_pages/page-a.md 这类页面同样添加author_profile: false效果一致。3. 在归档页Archive中禁用归档页通常继承布局层的默认值。若要强制关闭直接在归档页 Front Matter 中写入--- title: 归档 layout: archive author_profile: false ---4. 本地构建验证在仓库根目录执行本地构建需先按 Gemfile 安装依赖bundle exec jekyll serve打开对应文章页面检查页面 HTML 中是否包含.sidebar容器未禁用时div classsidebar sticky及作者档案author-profile.html的输出会出现在div idmain内禁用后该容器不再出现正文article classpage ...独占内容区。你也可以参照仓库中的测试目录 test/_posts/2012-03-15-layout-author-sidebar-disabled.md 搭建同样的样例文章来复现验证。七、注意事项与边界情况page.sidebar不受影响如 _includes/sidebar.html 所示只要页面还定义了sidebar含nav、image、text等侧边栏容器依然渲染只是不含作者档案模块。若想连自定义侧边栏也一并隐藏需要同时移除页面中的sidebar定义。布局继承若某个布局在 Front Matter 中声明了author_profile: true而你未在页面中覆盖则作者档案仍会显示。禁用时务必确认页面值确实为false。归档布局默认关闭archive-taxonomy 布局 自带author_profile: false无需额外设置若需开启反向设置author_profile: true即可。该开关仅控制作者档案author_profile不控制页面日期、标签、分享按钮等其他侧栏相关元素它们由page__date、page__taxonomy、share等独立开关控制见 single 布局 中的page__meta与social-share输出。八、小结author_profile: false是 Minimal Mistakes 中一个轻量却高频使用的布局开关一行 YAML 即可关闭作者侧边栏且能覆盖全局defaults的开启配置。其底层逻辑由 _includes/sidebar.html 中的 Liquid 条件判断实现——page.author_profile or layout.author_profile决定作者档案是否渲染三者page/layout/site defaults按优先级协作。配合本仓库的 single 布局、archive-taxonomy 布局 与 _config.yml 中的默认配置你可以在单篇、全站或归档页三个粒度上自由组合精确控制每个页面的侧边栏呈现。【免费下载链接】minimal-mistakes:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.项目地址: https://gitcode.com/gh_mirrors/mi/minimal-mistakes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
二阶低通滤波器设计：Multisim实战与巴特沃斯/切比雪夫/贝塞尔选型指南 1. 为什么二阶低通滤波器是电子设计绕不开的“基本功”？你刚打开Multisim，拖出几个电阻、电容、运放，想搭个滤波电路——结果仿真一跑，频响曲线歪得不像样：截止频率漂移30%，通带纹波大得像心电图࿰… · 2026/9/23 2:08:15
3步搞定苹果app下载：手写实现避坑指南 3步搞定苹果app下载：手写实现避坑指南 配置环境就卡半天，是不是你的日常？ 别怪苹果系统，是你对底层逻辑没吃透。很多开发老鸟都在 手写实现 下载模块时栽过跟头，尤其是处理iOS特有的沙盒机制和URL Scheme解析。… · 2026/9/23 2:08:15
RTL9303-CG交换芯片Datasheet深度解读：从架构到硬件调试实战 简介：RTL9303-CG 是 Realtek 推出的一款三层管理型 8 端口 10 Gigabit Ethernet 交换控制器，该 PDF 数据手册详尽描述了芯片架构、引脚定义、功能特性与电气参数，面向网络设备硬件工程师、嵌入式软件开发者及数据中心/企业网方案选型人员&… · 2026/9/23 2:08:09
3个坑让gflags配置卡半天?源码解析教你秒解 3个坑让gflags配置卡半天?源码解析教你秒解 配置环境就卡半天，代码跑起来却像蜗牛爬？别急着重启服务器或重装环境。很多开发者在集成 gflags 时，往往陷入“配置即崩溃”或“性能无提升”的怪圈。这背后并非简单的参数错误，而是对… · 2026/9/23 19:25:45
基于PyQt5的离线语义分割工具：8个模型与工程化实践 简介：这是一套基于Python与PyQt构建的图像语义分割桌面软件，集成MobileNet、ResNet50等8种主流模型，可加载图片进行实时分割并可视化结果，适合计算机视觉相关专业的毕业设计、课程设计以及希望上手深度学习GUI应用的开发者学习使用… · 2026/9/23 19:25:32
电脑光驱怎么打开源码深度剖析 手写实现光驱打开逻辑,面试官追问底层细节 刚跑完单元测试，满屏红色的 StackTrace 看得人眼晕。 NullPointerException 混着 IOException… · 2026/9/23 19:25:32
道路圆石墩检测数据集：462张实拍图+VOC/YOLO双格式 简介：本资源是一个面向计算机视觉初学者与算法工程师的道路安全设施检测专用数据集，聚焦于圆石墩（spherical_roadblock）这一典型低矮障碍物的识别任务，适用于YOLO、Faster R-CNN等目标检测模型的训练与验证。压缩包共1… · 2026/9/23 19:25:25
3个坑让qq空间在线刷人气失效，手写实现救场指南 3个坑让qq空间在线刷人气失效，手写实现救场指南 版本升级后 API 全变了，你盯着报错日志发呆吗？别慌，很多同行还在用老代码硬套，结果连编译都过不了。今天咱们不整虚的，直接上干货，聊聊怎么通过 手写实现… · 2026/9/23 19:25:06
别背了，3张图解清waterfall核心原理 别背了，3张图解清waterfall核心原理 面试被问“waterfall模式到底怎么执行”，你是不是脑子一片空白？只会说“按顺序执行”，但被追问线程阻塞机制或异常处理时，立马卡壳。别慌，今天咱们不背八股文，直接用图解原理，把这套老牌并发模… · 2026/9/23 19:25:00
3招搞定手机怎么下载微信面试难题实战项目解析 3招搞定手机怎么下载微信面试难题实战项目解析 面试被问“手机怎么下载微信”背后的原理，90%的人答不上来。别笑，这看似弱智的问题，实则是考察你对移动应用分发机制、安全校验及网络协议理解的试金石。我带过不少校招新人，他们背了八股文，却连一个A… · 2026/9/23 0:00:03
你有新短消息请注意查收：3个新手避坑指南搞定消息系统选型 你有新短消息请注意查收：3个新手避坑指南搞定消息系统选型 面试被问“高并发下如何保证消息不丢失”，你张口就是“用Redis”，结果面试官追问“如果Redis宕机了怎么办”，你瞬间卡壳。这种场景太常见了，很多新手在背八股文时，只记住了技术名词… · 2026/9/23 0:00:29
