<emit source="dir"></emit>

Provided by module: Tags: Dir emit source

This plugin is used to generate directory listings. The directory module must be added to use these entities. This plugin is only available in the directory template.

Attributes

directory="path"

Apply the listing to this directory.

thumbnail-size="number"

Sets the size of the thumbnail. Defaultsize is 60 pixels. The size is set in proportion to the image's longest side, e.g. if the height of the image is longer than it's width, then the thumbnail will be 60 pixels high. The shortest side will be shown in proportion to the longest side.

thumbnail-format="imageformat"

Set the output format for the thumbnail. Default is png. All imageformats that <cimg> handles can be used to produce thumbnails.

strftime="strftime string" (%Y-%m-%d)

Format the date according to this string. Default is the isotime format (%Y-%m-%d), which will return (Year(four characters)-month(two characters)-day(two characters)), e.g. 2000-11-22. See the attribute strftime in <date> for a full listing of available formats.

glob="glob-pattern1[,glob-pattern2,...]"

Only show files matching the glob-pattern.

type="glob-pattern1[,glob-pattern2,...]"

Only show files which content-type matches the glob-pattern.

sort-order="{alpha, dwim, modified, size, type}" (dwim)

Sort the files and directories by this method.

alpha	Sort files and directories alphabetically.
dwim	Sort files and directories by "Do What I (want) Method". In many methods numeriacal sorts fail as the number '10' often appears before '2'. This method sorts numerical characters first then alphabetically, e.g. 1foo.html, 2foo.html, 10foo.html, foo1.html, foo2.html, foo10.html.
modified	Sort files by modification date.
size	Sort files by size.
type	Sort files by content-type.

sort-reverse

Reverse the sort order.

&_.atime; (provided by Tags: Dir emit source)

Returns the date when the file was last accessed.

&_.atime-iso; (provided by Tags: Dir emit source)

Returns the date when the file was last accessed. Uses isotime (%Y-%m-%d).

&_.atime-unix; (provided by Tags: Dir emit source)

Returns the date when the file was last accessed. Uses unixtime.

&_.dirname; (provided by Tags: Dir emit source)

Returns the directoryname.

&_.filename; (provided by Tags: Dir emit source)

Returns the filename.

&_.filesize; (provided by Tags: Dir emit source)

Returns a file's size in bytes. Directories get the size "-2".

&_.mode; (provided by Tags: Dir emit source)

Returns file permission rights represented binary, e.g. "r-xr-xr-x".

&_.mode-int; (provided by Tags: Dir emit source)

Returns file permission rights represented by integers. When encoded to binary this represents what is shown when using the Unix command "ls -l" or as shown using &_.mode;, e.g. "16749".

&_.mtime; (provided by Tags: Dir emit source)

Returns the date when the file was last modified.

&_.mtime-iso; (provided by Tags: Dir emit source)

Returns the date when the file was last modified. Uses isotime (%Y-%m-%d).

&_.mtime-unix; (provided by Tags: Dir emit source)

Returns the date when the file was last modified. Uses unixtime.

&_.name; (provided by Tags: Dir emit source)

Returns the name of the file or directory.

&_.path; (provided by Tags: Dir emit source)

Returns the path to the file or directory.

&_.real-dirname; (provided by Tags: Dir emit source)

Returns the directory of the real file in the filesystem.

&_.real-filename; (provided by Tags: Dir emit source)

Returns the path to the real file in the filesystem.

&_.size; (provided by Tags: Dir emit source)

Returns a file's size in kb(kilobytes).

&_.thumbnail; (provided by Tags: Dir emit source)

Returns the image associated with the file's content-type or directory.

&_.type; (provided by Tags: Dir emit source)

Returns the file's content-type.

&_.type-img; (provided by Tags: Dir emit source)

Returns the internal Roxen name of the icon representating the directory or the file's content-type, e.g. internal-gopher-menu for a directory-folder or internal-gopher-text for a HTML-file.

&_.vfs; (provided by Tags: Dir emit source)

Returns the name of the virtual filesystem that keeps the file.

&_.vfs-root; (provided by Tags: Dir emit source)

Returns the root directory of the virtual filesystem that keeps the file.

&_.x-size; (provided by Tags: Dir emit source)

Returns the width of the image.

&_.y-size; (provided by Tags: Dir emit source)

Returns the height of the image.