ref: 77b2806458bfbf6bfa5d51655c88c61d4401b0cc
parent: aaf1fb867458e59ddbf14d7de8f73a60372a398d
author: sl <[email protected]>
date: Wed Sep 30 17:44:16 EDT 2009
Document dir listing optinos and _header.md and _footer.md
--- /dev/null
+++ b/sites/werc.cat-v.org/docs/dir_listings.md
@@ -1,0 +1,29 @@
+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).