IndexMaker – Membuat index.html untuk koleksi file html yang di-download dari internetIndexMaker – Makes index.html for html files collection downloaded from internet

Saya suka mengoleksi file-file html yang berisi berbagai macam informasi yang biasanya saya peroleh dari internet.

Ada beberapa kumpulan file yang saya peroleh dalam bentuk paket, misalnya adalah berbagai file untuk tutorial. Untuk file-file yang seperti ini biasanya saya langsung mendapatkan file index.html yang berfungsi untuk mengakses semua file lainnya dengan mudah.

Kumpulan file html yang lain ada yang saya peroleh dengan mengambil dari situs tertentu menggunakan software semacam teleport, sehingga semua link yang terdapat pada situs tersebut akan secara otomatis diambil dan tentu saja kita juga secara otomatis mendapatkan file index-nya.

Kumpulan file jenis ketiga adalah file-file yang diperoleh dari berbagai macam sumber yang kemudian saya tempatkan pada direktori tertentu yang saya beri nama sesuai dengan kategori dari isi file-file tersebut. Akan tetapi karena file-file tersebut saya peroleh dari mengumpulkan dari berbagai sumber, maka tentu saja pada direktori tersebut tidak memiliki file index.html yang berfungsi untuk mempermudah penjelajahan isinya. Akibatnya, untuk mengakses file-file pada direktori tersebut saya harus bolak-balik dari windows explorer untuk melakukan klik ganda dari sana, kemudian menuju browser seperti internet explorer, opera, dan lain-lain.

Cara browsing file seperti di atas bukanlah cara yang menyenagkan. Pertama, kita harus bolak-balik untuk mengaktifkan windows explorer, kemudian kembali pada browser, dan setelah selesai membaca, kita kembali lagi pada windows explorer. Kedua, jumlah window untuk browser yang dibuka jadi terus bertambah, atau jika kita menggunakan browser yang mendukung multiple tab, maka jumlah tab yang dibuka juga semakin bertambah. Hal ini menyebabkan kita harus menambah pekerjaan ekstra yaitu menutup window atau tab tersebut. Ketiga, kita jadi kurang bisa mengikuti file mana saja yang telah kita buka dan file mana yang belum. Keempat, ini adalah akibat sampingan dari menutup window-window yang terbuka yang jumlahnya membuat desktop kita terasa sempit, atau menutup tab-tab pada browser yang jumlahnya sudah terlalu banyak sehingga kita bahkan kesulitan untuk membaca judul tab-nya. Nah setelah kita tutup, terkadang kita harus kembali lagi untuk membaca file yang sudah ditutup tersebut. Akibatnya kita harus kembali lagi ke windows explorer untuk kembali klik ganda file yang mau kita buka lagi tersebut. Huh, menyebalkan 🙁

Ada solusi lebih baik, yaitu kita membuat sendiri file index.html yang berguna untuk mempermudah browsing. Sayangnya jika koleksi file pada direktori tersebut cukup banyak, maka pekerjaan membuat index.html ini menjadi sangat membosankan. Wah, kita sudah harus merasa bosan sebelum kita sempat browsing. Kalau kategori pada direktori tersebut adalah kategori cerita seru, cerita seram, atau bahkan mungkin cerita saru 😀 mungkin upaya membuat index.html yang membosankan tersebut akan segera terobati setelah kita membaca cerita s?r* tersebut. Akan tetapi jika kategori pada direktori tersebut adalah kategori cerita serius (ilmu pengetahuan) yang masih berpola s?r*, tetapi isinya seringkali membuat kepala pusing, maka kita benar-benar mendapatkan siksaan. Bosan, kemudian pusing, Huuuh 🙁

Nah, daripada saya harus medapatkan siksaan tersebut, maka akhirnya saya membuat program untuk membuat file index.html tersebut secara otomatis. Program tersebut saya beri nama IndexMaker.exe.

Cara menggunakan IndexMaker.exe sangatlah mudah. Kita cukup menempatkan program tersebut di direktori tempat berkumpulnya koleksi file-file txt, html, htm, atau mht. Setelah itu, klik ganda IndexMaker.exe untuk menjalankannya. Nah, IndexMaker.exe akan menambahkan sebuah file index.html yang merupakan file html yang berfungsi untuk mempermudah browsing direktori tersebut, file toc.html yang merupakan daftar isi dari file-file html, htm, dan mht pada direktori tersebut, dan yang terakhir adalah file cover.html yang akan tampil saat pertamakali kita membuka file index.html. Nah file yang terakhir ini sebaiknya dimodifikasi untuk mempercantik tampilan.

Anda juga dapat mendaftarkan IndexMaker ke dalam registry sehingga kita bisa dengan mudah membuat index.html untuk semua folder hanya dengan klik kanan folder yang akan dibuat index-nya, kemudian pilih Make Index.html. Caranya adalah dengan menjalankan IndexMaker dengan menambahkan switch -r. Sedangkan untuk menghapus IndexMaker dari registry, switch yang ditambahkan adalah -u. Atau Anda juga bisa menjalankan file Reg.bat atau Unreg.bat yang disertakan dalam bundel.

Setiap kali IndexMaker dijalankan, pertama kali IndexMaker akan mendeteksi apakah pada direktori tersebut telah terdapat file index.html atau belum. Jika sudah, maka IndexMaker akan menanyakan apakah akan mengganti file tersebut atau tidak. Jika pilihannya adalah Y, maka file index.html akan diganti dengan yang baru dan meminta beberapa parameter yang dibutuhkan. Parameter-parameter ini kemudian disimpan pada file IndexMaker.con yang ditempatkan pada folder tersebut. Dengan adanya file IndexMaker.con, maka setiap kali ada perubahan file pada folder tersebut, kita cukup melakukan klik kanan pada folder tersebut dan pilih menu Make Index.html dan file toc.html akan segera diperbarui tanpa melakukan perubahan pada file index.html dan cover.html. Dengan demikian jika Anda telah melakukan modifikasi pada cover.html untuk mempercantik tampilan, maka file tersebut tidak akan mengalami perubahan. Satu-satunya file yang diupdate hanyalah toc.html.

File IndexMaker.con sendiri merupakan file text yang berisi lima baris yang menentukan parameter-parameter pembuatan index. Baris pertama dari file ini akan menentukan title yang akan ditampilkan pada title bar dari browser. Baris kedua adalah isi yang akan ditampilkan pada cover.html. Baris ketiga menentukan apakah akan dilakukan penyingkatan nama file pada daftar di toc.html atau tidak. Pilihan untuk baris ini adalah Y atau N. Jika baris ini berisi Y, maka nama file yang panjangnya melebihi 23 karakter akan diambil 20 karakter pertamanya saja ditambah tiga titik (…). Baris keempat menentukan file apa saja yang akan didaftarkan ke toc.html. Penulisan ekstensinya dipisahkan dengan titik koma (;) dan tidak boleh ada spasi. Baris yang kelima, menentukan apakah pendaftaran file ke toc.html dilakukan juga sampai sub direktori yang terdapat dalam folder tersebut secara rekursif atau hanya mencatat file-file dalam direktori tersebut saja. Pilihan untuk baris ini juga Y atau N. Baris yang terakhir, yaitu baris keenam, menentukan tipe penamaan alamat pada address bar. Jika kita memberikan nilai Y, maka alamat pada address bar akan bergaya seperti menggunakan cgi, yaitu menggunakan tanda tanya(?). Misalnya adalah: …./index.html?1. Sedangkan jika nilainya adalah N, maka alamat pada address bar akan selalu tetap yaitu index.html.

Perlu diperhatikan, bahwa pilihan menggunakan pengalamatan menggunakan tanda tanya(?) tidak akan selalu berjalan mulus jika browser yang digunakan adalah internet explorer. Hal ini akan lebih terasa jika nama file-file pada direktori tersebut banyak menggunakan karakter-karakter yang aneh, atau karakter-karekter yang tidak biasa digunakan untuk nama file seperti tanda plus (+).

Dan terlepas dari apakah kita menggunakan alamat tetap atau alamat dengan tanda tanya, maka jika ada nama file pada direktori tersebut yang diawali dengan tanda (#), maka dipastikan bahwa link yang dibuat di dalam toc.html akan selalu gagal. Hal ini disebabkan oleh aturan bahwa href yang menggunakan tanda (#) akan mengacu pada anchor pada file yang sama. Dengan demikian browser tidak akan berpindah ke file yang lain akan tetapi akan tetap berada pada file yang aktif. Oleh karena itu, sebaiknya Anda tidak pernah menyimpan nama file html dengan awalan (#).

Struktur yang dibentuk oleh IndexMaker.exe adalah membagi halaman menjadi dua bagian menggunakan frame, masing-masing adalah 20% untuk bagian kiri, yang akan diisi dengan toc.html, dan 80% untuk bagian kanan yang pertamakali akan diisi dengan cover.html. Jika kita klik daftar nama file yang terdapat pada frame kiri, maka file tersebut akan menggantikan isi dari cover.html. Nah, dengan cara ini, proses browsing menjadi jauh lebih nyaman.

Dan sekarang saya tidak harus merasa bosan dahulu sebelum berpusing-pusing membaca halaman-halaman yang berisi petunjuk-petunjuk pemrograman. Setidaknya walaupun harus berpusing-pusing, tapi saya terbebas dari kebosanan 🙂

Kemudian saya berpikir bahwa mungkin banyak orang yang mengalami problem serupa dengan saya. Jadi, ketimbang program ini saya nikmati sendiri, alangkah lebih baiknya jika digunakan juga oleh orang lain yang membutuhkannya.

Dan jika Anda juga termasuk orang yang pernah atau bahkan sedang mengalami masalah yang sama dengan saya, maka Anda sangat beruntung karena Anda tidak perlu lagi membuat file index.html tersebut secara manual. Anda cukup mendownload IndexMaker.exe yang ukurannya relatif sangat kecil. Anda tidak perlu memikirkan berapa lama proses download akan selesai karena pasti sangat sebentar.

Ok, selamat bersenang-senang.

I like to collect the html files that contain various kinds of information that I usually get from the internet.

There is a set of files that I received in the form of packets, for example, is a variety of files for the tutorial. For files that are like this I usually get index.html file either to access all other files with ease.

Another set of existing html files which I get taken from a particular site using a software like teleport, so all links contained on the site will be automatically retrieved and of course we also automatically get its index files.

The third type is a collection of files obtained from various sources and then I put in a specific directory that I name in accordance with the category of the contents of those files. However, because the files I get from collecting from various sources, then of course the directory does not have an index.html file that serves to facilitate the exploration of its contents. Consequently, to access the files in that directory I have to go back and forth from windows explorer to do a double click from there, then go to the browser like internet explorer, opera, etc.

Browsing files as above is not an enjoyable way. First, we must go back and forth to activate windows explorer, then returned to the browser, and after reading, it’s back to the windows explorer. Second, the number of the opened browser window continue to grow, or if we are using a browser that supports multiple tabs, then the number of opened tabs also increasing. This led us to have to add extra work for closing the window or tab. Third, we become less able to follow which file has been opened and which file has not. Fourth, this is a side effect of closing many opened windows which make us feel the desktop is cramped, or closing too many tabs on the browser so we got trouble to read the title of its tab. Well after we close, sometimes we have to open it again to read the file which has been closed. As a result we have to go back to windows explorer to re-double click the file that we want it open again. Huh, sucks 🙁

There are better solutions, ie creating your own index.html file that is useful for easy browsing. Unfortunately, if the collection of files in that directory quite a lot, then the job of making this index.html is very boring. Well, we already have to get bored before we had time to browse. If the category in the directory is exciting stories category, may be a tedious effort to make index.html will be immediately relieved after we read the story. However, if the category in the directory is a science category, which often makes the head dizzy, then we really get the ordeal. Bored, then dizziness, Huuuh 🙁

Well, rather than to have to get such torture, then finally I made a program to create the index.html file automatically. I give the name of the program IndexMaker.exe.

The use of IndexMaker.exe is very easy. We simply put the program in the directory where the collection of files txt, html, htm, or mht are gathered. After that, double click the IndexMaker.exe to run it. Well, IndexMaker.exe will add an index.html file that is an html file that serves to facilitate browsing the directory, the toc.html file which is a list of the contents of the html, htm, and mht files in the directory, and the last is cover.html file that will appear when you first open the file index.html. Well the last file should be modified to enhance the appearance.

You can also register IndexMaker into the registry so that we can easily create index.html for all folders with just a right click on the folder you want to create its index, then select Make Index.html. The trick is to run IndexMaker by adding the -r switch. As for IndexMaker remove from the registry, the -u switch is added. Or you can also run Reg.bat or Unreg.bat file included in the bundle.

Every time IndexMaker run, first IndexMaker will detect whether the directory has been has an index.html file or not. If so, then IndexMaker will ask whether to replace the file or not. If the choice is Y, then the index.html file will be replaced with new ones and ask for some required parameters. These parameters are then stored on IndexMaker.con file placed in the folder. With the IndexMaker.con file, then whenever there are changes to the file in the folder, you simply right-click on the folder and choose Make Index.html and the toc.html file will soon be updated without making changes to the file index.html and cover.html. Thus if you have made modifications to cover.html to enhance the appearance, then the file will not be changed. The only file updated is toc.html.

IndexMaker.con file itself is a text file that contains five lines that define the parameters of index-making. The first line of this file will determine the title to be displayed on the title bar of the browser. The second line is the content to be displayed on cover.html. The third line determines whether it will be cutting down on the list of file names in toc.html or not. Options for this line is Y or N. If this line contains Y, then the file name exceeds 23 characters in length will be taken only the first 20 characters plus three dots (…). The fourth line determines what files will be registered into toc.html. Writing extensions separated by a semicolon (;) and there should be no spaces. The fifth line, determine whether the registration to toc.html file also done to sub directories contained in the folder recursively or just record the files in that directory. Options for this line also Y or N. The last line, ie sixth line, specify the type of naming the address in the address bar. If we give the value of Y, then the address in the address bar will be styled like using cgi, which uses a question mark (?). Example is: …./index.html?1. Whereas if the value is N, then the address in the address bar will always remain as index.html.

It should be noted, that the choice of using the addressing using the question mark (?) Will not always run smoothly if the browser used is Internet Explorer. This may be more pronounced if the name of the files in those directories use a lot of strange characters, or the characters that is not normally used for the file name like a plus sign (+).

And regardless of whether we use a fixed address or address by a question mark, so if there is a file name in the directory that begins with a pound sign (#), then certainly that the link made in the toc.html will always fail. This is caused by the rule that the href that uses sign (#) will refer to the anchor on the same file. Thus, the browser will not switch to another file but will remain on the active file. Therefore, you should never save the html file name with the prefix (#).

Structures formed by IndexMaker.exe is splitting page into two parts uses frames, each of which is 20% for the left part, which will be filled with toc.html, and 80% for the right part that the first time will be filled with cover.html. If we click on the list of file names contained in the left frame, then the file will replace the contents of cover.html. Well, in this way, the browsing process becomes much more comfortable.

And now I do not have to feel bored before get dizzy to read the pages that contain programming instructions. At least though it should got dizzy, but I am free from boredom 🙂

Then I thought that maybe more people are experiencing similar problems with me. So, rather than enjoy the program myself, would be much better if it is used also by others who need it.

And if you also the kind of people who have or are experiencing the same problem with me, then you are very lucky because you do not need to create the index.html file manually. You simply download the IndexMaker.exe which relatively very small size. You do not need to think about how long the download will be completed since it would have very soon.

Ok, have fun.