Skip to content

Commit

Permalink
Update Character Priority order for Sorting (#2408)
Browse files Browse the repository at this point in the history
YozoraXCII authored Jan 5, 2025

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
1 parent cd98768 commit 1a7499a
Showing 2 changed files with 106 additions and 7 deletions.
111 changes: 105 additions & 6 deletions docs/kometa/guides/order.md
Original file line number Diff line number Diff line change
@@ -2,17 +2,116 @@

There are various sort options available depending on what you want to sort.

## ASCII Sort Order

The first thing to note is that Kometa utilizes the ASCII sort order, which defines which priority a character gets.

![](images/sorts.jpg)
## Plex Sort Order

The first thing to note is that Plex utilizes an ASCII based sort order, which defines which priority a character gets.

???+ important "Character Priority for Plex Sorting"

This is the sorting priority as of Plex Media Server release 1.41.2.9200

```yaml linenums="1"
- space
_ - underscore
- - dash
, - comma
; - semicolon
: - colon
! - exclamation
? - question mark
. - period
' - apostrophe
" - quotation mark
( - open parenthesis
) - close parenthesis
[ - open bracket
] - close bracket
{ - open curly brace
} - close curly brace
@ - at sign
* - asterisk
/ - forward slash
\ - backslash
# - hash
% - percent
` - backtick
^ - caret
+ - plus
< - less than
= - equals
> - greater than
| - pipe
~ - tilde
$ - dollar sign
0 - zero
1 - one
2 - two
3 - three
4 - four
5 - five
6 - six
7 - seven
8 - eight
9 - nine
a - lowercase a
A - uppercase A
b - lowercase b
B - uppercase B
c - lowercase c
C - uppercase C
d - lowercase d
D - uppercase D
e - lowercase e
E - uppercase E
f - lowercase f
F - uppercase F
g - lowercase g
G - uppercase G
h - lowercase h
H - uppercase H
i - lowercase i
I - uppercase I
j - lowercase j
J - uppercase J
k - lowercase k
K - uppercase K
l - lowercase l
L - uppercase L
m - lowercase m
M - uppercase M
n - lowercase n
N - uppercase N
o - lowercase o
O - uppercase O
p - lowercase p
P - uppercase P
q - lowercase q
Q - uppercase Q
r - lowercase r
R - uppercase R
s - lowercase s
S - uppercase S
t - lowercase t
T - uppercase T
u - lowercase u
U - uppercase U
v - lowercase v
V - uppercase V
w - lowercase w
W - uppercase W
x - lowercase x
X - uppercase X
y - lowercase y
Y - uppercase Y
z - lowercase z
Z - uppercase Z
```

## Collection Sorting

Collections can be sorted so that they appear in a specific order in the `Collections` and `Library` tab of your library. This is done using the `sort_title` attribute.

When using the above [ASCII Sort Order](#ascii-sort-order), a collection with a sort title of `!!!My Collection` would appear before a sort title of `!My Collection`, which would be placed before a sort title of `My Collection`
When using the above [Plex Sort Order](#plex-sort-order), a collection with a sort title of `!!!My Collection` would appear before a sort title of `!My Collection`, which would be placed before a sort title of `My Collection`

Let's start with an unmodified set of collections which do **not** specify a custom sort order:

2 changes: 1 addition & 1 deletion docs/kometa/guides/scheduling.md
Original file line number Diff line number Diff line change
@@ -19,7 +19,7 @@ This page discusses how to set up this "When should Kometa run" level of schedul

**You can also put schedule information in your config to control things like "process the Movie library only on Tuesdays" or the like. That level of scheduling is configured independently from the "when Kometa runs" scheduling covered on this page, and is discussed [here](../../config/schedule.md)**

IMPORTANT: Every time you see `/path/to/` below, it's a placeholder for the path to that directory on *your* system. You will need to change that to the relevant path on your machine. THe same goes for things like `YOUR_USERNAME`.
IMPORTANT: Every time you see `/path/to/` below, it's a placeholder for the path to that directory on *your* system. You will need to change that to the relevant path on your machine. The same goes for things like `YOUR_USERNAME`.

IMPORTANT: These guides are intended as just that, **guides**. Kometa has no special requirements with regard to any of these things compared to any other Python script or Docker image, so if something here conflicts with normal procedure on your OS, or if the screenshots don't match some future version of Windows or the like, you will possibly need to interpret the concepts discussed here and apply them to your specific setup.

0 comments on commit 1a7499a

Please sign in to comment.