企业官网建设流程全解析

• 桌面应用

本篇指南聚焦 QOwnNotes 的一个高频界面定制需求：如何把笔记预览（Markdown 渲染结果）作为主界面唯一的核心区域，彻底隐藏笔记编辑面板。你将学会利用内置的Preview only布局预设、或通过手动把中央部件切换为Note preview并关闭编辑面板，最终获得一个"纯阅读 / 纯展示"的工作区；文章同时结合仓库源码说明中央部件与停靠面板的底层切换机制，让你明白每一步操作背后发生了什么。

一、核心概念：Central Widget 与 Dock Widget

QOwnNotes 的主界面由两类部件组成（对应源码 mainwindow.cpp 中的实现）：

• 中央部件（Central Widget）：占据主窗口剩余空间的主体区域，可以是note-edit（笔记编辑）、note-preview（笔记预览）或none（无中央部件，全部交给停靠面板）。
• 停靠面板（Dock Widget）：笔记列表、导航、标签、预览、编辑器等可停靠、可浮动、可调整大小的面板。

在 Layouts 设置页 中，中央部件下拉框提供三个选项：

当中央部件为note-preview时，预览面板会自动占据编辑面板腾出的全部中央空间——这正是"只显示预览"的关键开关。

二、最快路径：用内置的 Preview only 预设

QOwnNotes 内置了 5 种布局预设（定义见 layouts.ini）：minimal、full、preview-only、full-vertical、1col。其中preview-only预设的配置正是centralWidget=note-preview、noteEditIsCentralWidget=false，即预览面板为中央部件、编辑面板不作为中央部件。

操作步骤：

1. 打开设置（Settings）> 界面（Interface）> 布局（Layouts）。
2. 点击从预设添加...（Add from preset...）。
3. 在弹出的预设选择对话框中，选择仅预览（Preview only）预设，点击使用。
4. 布局列表会自动刷新并切换到新布局。

在预设选择对话框中，每个预设都配有截图与文字说明（见 layoutpresetwidget.cpp）。其中Preview only的官方说明明确提示：

默认启用左侧的笔记列表、标签面板以及右侧的预览面板。要真正编辑笔记，你需要切换到另一个布局！

这意味着该预设默认就隐藏了编辑面板，选中后立即获得"纯预览"工作区；但请注意，当前布局中没有编辑入口，需要编辑笔记时请通过工具栏的布局切换器切回其他布局（如full或minimal）。

三、手动方案：复制当前布局并切换中央部件

如果你不想改变现有的面板排列，只想在现有布局的基础上把预览变为主区域，可按以下步骤：

1. 打开设置 > 界面 > 布局。
2. 点击从当前添加（Add from current），输入新布局名称。该操作会复制当前的面板排列、面板可见性与中央部件设置，并立即激活新布局（对应 layoutssettingswidget.cpp 的按钮提示）。
3. 选中刚创建的布局，在下方中央部件（Central widget）下拉框中切换到Note preview。
4. 修改会立即生效：源码中下拉框变化会直接调用layoutManager()->setLayoutCentralWidget(...)（见 layoutssettingswidget.cpp）。

这种方式的好处是不会动到原有布局，随时可以通过布局切换器回到原来的编辑布局。

四、在 Window > Panels 菜单中关闭编辑面板

使用预设方案后编辑面板通常已被隐藏；若仍有残留的编辑面板（例如从手动方案继承了可见的编辑面板），可以在主菜单窗口（Window）> 面板（Panels）中将其关闭：

• 打开Window > Panels菜单，取消勾选笔记编辑（Note edit）面板。
• 该菜单由源码动态生成：updatePanelMenu()会遍历所有QDockWidget，为每个面板生成一个可勾选的"显示 XX 面板"菜单项（见 mainwindow.cpp）。
• 每次勾选切换都会调用togglePanelVisibility()，将面板隐藏或显示，并立即把变化存入当前布局（见 mainwindow.cpp）。

此时预览面板作为中央部件会自动扩展，占满关闭编辑面板后腾出的全部空间。

五、解锁、拖动与调整面板大小

在窗口（Window）菜单中：

• 解锁面板（Unlock panels）：默认面板被锁定，无法拖动。勾选该选项后，所有面板恢复标题栏，可以自由拖动、停靠或浮动（对应 layoutmanager.cpp 的on_actionUnlock_panels_toggled）。
• 解锁后可直接拖动面板边缘调整大小，也可以把面板拖出成为浮动窗口。
• 重新停靠浮动面板（Reattach floating panels）：如果浮动面板无法手动拖回，可用此命令一键把全部浮动面板重新停靠（见 layoutmanager.cpp）。

面板的最终排列与大小会随布局一起保存：切换布局时调用storeCurrentLayout()保存windowState，恢复时通过restoreCurrentLayout()还原（见 layoutmanager.cpp）。

六、底层原理：预览面板如何"升级"为中央部件

在源码层面，中央部件切换由MainWindow::setCentralWidgetIdentifier()完成（见 mainwindow.cpp）：

1. 当目标标识为note-preview时，先takeCentralWidget()取下当前中央部件，再把预览框架ui->noteViewFrame通过setCentralWidget()设为主窗口中央区域。
2. 原来的noteEditTabWidget则通过createNoteEditDockWidget()转为停靠面板；反之亦然。
3. 切换后立即刷新面板菜单（updatePanelMenu()）并重新应用面板锁定状态。

应用启动时也会读取centralWidget设置来决定预览是否作为中央部件（见 mainwindow.cpp），因此该配置是持久化的——重启 QOwnNotes 后"纯预览"布局依然生效。

另外，当预览作为中央部件或预览面板可见时，程序会在切换笔记、更新面板菜单后主动刷新预览内容（见 mainwindow.cpp），确保阅读模式下的渲染结果始终与当前笔记同步。

七、注意事项

• 纯预览布局无法编辑笔记：这是设计使然（预设说明中已明确提示）。需要编辑时，通过工具栏的布局下拉框或Window > Layouts菜单切换回含编辑面板的布局。
• 布局的删除有数量限制：QOwnNotes 至少保留一个布局，removeLayout()在布局数少于 2 时会直接拒绝（见 layoutmanager.cpp）。
• 预览模式下的交互：预览作为中央部件时，点击笔记列表即可切换内容；若需要"编辑与预览同屏"，可改用full布局并把预览面板停靠在右侧，无需使用纯预览方案。

至此，你已掌握在 QOwnNotes 中搭建"纯预览阅读工作区"的两种路径（预设一键完成 / 手动配置），并理解了其背后的中央部件与停靠面板机制，可以按自己的习惯自由组合出理想的界面布局。

• 桌面应用