Stacks Image 1097

Advanced

Some advanced features which give you total control of your final output files.quet.
You can also export the file and folder information as raw XML for additional processing.
If you wish to create your own CSS or XSL files you can export the default files used by Folder Index to use as templates.

I use CSSEdit and BBEdit to custom these files.

Once you have the files modified the way you want you can use Folder Index Preferences to set them for use.

It is very easy to introduce errors within your files.
To switch Folder Index back to using its defaults click the X buttons in the Preference window.

You can always export new copies of the templates to start again.
If you wish to create your own CSS or XSL files you can export the default files used by Folder Index to use as templates.

I use CSSEdit and BBEdit to custom these files.

Once you have the files modified the way you want you can use Folder Index Preferences to set them for use.

It is very easy to introduce errors within your files.
To switch Folder Index back to using its defaults click the X buttons in the Preference window.

You can always export new copies of the templates to start again.
If you wish to custom your final results this is the best workflow:

Create a standard Folder with the default settings and files.

Export the index.xsl to this folder.

In the folderindeximages folder replace the logo.png with your new logo, rename it to logo.png if necessary.

Edit the index.xsl file, re-run Folder index to create the new html output file.

Edit the folderindex.css file, give it the layout and look you require.

As long as you don’t change these files names you can make changes to them and re-run Folder index until you get the resulting html you want.

Once you have the correct results then rename the Logo, CSS and XSL files.
In the Preferences snapshot them into Folder index, now each time you run Folder index it will use these new settings.
Now you should file them away in case you want to make more changes later.
Once you have used Folder Index to create its files within a target folder you can select the same target folder again to update it with any changes. There are 3 main files that may be changed and overwritten if you do this. You can also set alternatives for the Logo, CSS and XSL files used.

Logo:
The logo.png file is in the folderindeximages folder.
When you set a Logo file in the Preferences your preferred logo will be moved to the folderindeximages folder. Folder Index will delete any existing file with the same name when creating a new file from the preference. The preferred logo name will be used in the index.html. The Preference Logo file will replace any existing logo. Do not use a "file extension" as the name of your logo file.

When no Preference is set, Folder Index checks the images folder and if there is a file there named logo.png it does NOT overwrite this file. If you have renamed another file logo.png and manually replaced the default file, it will NOT be overwritten. To replace this replacement logo with the default logo, delete the whole folderindeximages folder and Folder Index will create a new logo.png.

CSS:
The folderindex.css is at the root level of the target folder.
When you set a CSS file in the Preferences your preferred css will be moved to the target folder. The app will move any existing file with the same name to the Trash. The preferred css file with be used by the index.html.

When no Preference CSS is set, Folder Index checks whether a folderindex.css file exists in the target folder, if it does it will NOT replace it. Any changes you make to this CSS file will be retained.

XSL:
The xsl file is used to transform the XML of the internal file references into HTML.
When you set a preferred xsl file Folder Index will use that file to transform the XML and save the results as index.html. If your xsl transforms the content to text or xml, you may wish to change the filename and extension in the Preferences.

The index.html is always replaced.

If there is a XSL file named index.xsl in the target folder Folder Index will use that instead to the default internal xsl.
v3.5 Adds a user settable root href path, and adds escape codes to the full href. Updated Help.