Search

OwnShip includes a built-in search that trims the nav tree down to just the pages matching what you looked for. It searches page titles and file content both.

Using search

Click the 🔍 button in the nav control bar and the search field slides open, ready for typing. Enter your search and press Enter — or click the → button beside the field, whichever you prefer.

The nav tree is then replaced by a sparse version showing only the pages that matched, still nested inside their parent folders so you can see where each one lives. Whatever page you were reading stays put in the content area, with any matching text highlighted in yellow.

Click any result to go to it. The filtered tree stays put as you browse, so your other hits are still there waiting.

Searching happens when you ask for it rather than on every keystroke, which keeps things snappy on a larger site — there's no pause while the server re-reads your files after each letter you type.

Clearing and closing

Esc empties the search field and brings the whole nav tree back, leaving the bar open in case you want another go. Press Esc again on the empty field and the bar closes too.

Clicking 🔍 works as a shortcut: if there's a search in progress it clears it, and if the field is already empty it just opens or closes the bar.

How matching works

OwnShip checks each file's display name first. If the name contains the query, the matching substring is highlighted in the nav. If the name does not match, the file content is searched. A page appears in results if either its name or its content contains the search string (case-insensitive).

Disabling search

For single-page or business-card sites where search isn't useful, set show_search = false in _site.ini. The 🔍 button will not appear and no search overhead is incurred.

# _site.ini
show_search = false