Folder template syntax
The folder template uses a subset of Libation’s naming-template language. The default is:
<first author>/<if series-><first series>/<has series#-><series#> - <-has><-if series><title short> [<id>]/ separates folders. Each folder name is made safe for any filesystem afterwards (characters like
: * ? " < > | become spaces), and an empty folder name, like a missing series, is dropped.
| Tag | Example |
|---|---|
<id> |
B003P2WO5E, the ASIN. Required in the last folder. |
<title> |
The Way of Kings: The Stormlight Archive, Book 1 |
<title short> |
The Way of Kings, the title up to the first colon |
<audible title> |
Same as <title short> |
<audible subtitle> |
The Stormlight Archive, Book 1 |
<author> |
Every author, as Audible lists them |
<first author> |
Brandon Sanderson (Unknown Author if there’s none) |
<narrator> |
Every narrator |
<first narrator> |
Michael Kramer |
<series> |
The Stormlight Archive |
<first series> |
Same as <series> |
<series#> |
1, the position in the series |
<year> |
2010, the release year |
<language> |
English |
An unknown tag is an error, and Save stays off.
Conditionals
Section titled “Conditionals”| Form | Shows its contents when |
|---|---|
<if series->…<-if series> |
the book is in a series |
<!if series->…<-if series> |
the book is not in a series |
<has TAG->…<-has> |
the tag has a value, e.g. <has series#->, <has year->, <has narrator-> |
Examples
Section titled “Examples”<first author>/<title short> [<id>]Author / Title [ASIN], ignoring series.
<first author>/<if series-><first series>/<-if series><has year-><year> - <-has><title short> [<id>]Author / Series / 2010 - Title [ASIN].
<first narrator>/<title short> [<id>]By narrator, for the people who pick books that way.