The Archivist's Guide to Archiving

From Caelwiki

Revision as of 06:06, 31 October 2007

Greetings, archivists in training!

We're here with a couple (...ok, a lot) of tips to help you get started in creating logs of IRC transcripts, hopefully as painlessly as possible. To be clear, creating a clean log DOES take some effort, so be prepared to set aside a good chunk of time to devote to your archiving. It is difficult at first, but will get faster with practice.

What should be Archived?

We usually archive sessions that involve a DM's participation. This gives a sort of structure that will help the formatting and lends the session authenticity within the story arc. When significant character development occurs outside of a structured RP session, and is accepted within the RP universe, such non-DM run sessions may be logged as well. (see In memoriam: Hadin the Artificer passes on for an example)

Sessions to be archived start off as raw logs captured from your IRC client. There may be several channels involved in the telling of a particular session, as well as possible PM logs to individual characters. Be thorough in collecting all the necessary data!

How do I get these logs?

You first need to have an IRC client that allows for logging (i.e. mIRC, Ircle, Trillian). The Java applets do not log. Your client should have an option somewhere for turning logging on, check the help file if you can't find it. Make sure to log both channels as well as queries, as there may be sessions that involve private messages to your character from the DM.

Also make sure you find out where your client is storing the logs, and what format they're in! Some log as plain text files, some as .xml, and there are other variations. Be sure whatever format you save as is editable in a text editor. You may also want to check with a few test logs to make sure they don't write over each other.

Finally, turn on timestamps! They're not necessary, but they can be helpful in figuring out how to piece together multiple-channel-spanning logs.

If you absolutely cannot get logging to work on your computer but you really want to help out archiving, there are several players on Caelestia who log everything, and if you ask them nicely, they may email you a copy of their raw log. ;)

Ok, I've got the logs, what do I do now?

This is a method I've worked out for clarity of DM direction, as they usually write the story. It is by no means the only way to log a session, and you may argue the players contribute just as much to the session as the DM. However for the purposes of this tutorial I am going to consider the DM's direction as the final say in matters involving plot advancement and consider them the "authors" of the session.

What you're going to want to do with these logs is highlight the DM's lines in bold. It sounds simple enough, right? Well, there are a few ways to do it so it will show up in the wiki:

1. Use the wiki editor. There's a "bold" button in the top left corner that will add the proper tags into your entry. However, this involves actually moving your mouse around to highlight the line, then click the button over and over again. This can be time consuming. There are also other factors to take into consideration (more on this below)
2. Use an outside editor. You'll want one that can utilize the ctrl-B command to automatically bold a line, and can also translate your log into html code when you're finished. Googledocs is a good editor, I've found. Once you're done bolding the lines you need, you can click "Edit HTML" to get the proper code to paste into wiki.

Either way, you'll want to make sure when you paste the raw log into your editor, it includes line breaks. If you're getting a big block of text with a bunch of <BR>s in it, that will be a nightmare to edit.

This is what you don't want to start with as a raw log:

This is what you do:

NOTE - If you are logging within the Wiki editor, you will need to specify each line break with a colon ":". You can do this by hand (again, time-consuming), or you can open up your log in Notepad and use the "Find and replace" function to add it in automatically. Replace all "[" with ":[" and that should do it for ya.