Differences

This shows you the differences between two versions of the page.

--- en:classifier:list [2019/09/16 01:45] – kjdon
+++ en:classifier:list [2019/09/16 22:40] – kjdon
@@ Line 7: / Line 7: @@
 ^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. |  |
+| **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.|  |
-| | 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_selection_mode** | 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.|
-//Default: never//\\ [[List#bookshelf_type option values|List]]  |
 | **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 '/'. |//Default: per_letter//\\ [[List#partition_type_within_level option values|List]]  |
+| **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 '/'. |  |
+| **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'. |  |
+| **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'. |  |
-| **sort_leaf_nodes_using** |Metadata fields used for sorting the leaf nodes. Use <nowiki>'|'</nowiki> to separate the metadata groups to stable sort and ';' to separate metadata fields within each group. |//Default: Title//  |
+|**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 <nowiki>'|'</nowiki> to separate the metadata groups to stable sort by, and ';' or ',' to separate metadata fields within each group. For example, <nowiki>"dc.Title,Title|Date"</nowiki> 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. |  |
+| **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'. |  |
-| **use_hlist_for** |Metadata fields to use a hlist rather than a vlist. Use ',' to separate the metadata groups and ';' to separate the metadata fields within each group. |  |
 | **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. |  |
-| **standardize_capitalization** |Metadata values are lowercased for sorting into bookshelves. Set this option to use these lowercase values for bookshelf display names. Otherwise, the majority case variant will be used. |  |
+| **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. |  |
@@ Line 35: / Line 40: @@
-=== bookshelf_type option values===
-^Value^Description^
-=== partition_type_within_level option values===
-^Value^Description^
-|per_letter|Create a partition for each letter.|
-|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.|
-|none|None.|