IndexMaker is a java-based software with a simple and single purpose : scanning a folder and creating HTML an index file in each sub-directory, with relative links to all the files in that sub-directory.
Basic use is pretty straightforward :
| Download Link | Type | Date & Version | Status |
|---|---|---|---|
| indexmaker.jar (click here to download) | Executable | v. 0.4 - 18 jun. 2011 | Beta |
| indexmaker.zip (click here to download) | Source | v. 0.4 - 18 jun. 2011 | Beta |
You can find some advanced options in the Options tab [Screenshot].
The index.html files are generated following a template. The default template is crude :
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>#TITLE#</title>
</head>
<body>
#CONTENT#
</body>
</html>
You can change this template in IndexMaker [Screenshot] or load a plain text file. You can also modify the template in IndexMaker and export it to a plain text file. You'll have to load that file if you want to use your custom template again.
Templates can use 3 placeholders :
You can exclude some files and directories from indexing, according to their name. Each file or directory is tested against a list of rules (regular expressions) and, if a match is found, the file or directory is excluded.
IndexMaker comes with 3 rules [Screenshot] :
You can delete one or more of these rules, but they will be back the next time you launch IndexMaker. You can also add your own rules, but they will vanish when you quit IndexMaker.
Rules of exclusion are a powerful tool. Remember 2 things :
Imagine a directory named "X".
Default is not checked. Let it unchecked if you upload your files to a web server (URL is : http://...). Check it if you open the files in your browser without a web server (URL is : file:///...).
If checked, IndexMaker will remember the last folder you indexed, and select it the next time you launch the program. This is useful if you always index the same root folder, and don't want to have to select it each time you launch IndexMaker.
This bunch of options let you customize the way the <a> tag is created.
First, you can add some HTML (or PHP, or whatever) code BEFORE and/or AFTER the tag. If you write "foo1" and "foo2" in the BEFORE <a> and AFTER </a> fields, the output will be : foo1<a href="...">...</a>foo2. For folders, you can use the #COUNT# placeholder to show the number of files and sub-folders in that folder.
Second, you can specify a CSS class, a style and a target for every link. Let's say class is mylink (without the dot!), style is color:red; and target is _blank, the output will be : <a class="mylink" style="color:red;" target="_blank" href="...">...</a>.
The "Apply to" combobox let you choose to use those properties with files only, folders only, or both files and folders.
Please keep in mind the following:
1) IndexMaker first applies the "files only" or "folders only" options to the link, and then, if possible (class, style, before, after), the "both file and folders" options.
2) After changing those options, you HAVE TO save your preferences.
Example:
After A (file) : "no count !" -- After A (folder): "(#COUNT#)" -- After A (both files and folders) : " Count: "
will output :
- for a file : my_file Count: no count !
- for a folder: my_folder Count: (x)
IndexMaker is a software by Guillaume Florimond (Valhalla.fr, 2010), distributed under the terms of the Creative Commons Attribution-Share Alike 2.0 France licence
Official address : http://asgard.valhalla.fr/indexmaker/
You'll have to download the Java Runtime Environment (JRE) from Sun/Oracle and install it, if you don't already have it.
To launch IndexMaker, double-click on the indexmaker.jar file you've just downloaded.
To launch IndexMaker, double-click on the indexmaker.jar file you've just downloaded.
Installing on Linux is a little bit more complicated than installing on Windows or Mac. First, you'll need a Java Runtime Environment (JRE). You can download the official (and proprietary) JRE from Sun/Oracle or use the free OpenJDK.
On Ubuntu/Debian, open a Terminal window, and use this command:sudo apt-get install openjdk-6-jre
On Fedora, open a Terminal window, and use this command:su -c "yum install java-1.6.0-openjdk"
JAR files downloaded from the Internet are NOT executable. You'll have to make the downloaded JAR file executable in order to be able to launch IndexMaker by double-clicking on its icon. Open a Terminal window, and use this command: chmod 777 indexmaker.jar
Launch from command line. Use this command: java -jar indexmaker.jar
Launch from Gnome desktop. With Nautilus, right-click on indexmaker.jar and select Properties. In the Open With tab, select the Sun JRE or OpenJDK entry is not already selected. Close the window. You should now be able to launch IndexMaker with a double-click on indexmaker.jar.
0.4.2 (20 jun. 2011)
- Different link customization options for Files and Folders
- New placeholder #COUNT# for the "before link" and "after link" options (folders only)
- Added an option to remember the last root folder and pre-select it
0.4.1 (18 jun. 2011)
- New #BREADCRUMB# placeholder
- User preferences (record everything but the root folder and the exclusion list)
- Some UI tweaks
0.3 (25 apr. 2010)
- Exclusions list
- Advanced options (<a> tag customization)
- Template load from / save to file
0.2 (22 apr. 2010)
- Progressbar while indexing
- Index log after indexing
- Other GUI improvements
0.1 (18 apr. 2010)
- Recursive scan of a root directory
- index.html generation with a template
Q: Do I need this?
A: Probably not.
Q: Should I use this?
A: Sure!
Q: Will it kill my dog and burn my house?
A: Maybe. Who knows?
Q: Will it wipe my hard drive?
A: Unfortunately not.
Q: ... and your liability?
A: None :)
Q: Seriously, is it dangerous?
A: It's not (seriously). But if you misuse it, you could end up with lots of useless index.html files on your computer. So be sure to select the right root folder. Don't worry, you'll be able to review your choice before starting the indexing process.
Q: You weren's kidding on the last one, right? Got'ya!
A: Err...
Q: Is it optimized?
A: Of course! Bloated softwares raise CPU load and power consumption, and creates carbon dioxide. Optimized softwares fight global warming! Well, no, actually... anyway, it's a Java software (troll?). It's not optimized, it's just user-friendly (GUI, progress bar, log, etc.).
Q: Why so many windows?
A: Well, because 1) MDI is so presocratic ; 2) you don't always need all options and functions on the main window, that would be more confusing than helpful ; 3) netbook screens are so small, and it had to fit! ; 4) my IDE makes it fun to add JWindow classes :)
Q: Why does the interface look so wierd?
A: First, it's not wierd, it's Nimbus! Second, have you seen the Swing native look on Mac?
Q: There are two kind of people in this world: those who think there are two kind of people, and those who don't. Who do you think is right?
A: A is in Q.
Q: Why are you wasting your time writing such silly things?
A: I'm currently wasting yours, dear reader, not mine. (I bet you thought the answer was "why are you wasting your time asking suck silly questions?" -- well, no!)
Q: Is this the end?
A: This is the end, my beautiful friend, the end...