Tips

Navigation behavior

• Files and folders are sorted alphabetically and intermixed by default; use _order.txt to override
• index.md in any folder is hidden — it IS that folder's home page
• Empty directories are hidden from the nav tree
• The active page is highlighted in the nav

Serving from a subdirectory

OwnShip auto-detects its base path. Drop it into /docs/ or /notes/ and everything — nav links, home URL, {{home}} tokens, image paths — works correctly without any configuration.

Image paths

Images referenced in .md files are served root-relative, so they display correctly regardless of which page you're viewing. Use paths relative to your content root:

![Logo](images/logo.png)

Running the guide locally

This guide is served by OwnShip. To run it locally, drop index.php into this guide/ folder and run OwnShipPreview.bat or OwnShipPreview.sh from that directory.

Quick _theme.css recipes

These drop straight into _theme.css and can be combined freely.

Font size

Scale the content area only:

main { font-size: 1.125rem; }   /* roomier — ~18px at default base */
main { font-size: 0.9375rem; }  /* compact — ~15px */

To scale everything including the nav, shift the rem baseline instead:

html { font-size: 18px; }

Page transitions

Each nav click is a full page reload, so a CSS animation on main fires naturally on every page change. Add one via _theme.css:

main { animation: hv-fade .3s ease; }
@keyframes hv-fade {
  from { opacity: 0; transform: translateY(8px); }
  to   { opacity: 1; transform: none; }
}

Other ideas: translateX(-8px) slides in from the left; scale(.98) gives a subtle zoom-in feel.

Dogfooding

The guide you're reading at ownship.cc/guide/ is itself served by OwnShip — the same index.php you downloaded. The main ownship.cc site is a separate static page.