novelWriter 场景结构实战：用三级标题、引用标记与拆分工具组织章节内的多场景

桌面应用【免费下载链接】novelWriternovelWriter is an open source plain text editor designed for writing novels项目地址https://gitcode.com/gh_mirrors/no/novelWriter点击查看免费下载本文以 novelWriter 示例项目中的真实场景文档 bc0cbd2a407f3.md 为标本系统讲解如何在章节下组织多个场景标题层级如何定义章节与场景、同一文件与多文件两种组织方式的取舍、pov/focus/location引用元数据的写法、###!硬场景分隔符的含义以及如何用 Split Document 工具把合并写作的文本按标题拆回独立场景文件。读完本文你将掌握 novelWriter 以标题驱动结构为核心的场景组织方法论并能直接套用到自己的小说项目中。一、标本解读一个场景文件长什么样先看示例项目里这个名为Another Scene的场景文件sample/content/bc0cbd2a407f3.md的完整内容 name Another Scene parent 780f67364ea6a handle bc0cbd2a407f3 class NOVEL layout DOCUMENT textHash d35e2629876e627b1a2418affa40d477022984f8 createdDate Unknown updatedDate 2024-03-11 22:56:28 ### Another Scene pov: John focus: Jane location: Earth Adding more scenes to a chapter is as easy as adding more scene files with a level three heading. You can of course also just add another level three heading in the same file if that works for the way you want to structure your files. In fact, if you wish, you can add all the scenes in the chapter file too. All novelWriter cares about is the level of the headings and the order in which they appear. ###! More Scenes pov: Jane focus: John location: Earth This is a second scene in the same file as the previous scene. You can always split the files up later using the split tool.这个文件虽然只有寥寥数段却浓缩了 novelWriter 场景组织的全部关键机制文件头frontmatter由包裹的元数据块记录文档名称、父节点 handle、自身 handle、类别NOVEL、布局DOCUMENT与时间戳。这些元数据不是给你手写的而是由项目索引sample/nwProject.nwx 中对应的item handlebc0cbd2a407f3 ...条目在保存时自动维护的。一个三级标题###定义一个场景正文第一行### Another Scene即声明了本文件是一个场景。引用元数据行标题下方紧跟着pov、focus、location三行为场景标注视角人物、焦点人物和发生地点。同一文件内可容纳多个场景文件后半部分用另一个三级标题###! More Scenes直接开启了第二个场景——注意多了一个!。二、标题层级决定一切为什么 novelWriter 只看标题novelWriter 的核心设计理念是项目的结构由文档内的标题层级推断而不是由文档文件本身决定。这是官方文档 chapters_and_scenes.rst 明确说明的规则也是理解本文所有内容的前提。对于放在Novel类根文件夹下的文档四个层级的标题分别对应小说的不同结构单元标题Markdown 写法结构含义构建时行为一级标题# Title Text分部Partition如Part 1第一幕可作为封面标题样式可整体隐藏不进手稿二级标题## Chapter Title章节Chapter可自动插入章节编号三级标题### Scene Title场景Scene可自动插入场景编号或场景分隔符四级标题#### Section Title小节Section可替换为分隔符或在输出中完全忽略关键规则有三条多个标题可共存于同一文档但项目树中该文档显示的名称与图标由第一个标题决定。示例文件### Another Scene出现在首行因此项目树里它显示为场景H3 图标sample/nwProject.nwx 中对应条目meta ... headingH3 ...证实了这一点。标题后的空格是强制的#与文字之间必须有空格否则编辑器不会把它识别为标题并改变颜色字号。其他根文件夹如 Characters、Locations中的笔记也可以使用同样的标题层级但它们不会被当作章节或场景对待可以自由使用。从源码看手稿构建器正是按标题层级来分发格式化逻辑的tokenizer.py 中为 partition、chapter、scene、section 分别维护了独立的样式开关如_hidePart、_hideChapter、_hideScene、_hideSection并针对每个层级提供了独立的字号与上下边距设置方法。这意味着标题层级的选择会一路影响到最终导出文档的排版。三、两种组织方式多文件场景 vs 单文件多场景示例文档正文第一段给出了两个同样可行的方案Adding more scenes to a chapter is as easy as adding more scene files with a level three heading.方式一每场景一个文件这是最常见也最推荐的做法。在项目树中场景文件可以作为章节文档的子文档也可以排在章节文档之后与它同级——官方文档明确指出这两种排法在最终输出中结果完全一致纯属个人偏好。在示例项目中可以看到这两种排法的真实样例sample/nwProject.nwx章节Basic Formattinghandle6a2d6d5f4f401下挂着两个子文档Making a Scene636b6aa9b697b和Another Scenebc0cbd2a407f3这是场景作为章节子文档章节So it Begins88706ddc78b1b下面同样挂着Where is John?和We Found John!两个场景子文档。每个场景文件只需一个三级标题配合各自的引用元数据就能在 Outline View大纲视图和 Novel View小说视图中独立显示、独立统计字数。方式二单文件内连续多个场景示例文档的第二段明确说明you can add all the scenes in the chapter file too. All novelWriter cares about is the level of the headings and the order in which they appear.即你可以把整章所有场景都写进同一个文件里只要保持标题层级与出现顺序正确即可。本示例文件正是如此——它在一个文件里放进了### Another Scene和###! More Scenes两个场景。这种做法的优点是写作时不打断思路、不用频繁切换文件缺点是大纲视图中的场景粒度与文件粒度绑定后续想单独管理某个场景时需要用拆分工具处理。四、场景引用元数据pov、focus、location 的语义场景标题下的引用行是 novelWriter 标签-引用系统的实际应用。根据官方文档 tags_and_references.rst引用行的通用格式为keyword: value1, value2, ..., valueN所有引用关键字都支持多个值。示例场景中用到的三个关键字语义如下pov本场景的视角人物Point of View。目标必须是Characters类型根文件夹中某个笔记定义的标签。focus本场景中具有焦点的角色适用于焦点人物与视角人物不同的情况。目标同样必须是 Characters 类笔记标签。location本场景发生的地点。目标必须是Locations类型根文件夹中的笔记标签。此外还有char其他出场角色、plot推进的剧情线、time涉及的时间线、object、entity、custom、mention仅提及未出场的事物与story引用 Novel 类文档等关键字完整列表见 tags_and_references.rst。这些引用能生效前提是目标标签已在对应根文件夹的笔记中定义过。以本示例项目为例location: Earth引用的正是 sample/content/b3e74dbc1f584.md 中定义的 Earth 地点标签对应项目树Locations根下的Earth笔记见 sample/nwProject.nwx 中 handleb3e74dbc1f584的条目pov: John/focus: Jane引用的则是Characters根下John and Bob Smith、Jane Smith笔记中的角色标签。使用技巧标签不区分大小写2.2 版本起显示时保留你定义时的写法编辑器会在你输入时自动弹出补全菜单冒号后补全已定义的标签若引用了尚不存在的标签可右键选择Create Note for Tag自动在正确的根文件夹生成带新标签的笔记引用正确时编辑器会给它加高亮色无效引用会显示波浪下划线——若高亮不准按F9重建索引即可。五、硬场景分隔符###!的含义示例文档的第二个场景标题写作###! More Scenes比第一个场景多了一个!。这是 novelWriter 为三级标题提供的一种变体写法。根据 chapters_and_scenes.rst!修饰符只对手稿构建产生影响写作时可以先了解其用途再决定是否使用#! Title一级标题的变体用于小说或笔记文件夹的主标题如封面书名构建时使用与分部标题不同的独立样式##! Chapter Title二级标题变体告诉构建工具不要为这个章节自动编号适合序章prologue和尾声epilogue###! Scene Title三级标题变体在手稿构建中可用不同的格式渲染用于区分软性场景分隔与硬性场景分隔soft vs hard scene break除此之外行为与普通场景标题完全一致。从源码实现看tokenizer.py 中场景标题的格式化逻辑确实区分了普通场景与硬场景_hideScene与_hideHScene是两个独立的隐藏开关分别控制普通场景标题和硬场景标题是否出现在输出中场景编号的递增也发生在标题格式化之前。这意味着你可以在同一章里混用###与###!让它们在手稿中呈现不同的样式或分隔符。示例文档用它演示的正是同文件内第二场景的写法——软/硬场景分隔符的语义由你自行定义novelWriter 只负责在构建时按不同样式输出。六、反推工作流拆分工具如何把单文件还原为多场景示例文档最后一句写得很妙You can always split the files up later using the split tool.这正是对 Split Document by Headings 功能的预告。当你像本示例这样把多个场景写在同一个文件里、之后又想拆成独立文件时可以在项目树中右键该文档在Transform子菜单里选择Split Document by Headings打开拆分对话框源码实现见 docsplit.py选择拆分层级下拉框提供四级选项——Split on Heading Level 1 (Partition)、Split up to Heading Level 2 (Chapter)、Split up to Heading Level 3 (Scene)、Split up to Heading Level 4 (Section)docsplit.py。对场景组织而言选 Level 3 即按场景标题拆分预览列表对话框上方的列表会实时预览按当前层级将被拆出的每个标题三个开关选项docsplit.pySplit into a new folder把拆出的文档放进新文件夹Create document hierarchy按层级重建文档树section 归入 scenescene 归入 chapterMove split document to Trash拆分后把源文档移入 Trash源文档不会被删除是否回收由你决定。这套工具的默认选项拆分层级 3、新建文件夹、建层级保存在项目配置中可在 config_novelwriter.toml 这类配置模板中找到对应记录说明拆分偏好是持久化的用户设置。对应的反向操作是Merge Documents选择Merge Child Items into Self把子文档内容并入父文档或Merge Child Items into New合并后生成新文档合并对话框中可以排除不想合并的文档并调整合并顺序详见 split_and_merge.rst。于是合并写作 → 按标题拆分 → 独立管理就构成了一个完整的闭环工作流先用单文件连续写作保持思路连贯需要精细化整理时再用拆分工具按场景标题还原文件结构。七、实践要点小结基于以上分析在 novelWriter 中组织章节内的多场景可以遵循以下要点结构只看标题##是章节、###是场景、####是小节文件数量与层级关系不影响最终输出标题层级与顺序才重要每场景一个三级标题无论采用单文件多场景还是多文件一场景每个场景都必须以###或###!开头且标题后必须有空格场景文件既可作章节子文档也可与章节同级两种排法输出一致引用行紧跟标题pov、focus、location等引用必须指向已定义的角色/地点/剧情线标签并保持标签唯一、跨文档有效用###!区分场景分隔类型需要软/硬场景分隔差异化排版时使用带!的三级标题善用拆分工具还原结构单文件写多了就右键 → Transform → Split Document by Headings按 Level 3 拆回独立场景文件可选建文件夹、建层级、移 Trash 三项配置。通过这套以标题为核心的组织方式你的章节-场景结构将同时被项目树、大纲视图、手稿构建器与字数统计系统正确识别形成从写作到导出的完整链路。赞分享桌面应用【免费下载链接】novelWriternovelWriter is an open source plain text editor designed for writing novels项目地址https://gitcode.com/gh_mirrors/no/novelWriter点击查看免费下载相关推荐novelWriter 章节与场景结构Markdown 风格标题层级与手稿构建实战指南novelWriter 章节与场景结构Markdown 风格标题层级与手稿构建实战指南 novelWriter 是一个面向小说写作的开源纯文本编辑器其核心设桌面应用使用 Remotion 编排多场景视频TransitionSeries 场景拆分与转场实战指南使用 Remotion 编排多场景视频TransitionSeries 场景拆分与转场实战指南 导读 在 Remotion 中制作包含多个镜头/段落的长视频时音视频AI 应用前端Artillery 多场景测试文件拆分实战使用 --config 分离场景与配置Artillery 多场景测试文件拆分实战使用 config 分离场景与配置 导读 当 Artillery 测试脚本不断增长时把 config 配置段与各个性能测试接口测试CLI上一篇Windows电脑安装APK文件APK安装器完整指南下一篇Photoshop图层批量导出终极指南如何快速将图层导出为文件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考