====== How to customize abbreviations ======

DropIt provides advanced features to modify abbreviated strings. It is possible to add an unlimited
number of modifiers in each abbreviation, using the following syntax:\\
''%Abbreviation#Modifier1#Modifier2%''

Some destination examples for Rename action using modifiers:\\
(Destination => Original Filename => Result Filename)\\
''<nowiki>%FileName#>3,4%.%FileExt%</nowiki>'' => Readme.txt => adme.txt\\
''<nowiki>%FileName#s>(me)%.%FileExt%</nowiki>'' => Readme Example.doc => me Example.doc\\
''<nowiki>%FileName#---#+%.%FileExt#---%</nowiki>'' => TEST NAME.JPG => Test name.jpg\\
''<nowiki>%FileName#r(me,PH)%.%FileExt%</nowiki>'' => Memory me.zip => PHmory PH.zip

\\
----

===== Supported Modifiers =====

**Case modifiers:**\\
''+'' => Uppercase the first character of the string.\\
''++'' => Uppercase the first character of each word in the string.\\
''+++'' => Uppercase all characters in the string.\\
''-'' => Lowercase the first character of the string.\\
''<nowiki>--</nowiki>'' => Lowercase all characters except the first character of each word in the string.\\
''<nowiki>---</nowiki>'' => Lowercase all characters in the string.\\
''<nowiki>??</nowiki>'' => Alternate upper and lower characters.\\
''<nowiki>? ?</nowiki>'' => Alternate upper and lower characters, but leave space neutral.

**String modifiers:**\\
''>d1,d2'' => Take a string from position //d1// (included) counting //d2// characters (left to right).\\
''<d1,d2'' => Take a string from position //d1// (included) counting //d2// characters (right to left).\\
''-d1,d2'' => Take a string between //d1// and //d2// positions.\\
''s>(s1)'' => Take a string from the substring //s1// (included) until the end.\\
''s>-(s1)'' => Take a string from the substring //s1// (excluded) until the end.\\
''s<(s1)'' => Take a string from the substring //s1// (included) until the beginning.\\
''<nowiki>s<-(s1)</nowiki>'' => Take a string from the substring //s1// (excluded) until the beginning.\\
''s-(s1,s2)'' => Take a string between string //s1// and //s2// (included).\\
''<nowiki>s--(s1,s2)</nowiki>'' => Take a string between string //s1// and //s2// (excluded).\\
''r(s1,s2)'' => Rename all occurrences of the string //s1// with string //s2//.\\
''regex(p1,r1)'' => Replace regex pattern //p1// with regex replacement pattern //r1//.\\
''d(s1)'' => Delete all occurrences of the string //s1//.\\
''d>d1'' => Delete //d1// characters from the left of the string and take the rest.\\
''d<d1'' => Delete //d1// characters from the right of the string and take the rest.\\
''k(s1)'' => Keep only the group of characters of the string //s1//.\\
''k-(s1)'' => Delete only the group of characters of the string //s1//.\\
''a>(s1,d1)'' => Add a string //s1// in position //d1// from the beginning.\\
''a<(s1,d1)'' => Add a string //s1// in position //d1// from the end.\\
''lz(d1)'' => Add leading zeros up to //d1// length of the string.\\

**Cryptography modifiers:** *\\
''En(pass)'' => Encrypt with password.\\
''De(pass)'' => Decrypt with password.\\
''EnNPt(pass)'' => Encrypt with password, point skipped.\\
''DeNPt(pass)'' => Decrypt with password, point skipped.\\
''EnNSp(pass)'' => Encrypt with password, space skipped.\\
''DeNSp(pass)'' => Decrypt with password, space skipped.\\
''EnNSpPt(pass)'' => Encrypt with password, space and point skipped.\\
''DeNSpPt(pass)'' => Decrypt with password, space and point skipped.\\
''En(pass,exclude)'' => Encrypt with password, skipping all characters in exclude string.\\
''De(pass,exclude)'' => Decrypt with password, skipping all characters in exclude string.

* Characters not allowed in filenames are not used. Instead, all characters are valid for passwords.