Difference between revisions of "ReNamer:Rules:Rearrange"
m (...if an delimiter match at the very end ...) |
m (Markup cleanup) |
||
Line 65: | Line 65: | ||
*Several delimiters can be used at a time. Use the {{pipe}} character to separate them. | *Several delimiters can be used at a time. Use the {{pipe}} character to separate them. | ||
*The chopped parts are numbered from left, as $1, $2, $3, etc. | *The chopped parts are numbered from left, as $1, $2, $3, etc. | ||
− | |||
:The same parts can be referred from the end as $-1, $-2, $-3, etc. | :The same parts can be referred from the end as $-1, $-2, $-3, etc. | ||
− | |||
*If the delimiter occurs at the very beginning of the name, the resultant $1 contains nothing (because there is nothing on the left side of the delimiter). | *If the delimiter occurs at the very beginning of the name, the resultant $1 contains nothing (because there is nothing on the left side of the delimiter). | ||
− | + | :The same is true if an delimiter match at the very end of the name, the resultant $n contains nothing. | |
<span style="color: red;">'''Warning:'''</span> The number of parts into which the filename is broken down depends solely on the number of delimiters in the filename. If you reference fewer parts in the output pattern that the number of available parts - not referenced parts will be lost! For example, take filename "Artist - Title" and to swap them around one would use " - " as a delimiter and "$2 - $1" as a new pattern which will result in "Title - Artist", but if some filename appears with more dashes like "Artist - Title - Album" the result will also be "Title - Artist" and last part will be lost. To make sure that no parts are lost use '''Exact pattern of delimiters''' option instead. | <span style="color: red;">'''Warning:'''</span> The number of parts into which the filename is broken down depends solely on the number of delimiters in the filename. If you reference fewer parts in the output pattern that the number of available parts - not referenced parts will be lost! For example, take filename "Artist - Title" and to swap them around one would use " - " as a delimiter and "$2 - $1" as a new pattern which will result in "Title - Artist", but if some filename appears with more dashes like "Artist - Title - Album" the result will also be "Title - Artist" and last part will be lost. To make sure that no parts are lost use '''Exact pattern of delimiters''' option instead. |
Revision as of 21:45, 5 June 2020
Rearrange rule
This rule allows you to chop up the existing file name and reuse any/all of the parts in any order to compose a new name.
- You can also add your own text, or use meta tags while composing the new name.
- You can also use the whole original name, and insert literal text (or meta tags) around it.
The parameters are as follows:
Parameter | Description |
---|---|
Split using |
Specifies how to split the existing name into parts.
For detailed explanation of split methods please look below at the split options explained section. |
Right-to-left |
If selected, the numbering starts from right.
|
Add a separator for additional delimiters. The separator is a "|" (vertical pipe) character, which can also be entered manually. | |
New pattern |
How to compose the new name from the parts created from the original name (see above).
|
Click the button to see a list of meta-tags. Select any meta tag to insert it in the new name template. |
Split options explained
Option | Description |
---|---|
Delimiters |
Chop the name where the delimiter occurs.
Warning: The number of parts into which the filename is broken down depends solely on the number of delimiters in the filename. If you reference fewer parts in the output pattern that the number of available parts - not referenced parts will be lost! For example, take filename "Artist - Title" and to swap them around one would use " - " as a delimiter and "$2 - $1" as a new pattern which will result in "Title - Artist", but if some filename appears with more dashes like "Artist - Title - Album" the result will also be "Title - Artist" and last part will be lost. To make sure that no parts are lost use Exact pattern of delimiters option instead. |
Positions |
Chop the name at the indicated position (the position count begins with 1).
|
Exact pattern of delimiters |
Chop the name using the exact pattern (sequence) of the delimiters. With this option you basically define how many parts you want the filename to be split into and the order in which the delimiters must occur. If you specify 1 delimiter then you end up with exactly 2 parts, if you specify 2 delimiters you'll get 3 parts, and so on. |
Examples
This rule is so versatile that it can be used in a huge number of ways. Therefore its examples have been moved to a separate article Rearrange Examples.