shithub: werc

ref: 9a25ae375c03181812e0cc1b8cdd45eb89564c78
dir: /sites/werc.cat-v.org/docs/dir-listings.md/

View raw version
Autogenerated Directory Listings
================================

If a directory has no `index.md`, `index.html` or `index.txt` and has no other
*main handler* set up by a [werc app](/apps/), the default directory listing
handler is used.

The default directory handler simply displays the path to the directory, and a
list of links to all files and dirs located at this path.


Header and footer
-----------------

If a `_header.md` or `_footer.md` files are found in the directory, their
contents will be displayed in the corresponding sections before and after
the directory contents.


Tuning the item's order
------------------------

You can set the `dir_listing_ls_opts` config variable in the dir's corresponding _werc/config to change the way items will be ordered.

For example to list items in reverse chronological order simply add:

    dir_listing_ls_opts=( -t )

The options taken are [the standard Plan 9 ls(1) flags](http://man.cat-v.org/plan_9/1/ls).