Skip to content
subfolio-astro-docs

Folder Suffixes

A folder whose name ends in .site, .slide, or .oplx is treated as a single item rather than a regular folder to browse into — each suffix changes what happens when you visit it. [Source: docs/spec/SPEC-conventions.md §3.7, §3.8, §3.4]

.site — mini site / HTML prototype

Section titled “.site — mini site / HTML prototype”
  • Directorycontent/examples/
    • Directory04_html_prototype/
      • -t-readme.txt
      • Directory04_html_prototype.site/
        • index.html

Result: a .site folder must contain an index.html; visiting it renders that HTML directly as a single-item detail view instead of a folder listing — a way to host a self-contained HTML prototype inside a Subfolio tree. [Source: docs/spec/SPEC-conventions.md §3.7]

See it live →

.slide — slideshow

Section titled “.slide — slideshow”

This fixture’s directory name has a literal space, not the NN_ underscore pattern used elsewhere:

  • Directorycontent/examples/
    • Directory06 slideshow.slide/
      • -t-readme.txt
      • Directoryslideshow.slide/
        • example.gif
        • example.jpg
        • example.png

Result: a .slide folder redirects the browser straight to its first file instead of showing a listing, then offers prev/next navigation between the remaining files — a linear slideshow-browsing experience. [Source: docs/spec/SPEC-conventions.md §3.8]

See it live →

.oplx — OmniPlan archive

Section titled “.oplx — OmniPlan archive”
  • Directorycontent/examples/
    • Directory08_project_plan.oplx/
      • README
      • Directorycontents/
        • data.xml
        • notes.txt

README:

OmniPlan package

Result: an .oplx folder is treated as a single-item detail view (like .site), and when served through the raw /directory/ byte route it’s zipped on the fly and returned as a .zip download instead of a directory listing. [Source: docs/spec/SPEC-conventions.md §3.4]

See it live →