Chapter 3Configuration
3
Chapter 3

Configuration

Field Notes keeps its shared settings in oro.toml. Use .ororc when your machine needs a different build directory.

Before you start: continue from Project layout in field-notes.

1. Keep the shared output

Your existing oro.toml has:

oro.toml

[build]
name = "field-notes"
copy_map = "copy-map.toml"
output = "build"

2. Override it locally

Create .ororc beside oro.toml. settings.build overrides the shared build settings.

.ororc

[settings.build]
output = "build-local"

Keep .ororc ignored, and append the new output directory to .gitignore:

.gitignore

build-local/

3. Verify the path

Terminal

oroc config --describe build.output
oroc print-build-dir .
oroc build .
oroc run .

Expected result: the printed path and build output are under build-local. The app still restores your draft.

Use print-build-dir for this check: formatted config dumps can omit RC overrides. See configuration precedence for the full lookup order.

Try it yourself

Remove [settings.build] from .ororc and run oroc print-build-dir . again. The path should return to build. Leave .ororc empty for the next chapter.

Next

Preview your draft in another window →

Quick links

Type to search across the site. Use the up and down arrow keys to choose a result, Enter to open it, and Escape to close.