Contents - Index

List Builder


The List Builder facility provides tools to enable you to build a tab-indented list from a number of smaller files. The List Builder is located in the top-right 'Extensions' section of your screen. If the  'Extensions' section is not currently showing, click 'View > Show Extensions', or press 'Ctrl+Shift+E' on your keyboard. Select the 'List Builder' page by clicking on it's tab.


The names of the smaller files that we will use to build a larger one, and their positions relative to each other, are stored in a 'Recipe'. These Recipes can be loaded and saved, as you like. To create a new Recipe, enter a Recipe Name in the upper 'Recipe Name' box. The name should only contain a-z, A-Z, 0-9, period, space, hyphen, or underline characters. It should also be at least 4 characters in length. After entering a name, click the 'New Recipe' button, and the Recipe Name label will turn green, indicating that it is ready to start accepting files.


To add a file, click the 'Add' button, then navigate to the first file for your recipe. The file will be added to the list, and the number of indents on the file's first and last lines will be shown in the 'Start' and 'End' columns. The 'Recipe Name' label will turn red, indicating that the recipe has been altered. The 'Recipe Name' box will turn green, showing that everything is OK. Add a second file, and notice that the boxes in the 'Start' column for the second file and the 'End' column for the first file will be colored green if the indent values between files are compatible, or red if there is a problem. Errors are defined by these simple rules: The first file must have 0 start-indents. The second, and subsequent files must have not more than 1 indents more than the previous file.


You can also add files to a List Builder Recipe by right-clicking them in 'Directories' and selecting the 'Add to List Builder' option from the right-click menu.


The scroll-bar at the bottom of the List Builder shows you the number of lines in each file, its size in Bytes, its Last-Modified date and time, its Attributes, and it's File Path. There is a final section marked 'Comment'. If you right-click any file in the List Builder, you can choose 'Add/Edit Comment' and add a comment for that file. This can be useful to remind you of the file version, or other information that is useful to you. Comments will be saved when the Recipe is saved.


Once a file has been added to a Recipe, you can view the file if you need to, by right-clicking one and choosing 'View in Current Page' or 'View in New Page'. The files will be opened in 'Read-Only' mode to stop you editing them by mistake, though you can turn the lock off if you wish by clicking 'Edit > Unlock Page' in the Menu Bar, or by pressing 'Ctrl+L' on your keyboard.


You can re-arrange the order of files in the List Builder by selecting one, then clicking the 'Up', or 'Down' buttons. You can remove a file from the Recipe by selecting it then clicking the 'Remove' button. After moving or removing a file, the resultant indent-mismatches will be reported as before. When you are satisfied with your Recipe, click the 'Save Recipe' button. The 'Recipe Name' label and box will turn blue, to show that the Recipe has indeed been saved, and a popup-box will confirm the filename it has been saved with. The file-type for Photo-Keywords List Builder Recipes is '.pklb'.


To build a Recipe, click the 'Build' button. A file-dialog will open, letting you choose the filename and path. When the file has been saved, a message-box will confirm this, and give you the option of viewing the completed file in a Workspace page.