Showing posts with label annotations. Show all posts
Showing posts with label annotations. Show all posts

Monday, September 27, 2010

Swiki localhost for AniAniWeb as a personal home page.

AniAniWeb strikes me as a natural evolution of WikiWikiWeb.

But as a personal homepage, the Squeak Smalltalkers seem not to have tested on a mere netbook which is not itself running an SMTP mail server.

The reason that I note this is that setting up this Wiki as a home page requires that you simply login as 'admin' with a password  of 'password'.  Create your wiki.  But now try to use that swiki (read: edit those pages!)

The packagers did not realize that to edit, you must login, but to login you must be a user and that you can only become a user through responding to an e-mail with an e-mail.  But this is localhost on a netbook.  Ahem.

It would all be easy if they had admin:password as the values for a default user in a default XML file.  And that is in fact the solution that I offer here: place a file named 1.xml in the users folder of the default folder.

It is charming to  observe that for starters almost any garbage sufficed, because the swiki will attempt to re-write the file.  If sufficed to find which file placed where would cause the swiki to fail. And browsing the Smalltalk code helped. This is usually not a sign of secure software!  Without going through the amusing details, here is what will suffice:
<?xml version="1.0" encoding="UTF-8" ?>
<user name="admin">
<settings>
<s name="password" type="text">password</s>
<s name="address" type="text">yourname@yourmail.com</s>
<s name="sendAlerts" type="boolean">false</s>
<s name="showModified" type="boolean">true</s>
</settings>
</user>
Note that mail alerts are turned off, so the required email can be bogus.

N.B. do not save the file with a BOM (on Windows set the file's encoding using an editor such as Notepad++)

Friday, May 21, 2010

Marginalia and Text: glosses, scholia and annotations

I was struck yesterday by a publisher's decision to place the chapter titles on each page of a hardcover book in the margins - running vertically.  While this permits both margins and a few more lines per page, it almost prevents marginal notes. Running lines along the margins are still fine.  Are they trying to impede handy scanning of books (marginal text plays havoc with rapid electronic scanning of text by-the-page.)

What has become less common is a summation of each paragraph or section in the margin (often in a smaller font) as scholia or glosses.  Somewhat comparable are the Table of Contents with glosses such as found in Art and Its Objects by Wollheim.

Enabling annotation in e-book readers with a virtual keyboard are one thing: being able to assign a text to students with selectable levels of annotation is another. For some ebook readers, text highlighting may suffice.

Moodle has realized the importance of notes/journaling and replaced its limited journal module with its blog module.