Difference between revisions of "ReNamer:Manual editing"

From den4b Wiki
Jump to navigation Jump to search
(Created page with '== Manual renaming == In addition to combining multiple rules, you can rename any file manually. The following example explains the process: {| class="prettytable" | <center>...')
 
(restructured headings, added "manual changes can get lost"!)
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Manual renaming ==
+
{{Up|ReNamer}}
In addition to combining multiple rules, you can rename any file manually.
 
  
The following example explains the process:
+
In addition to combining multiple rules to automatically generate new names, you can also make manual changes to the new names. This can be useful for performing minor tweaking of the new names before completing the renaming process.
  
 +
'''Note:''' ReNamer is designed primarily for automatic renaming based on a set of rules. Manual editing is an after-thought process which is available purely for convenience in case the final result need to be tweaked slightly. It is important to note that every time you regenerate new names the manual changes will be lost!
  
{| class="prettytable"
+
== Step by step ==
| <center>1</center>
 
| In the '''Files''' pane, select the file to be manually renamed
 
  
(click anywhere on its row).
+
The following steps explain the process of manual editing.
| [[Image:]]
 
  
 +
{| class="wikitable"
 
|-
 
|-
| <center>2</center>
+
!style="font-size:2em"| 1
| To enter '''Edit''' mode, do any of the following:
+
| In the '''Files''' pane, select the file to be manually renamed
 +
(click anywhere on its row).
  
# Press '''F2'''
+
| [[Image:ManualRenamingSelectFile.png]]
# Right-click on the filename and select the '''Edit New Name''' option
+
|-
# Slow-click on the file-name.
+
!style="font-size:2em"| 2
 +
| To enter '''Edit''' mode, do any of the following:
 +
#Press '''F2'''  
 +
#Right-click on the filename and select the '''Edit New Name''' option  
 +
#Slow-click on the file-name.
  
ReName enters '''Edit''' mode. The '''New Name '''column shows the file name in a box, and the file's name is highlighted.
+
ReName enters '''Edit''' mode. The '''New Name '''column shows the file name in a box, and the file's name is highlighted.  
  
Now you can-
+
Now you can:
  
* Type a new name to replace the old name entirely.
+
* Type a new name to replace the old name entirely.  
 
* Use left/right arrow keys to place your cursor anywhere in the name and add/delete/change a few characters.
 
* Use left/right arrow keys to place your cursor anywhere in the name and add/delete/change a few characters.
  
In this example, we will replace “2” with “ 3” (the effect is shown below).
+
In this example, we will replace ''2'' with ''3'' (the effect is shown below).  
| [[Image:]]
 
  
 +
| [[Image:ManualEditMode.png]]
 
|-
 
|-
| <center>3</center>
+
!style="font-size:2em"| 3
 
| To end the '''Edit''' mode, press '''ENTER '''(or click anywhere outside the edit box).  
 
| To end the '''Edit''' mode, press '''ENTER '''(or click anywhere outside the edit box).  
 +
The newly edited name is shown as preview (the file is not renamed yet).
  
The newly edited name is shown as preview (the file is not renamed yet).
+
*You can abort the renaming by pressing '''ESC. '''
 
 
* You can abort the renaming by pressing '''ESC. '''
 
 
 
 
 
| [[Image:]]
 
  
 +
| [[Image:ManualEditModePreview.png]]
 
|-
 
|-
| <center>4</center>
+
!style="font-size:2em"| 4
| To ''actually'' [#3.4.Renaming the files|outline rename the file], click on the [[Image:]] button.
+
| To ''actually'' rename the file, click on the [[Image:RenameButton.png]] button.  
| [[Image:]]
+
| [[Image:ManuallyRenamedFiles.png]]
 
 
 
|}
 
|}
Note that manual renaming has a major limitation: It must be the ''last'' operation before renaming. Any activity in ReNamer '''GUI '''(such as adding/removing a file, adding/removing/editing a rule, pressing the '''Preview''' button, etc.) may reset the results of the manual renaming! This happens because manual renaming is not a rule; so its results cannot be passed on to the other rules for further processing. The rules ''always'' start with the file's original name.
 
  
We will check this out with multiple examples.
+
== Manual changes can get lost ==
  
 +
Manual changes will be lost if the new names are regenerated as a result of a [[ReNamer:Previewing files|Preview operation]], executed either:
 +
* automatically ([[ReNamer:Program_settings#Preview_settings|auto preview]] option triggered by added files or changed rules), or
 +
* manually (by clicking the "Preview" button).
  
{| class="prettytable"
+
This happens because manual changes are not rule based and such changes cannot be passed on to other rules for further processing. The process for generating new names uses the rules stack and always starts with the original file name.  
| <center>1</center>
 
| '''Example-1:''' If you add a new rule, the effect of manual renaming is lost.
 
  
In this example, the file was renamed manually, and then a single [#4.9.Case Rule|outline Case Rule] was added to convert the names to ALLCAPS. Notice that this rule actually ignored the manually given name (“'''Name 3'''”) and acted on the ''original'' name of the file (“'''Name2'''”), and made it '''“NAME2”.'''
+
If you wish to make manual changes to the new names permanent or semi-permanent you have two options:
| [[Image:]]
+
# After making manual changes, perform the renaming so that the changes are committed, then you can continue adding new rules.
 +
# After making manual changes, export new names into clipboard via the "Export" menu, then add new [[ReNamer:Rules:UserInput|UserInput rule]] and paste the list of new names from the clipboard. This effectively creates a saved state of all new names in a rule.
  
|-
+
=== Examples ===
| <center>2</center>
 
| '''Example-2:''' Manual renaming works '''''if''''' done '''''after''''' all the rules are added.
 
  
 +
The following examples demonstrate when manual editing works and when it does not, and your manual changes will be lost.
  
This is the reverse of the Example-1: Here, the ALLCAPS rule was added first. As soon as it was added, It acted on both files. The second file was manually renamed ''after'' that. So its name is changed from '''NAME2''' to “'''Name 3'''”.
+
{| class="wikitable"
 +
|-
 +
| '''Example-1:'''<br/>Manual renaming is always lost if '''Preview''' button is pressed.
 +
| If we press the '''Preview''' button, the manual renaming is lost, and the rules in the '''Rule''' pane take over again!
  
To conclude, the effect of the manual renaming survived because it was done ''after'' adding the rule.
+
In this example, we renamed the second file manually, and ''then'' pressed the '''Preview''' button. As a result, the ALLCAPS rule acted on the ''original'' name ('''Name2''') again, and converted it into '''NAME2.'''
| [[Image:]]
 
  
 +
| [[Image:ManualRenamingEx1.png]]
 
|-
 
|-
| <center>3</center>
+
| '''Example-2:'''<br/>Manual renaming may be lost when files are added (if the '''Auto preview when new files are added''' mode is turned ON).
| '''Example-3:''' Manual renaming is lost if '''Preview''' button is pressed.
+
| In this example, the preview options are set to refresh the preview whenever new files are added to the '''Files''' pane of ReNamer. So, if we add a new file, ReNamer behaves as if we pressed the '''Preview''' button (and the manual renaming is lost).  
  
If we press the '''Preview''' button, the manual renaming is lost, and the rules in the '''Rule''' pane take over again!
+
So the net effect is same as the '''Example-1''' (above).
  
In this example, we renamed the second file manually, and ''then'' pressed the '''Preview''' button. As a result, the ALLCAPS rule acted on the ''original'' name ('''Name2''') again, and converted it into '''NAME2.'''
+
Compare the three screenshots:  
| [[Image:]]
 
  
|-
+
The first screenshot shows the effect of the [[ReNamer:Rules:Case|Case Rule]], which is set to convert the name to ALLCAPS. Both file names are turned ALLCAPS.
| <center>4</center>
 
| '''Example-4:''' Manual renaming is lost when files are added (when the '''auto preview''' mode is turned ON)
 
  
In this example, the [#5.3.2.Preview settings|outline preview options] are set to refresh the preview whenever new files are added to the '''Files''' pane of ReNamer. So, if we add a new file; ReNamer behaves as if we pressed the '''Preview''' button (The manual renaming is lost.)
+
The second screenshot shows that the file '''Name2''' is manually renamed to '''Manual'''. (The ALLCAPS rule still works on the first file.)  
  
So the net effect is same as the '''Example-3''' (above).
+
The third screenshot shows what happens when the '''New file''' is added to the '''Files''' pane: The '''auto preview '''mode forces a refresh of the pane. As a result, the name of the second file is reset to its original name. Then the ALLCAPS rule acts ''afresh'' on all three names, and turns all the three file names to ALLCAPS.  
  
Compare the three screenshots:
+
The net effect is as if the manual renaming was never done at all.
  
The first screenshot shows the effect of the [#4.9.Case Rule|outline Case][#4.9.Case Rule|outline  Rule, ]which is set to convert the name to ALLCAPS. Both file names are turned ALLCAPS.
+
| [[Image:ManualRenamingEx4.png]]
 +
|-
 +
| '''Example-3:'''<br/>The effect of manual renaming may be lost when you add a new rule (if the '''Auto preview on change of rules configurations''' mode is turned ON).
 +
| In this example, the preview options are set to refresh the preview on any change to the rules.<br> The file was renamed manually, and then a single [[ReNamer:Rules:Case|Case Rule]] was added to convert the names to ALLCAPS. Notice that this rule actually ignored the manually given name ('''Name 3''') and acted on the ''original'' name of the file ('''Name2'''), and made it '''NAME2.'''
  
The second screenshot shows that the file '''Name2''' is manually renamed to '''Manual'''. (The ALLCAPS rule still works on the first file.)
+
| [[Image:ManualRenamingEx1.png]]
 +
|-
 +
| '''Example-4:'''<br/>Manual renaming works '''''if''''' done '''''after''''' all the rules are added (no matter what the AutoPreview settings are).
 +
| This is the reverse of the '''Example-3'''. The preview options are also set to refresh the preview on any change to the rules. But this time the ALLCAPS (Case) rule was added first. As soon as it was added, It acted on both files. The second file was manually renamed ''after'' that. So its name is changed from '''NAME2''' to '''Name 3'''.  
  
The third screenshot shows what happens when “New file” is added to the '''Files''' pane: The '''auto preview '''mode forces a refresh of the pane. As a result, the name of the second file is reset to its original name. Then the ALLCAPS rule acts ''afresh'' on all three names, and turns all the three file names to ALLCAPS.
+
To conclude, the effect of the manual renaming survived because it was done ''after'' the last Preview (triggered by adding the rule in this case).  
  
The net effect is as if the manual renaming was never done at all.
+
| [[Image:ManualRenamingEx2.png]]  
| [[Image:]]
+
|}
  
|}
+
[[Category:ReNamer]]

Latest revision as of 16:05, 29 April 2014

Arrow Return.png ReNamer  

In addition to combining multiple rules to automatically generate new names, you can also make manual changes to the new names. This can be useful for performing minor tweaking of the new names before completing the renaming process.

Note: ReNamer is designed primarily for automatic renaming based on a set of rules. Manual editing is an after-thought process which is available purely for convenience in case the final result need to be tweaked slightly. It is important to note that every time you regenerate new names the manual changes will be lost!

Step by step

The following steps explain the process of manual editing.

1 In the Files pane, select the file to be manually renamed

(click anywhere on its row).

ManualRenamingSelectFile.png
2 To enter Edit mode, do any of the following:
  1. Press F2
  2. Right-click on the filename and select the Edit New Name option
  3. Slow-click on the file-name.

ReName enters Edit mode. The New Name column shows the file name in a box, and the file's name is highlighted.

Now you can:

  • Type a new name to replace the old name entirely.
  • Use left/right arrow keys to place your cursor anywhere in the name and add/delete/change a few characters.

In this example, we will replace 2 with 3 (the effect is shown below).

ManualEditMode.png
3 To end the Edit mode, press ENTER (or click anywhere outside the edit box).

The newly edited name is shown as preview (the file is not renamed yet).

  • You can abort the renaming by pressing ESC.
ManualEditModePreview.png
4 To actually rename the file, click on the RenameButton.png button. ManuallyRenamedFiles.png

Manual changes can get lost

Manual changes will be lost if the new names are regenerated as a result of a Preview operation, executed either:

  • automatically (auto preview option triggered by added files or changed rules), or
  • manually (by clicking the "Preview" button).

This happens because manual changes are not rule based and such changes cannot be passed on to other rules for further processing. The process for generating new names uses the rules stack and always starts with the original file name.

If you wish to make manual changes to the new names permanent or semi-permanent you have two options:

  1. After making manual changes, perform the renaming so that the changes are committed, then you can continue adding new rules.
  2. After making manual changes, export new names into clipboard via the "Export" menu, then add new UserInput rule and paste the list of new names from the clipboard. This effectively creates a saved state of all new names in a rule.

Examples

The following examples demonstrate when manual editing works and when it does not, and your manual changes will be lost.

Example-1:
Manual renaming is always lost if Preview button is pressed.
If we press the Preview button, the manual renaming is lost, and the rules in the Rule pane take over again!

In this example, we renamed the second file manually, and then pressed the Preview button. As a result, the ALLCAPS rule acted on the original name (Name2) again, and converted it into NAME2.

ManualRenamingEx1.png
Example-2:
Manual renaming may be lost when files are added (if the Auto preview when new files are added mode is turned ON).
In this example, the preview options are set to refresh the preview whenever new files are added to the Files pane of ReNamer. So, if we add a new file, ReNamer behaves as if we pressed the Preview button (and the manual renaming is lost).

So the net effect is same as the Example-1 (above).

Compare the three screenshots:

The first screenshot shows the effect of the Case Rule, which is set to convert the name to ALLCAPS. Both file names are turned ALLCAPS.

The second screenshot shows that the file Name2 is manually renamed to Manual. (The ALLCAPS rule still works on the first file.)

The third screenshot shows what happens when the New file is added to the Files pane: The auto preview mode forces a refresh of the pane. As a result, the name of the second file is reset to its original name. Then the ALLCAPS rule acts afresh on all three names, and turns all the three file names to ALLCAPS.

The net effect is as if the manual renaming was never done at all.

ManualRenamingEx4.png
Example-3:
The effect of manual renaming may be lost when you add a new rule (if the Auto preview on change of rules configurations mode is turned ON).
In this example, the preview options are set to refresh the preview on any change to the rules.
The file was renamed manually, and then a single Case Rule was added to convert the names to ALLCAPS. Notice that this rule actually ignored the manually given name (Name 3) and acted on the original name of the file (Name2), and made it NAME2.
ManualRenamingEx1.png
Example-4:
Manual renaming works if done after all the rules are added (no matter what the AutoPreview settings are).
This is the reverse of the Example-3. The preview options are also set to refresh the preview on any change to the rules. But this time the ALLCAPS (Case) rule was added first. As soon as it was added, It acted on both files. The second file was manually renamed after that. So its name is changed from NAME2 to Name 3.

To conclude, the effect of the manual renaming survived because it was done after the last Preview (triggered by adding the rule in this case).

ManualRenamingEx2.png