A general and flexible list classifier with most of the abilities of AZCompactList, but with better Unicode, metadata and sorting capabilities.
The following table lists all of the configuration options available for List.
| Option | Description | Values |
|---|---|---|
| List Options | ||
| metadata | (REQUIRED) Metadata fields used for classification. Use '/' to separate the levels in the hierarchy and ';' or ',' to separate a list of metadata fields within each level. For example, "dc.Title,Title" will make a titles classifier, using either/both of the titles (depending on -metadata_selection_mode). "Date/Title" will make a Date partitioning, and inside each Date, will be a Title partitioning. | |
| metadata_selection_mode_within_level | Determines how many metadata values the document is classified by, within each level. Use '/' to separate the levels. | firstvalue: Only classify by a single metadata value, the first one encountered. firstvalidmetadata: (Default) Classify by all the metadata values of the first element in the list that has values. allvalues: Classify by all metadata values found, from all elements in the list. |
| metadata_sort_mode_within_level | How to sort the values of metadata within each partition. Use '/' to separate the levels. | unicode: Sort using the Unicode Collation Algorithm. Requires http://www.unicode.org/Public/UCA/latest/allkeys.txt file to be downloaded into perl's lib/Unicode/Collate folder. alphabetic: Sort using alphabetical ordering, including for digits. E.g. 10 would sort before 9. alphanumeric: (Default) Sort using a more natural sort, where digits are treated as numbers and sorted numerically. E.g. 10 would sort after 9. |
| bookshelf_type | Controls when to create bookshelves. This only applies to the last level. Other levels will get bookshelf_type = always. | always: Create a bookshelf icon for each value, even if there is only one item in each group at the leaf nodes. duplicate_only: Create a bookshelf icon only when there is more than one item in each group at the leaf nodes. never: (Default) Never create a bookshelf icon even if there is more than one one item in each group at the leaf nodes. |
| classify_sections | Classify sections instead of documents. | |
| partition_type_within_level | The type of partitioning done. Can be specified for each level. Separate levels by '/'. | per_letter: (Default) Create a partition for each letter (word character). approximate_size: Create a partition per letter, then group or split the letters to get approximately the same sized partitions. constant_size: Create partitions with constant size. all_values: Create a partition for each metadata value. none: No partitions. Will apply to the entire level, both numeric and non-numeric values; i.e. Setting none in either partition_type_within_level and numeric_partition_type_within_level will result in both these options being set to none. |
| partition_size_within_level | The number of items in each partition (only applies when partition_type_within_level is set to 'constant_size' or 'approximate_size'). Can be specified for each level. Separate levels by '/'. | Default: 30 |
| partition_name_length | The length of the partition name; defaults to a variable length from 1 up to 3 characters, depending on how many are required to distinguish the partition start from its end. This option only applies when partition_type_within_level is set to 'constant_size' or 'approximate_size'. | |
| partition_sort_mode_within_level | How to sort the values of metadata to create the partitions. | unicode: Sort using the Unicode Collation Algorithm. Requires http://www.unicode.org/Public/UCA/latest/allkeys.txt file to be downloaded into perl's lib/Unicode/Collate folder. alphabetic: Sort using alphabetical ordering, including for digits. E.g. 10 would sort before 9. alphanumeric: (Default) Sort using a more natural sort, where digits are treated as numbers and sorted numerically. E.g. 10 would sort after 9. |
| numeric_partition_type_within_level | The type of partitioning done at each level, for those values that start with digits 0-9. Separate levels by '/'. | per_digit: Create a partition for each digit (0-9). per_number: Create a partition for each number. Control how many digits are used to create numbers using the -numeric_partition_name_length_within_level option. single_partition: Create a single partition '0-9' for all values that start with digits. approximate_size: Create a partition per number (using -numeric_partition_name_length_within_level to determine how many digits to include in the number), then group or split the partitions to get approximately the same sized partitions. constant_size: Create partitions with constant size. all_values: Create a partition for each metadata value. none: No partitions. Will apply to the entire level, both numeric and non-numeric values; i.e. Setting none in either partition_type_within_level and numeric_partition_type_within_level will result in both these options being set to none. |
| numeric_partition_size_within_level | The number of items in each numeric partition (only applies when numeric_partition_type_within_level is set to 'constant_size' or 'approximate_size'). Can be specified for each level. Separate levels by '/'. | Default: 30 |
| numeric_partition_name_length | Control how many consecutive digits are grouped to make the number for the numeric partition name. -1 implies all the digits. | Default: -1 |
| numeric_partition_sort_mode_within_level | How to sort the values of numeric metadata to create the numeric partitions. | unicode: Sort using the Unicode Collation Algorithm. Requires http://www.unicode.org/Public/UCA/latest/allkeys.txt file to be downloaded into perl's lib/Unicode/Collate folder. alphabetic: Sort using alphabetical ordering, including for digits. E.g. 10 would sort before 9. alphanumeric: (Default) Sort using a more natural sort, where digits are treated as numbers and sorted numerically. E.g. 10 would sort after 9. |
| numbers_first | Sort the numbers to the start of the list (By default, metadata values starting with numbers are sorted at the end). | |
| sort_leaf_nodes_using | Metadata fields used for sorting the leaf nodes (i.e. those documents in a bookshelf). Use '|' to separate the metadata groups to stable sort by, and ';' or ',' to separate metadata fields within each group. For example, "dc.Title,Title|Date" will result in a list sorted by Titles (coming from either dc.Title or Title), with those documents having the same Title sorted by Date. | Default: Title |
| sort_leaf_nodes_sort_mode | How to sort the leaf node metadata fields. | unicode: Sort using the Unicode Collation Algorithm. Requires http://www.unicode.org/Public/UCA/latest/allkeys.txt file to be downloaded into perl's lib/Unicode/Collate folder. alphabetic: Sort using alphabetical ordering, including for digits. E.g. 10 would sort before 9. alphanumeric: (Default) Sort using a more natural sort, where digits are treated as numbers and sorted numerically. E.g. 10 would sort after 9. |
| reverse_sort_leaf_nodes | Sort the leaf documents in reverse order. | |
| sort_using_unicode_collation | Sort using the Unicode Collation Algorithm. Requires http://www.unicode.org/Public/UCA/latest/allkeys.txt file to be downloaded into perl's lib/Unicode/Collate folder. This will override all other sort mode arguments: they will all be set to 'unicode'. | |
| filter_metadata | Metadata element to test against for a document's inclusion into the classifier. Documents will be included if they define this metadata. | |
| filter_regex | Regular expression to use in the filter_metadata test. If a regex is specified, only documents with filter_metadata that matches this regex will be included. | |
| use_formatted_metadata_for_bookshelf_display | Metadata values are formatted for sorting (unless -no_metadata_formatting is specified). This might include lower-casing, tidying up whitespace, removing articles. Set this option to use these formatted values for bookshelf names. Otherwise the original value variant that occurs most frequently will be used. | |
| removeprefix | A prefix to ignore in metadata values when sorting. | |
| removesuffix | A suffix to ignore in metadata values when sorting. | |
| Options Inherited from BaseClassifier | ||
| buttonname | The label for the classifier screen and button in navigation bar. The default is the metadata element specified with -metadata. | |
| no_metadata_formatting | Don't do any automatic metadata formatting (for sorting.) | |
| builddir | Where to put the built indexes. | |
| outhandle | The file handle to write output to. | Default: STDERR |
| verbosity | Controls the quantity of output. 0=none, 3=lots. | Default: 2 |