[ Help support Diarist.Net - Visit our sponsors. ]

[ Diarist.Net Logo ] [ Diarist.Net ]
MAIN | GUIDE | PREFLIGHT | SITE STRUCTURE

  FROM THE GROUND UP
  SET IT APART: Is your journal a stand-alone site, or will it be part of a larger personal site? Either way, you will probably want to keep all your journal files in a subdirectory, rather than mixed in with your pet photos and bunt cake recipes.

DATES AS FILENAMES: Whether you break your entries down by month, week, or day, how you name the individual files make a big difference in the long run. The computer-friendly YYYYMMDD.html format is your best bet, as entries will list in the correct order in each directory. Compare that to Jan600.html, which would end up listed after Feb1399.html, and even after Jan1300.html.

THINK LONG TERM: You might be starting your web journal on a whim, but if you end up finding it as addicting as we do, you might find yourself painted into a corner when you end up with hundreds of entries spanning three years. Subdirectories for years are thus a good idea, and perhaps even for each month. Also, many web designers segregate HTML files from graphics (.GIFs and .JPGs). Go with what makes the most sense to you.

CHANGE IS TOUGH: Although we don't want to put any more pressure on you, you should be aware that one of the messiest, hardest things web journalers run into is wanting to change their design, or site structure. Consistency is good for a web site, but chances are you won't be up to reformatting the last six months of writing to match your latest sexy layout. And moving one or two things around might make old links and images break. To avoid this, diarists often start new journals from scratch, saving older entries as an earlier, self-contained "volume."

your journal's skeleton
BY MATTHEW COBURN
Before you fire up FrontPage, summon Notepad, or start whatever program you use to write your journal, take out a pencil and a piece of paper.

Before you think up a name, or design your fancy page layouts, you should plan out the structure of your site the directories, file naming conventions, and the other nuts and bolts that will help you manage what will hopefully become a considerable collection amount files.

Otherwise, you run the risk of being like me, tearing your hair out, screaming to yourself, "Where is that damnable GIF? What directory is it in?" And believe me, that is no fun.

Just for your amusement (or my self-deprecation?), I'll use my site as a cautionary tale. I am in the midst of a redesign because, in its current state, it has become quite unmanageable.

My poor journal was quite a rash creation. I sat down one day with the need to vent a little spleen and 'geekboy' was born. I just sat down and started typing and by the time I finished I realized what a cathartic experience it was. So I whipped up a graphic to go with the page, created a fairly snazzy looking splash page and voila! a journal was born.

Not good. Not good at all. Below, the skeleton of two journals. The one on the left is my current setup, and the one I plan to implement is on the right.

[ Directory structures: good and bad. ]Now, while the one on the right may look nice and simple, believe me, when you are looking for a particular file and you have to wade through 62 files (like the 62 files sitting in the oldgeek/archive folder), you'll be kicking yourself for not organizing your site better beforehand.

Plus, I have an img, images, and bin folders in my old design. Why? Damned if I know. All three contain graphics for the site, scanned photos, doodles and the like. But I never thought about how I was going to store them as I began, so they wound up spread all over the place.

With the new structure all my images for the site (navigation, splash page, etc.) will go into the image folder; the planned photo section will reside in the geek2 folder, with the actual photos living in the photos folder. And my style sheets will be referenced to the css folder, so I don't have an extra 20-30 lines of text in each file. (We'll cover CSS later on, I promise.)

Also, with the new structure, every entry will go in a folder for the month it was written in (01 through 12) which in turn resides in a folder that corresponds to the year in which it was written.

"What's the big deal about that?" you may ask. Well, for starters, you don't have to think up strange file names for your entries. Mine used to be gb-081098.html and that can get confusing. With the newer directory structure, the same file will simply be called 10.html and will rest in the 98/08 folder.

(As the turn of the century taught us, though, you might want to use 1999 instead of just 99 at least so that the directories will sort properly in a list.)

So before you take the plunge and start journaling, make sure you've got your swim trunks on (and that they're tied tightly), that it's been at least an hour since you've eaten, and... oh wait... my train of thought derailed there for a second.

What I meant to say was, get the map out or at least think about how you are going to organize the site before you get started. That way, six months down the line when you want to go back and modify things, you'll know where to find them.

I know that it's not as exciting as visiual design and slinging HTML, but it is just as important.

Matthew Coburn is a veteran contributor to Diarist.Net. He can be reached at .



Updated: 3 December 2000 © 2000 Diarist.Net Contact: