Written by commandline (aka Thomas Gideon) at the request (behest?) of Cory Doctorow, Flahsbake was meant to address the problem of retaining an archival record of the production of digital texts. Cory Doctorow explains:

I was prompted to do this after discussions with several digital archivists who complained that, prior to the computerized era, writers produced a series complete drafts on the way to publications, complete with erasures, annotations, and so on. These are archival gold, since they illuminate the creative process in a way that often reveals the hidden stories behind the books we care about. By contrast, many writers produce only a single (or a few) digital files that are modified right up to publication time, without any real systematic records of the interim states between the first bit of composition and the final draft.

The problem is genuine, I have written about it before. Moreover, I agree that version control has a role to play in its solution. However, I have doubts about the utility of Flashbake. It’s simplicity is its virtue, but it is too simple. No commit messages? A record of ambient information is no real substitute. And Flahsbake’s users are supposed to be geeky enough to use a command line tool, but not geeky enough to master the following simplified workflow?:

$ git init
$ git add mynovel.txt
$ git commit -m "initial commit"
write write write
$ git commit -a -m "new commit message"

I am not sure I get it. Still, any version control is better than none. And maybe Flahsbake will function as a Git gateway technology. If you are interested in a less puzzled reaction to Flashbake see the Lifehacker article. But if you want to be a really nerdy writer, just use Git neat.

Legislation that has not kept abreast of changing technology can make the choice difficult.

As a philosopher, I write research papers, drafts of which are distributed on the web as PDFs. Open access to evolving research is important, and I am committed to it. Since I want to give my work the best chance of being understood, I take the time to properly typeset the PDFs with XeLaTeX. There is a problem, however, with distributing PDFs over the web.

PDF files can contain font information in a way that is easily extractable from the file. While the licensing of some type foundries allow embedded fonts in PDFs, many (especially smaller type foundries) do not. Indeed the ones that did probably did so at Adobe’s urging when PDF distribution on the web was relatively small and so not that great of a risk.

I would like to support small type foundries by buying their fonts. There are some brilliant type designers out there, and they should be rewarded. Unfortunately, since the main thing I want these fonts for is for web distributed PDFs, I can’t do that without violating licensing restrictions. And that’s not support.

There are of course open source fonts. Some of them are fine pieces of work. But the choice is limited, and important design decisions should not be so constrained.

DRM is not the answer, as the recent history of music distribution online sadly reveals.

I don’t know how to resolve this problem. It is partly technological, partly, legal. But I thought I would highlight for other academics who distribute their work online.

Upon finishing this post, I came across this essay that has more information about the legal and technological obstacles with some discussion of potential solutions.

To install the GitHub bundle do the following:

$ sudo gem install git
$ cd ~/"Library/Application Support/TextMate/Bundles/"
$ git clone git://github.com/drnic/github-tmbundle.git "GitHub.tmbundle"
$ osascript -e 'tell app "TextMate" to reload bundles'

One of the great features of using TextMate to produce LaTeX documents is the TODO Bundle. The TODO Bundle let’s you to insert TODOs into comments and display these in a nicely formatted HTML window with links to the lines where the TODOs occurred.¹²

There are two limitations with the TODO Bundle, however, which made me look for an alternative (I still use the TODO Bundle, the alternative is merely a supplement):

1. While I try to proof my documents as much as I can onscreen, sometimes I need to proofread the hardcopy. Proofreading hardcopy is easier, and any incremental decrease in distraction is a real boon in proofreading since it requires a lot of attention.
2. Suppose you are collaborating on a LaTeX document and your collaborator isn’t using TextMate. Of course, they can still follow the TODOs in the comments, but it would be great if these could be made more salient.

The Solution

The solution to both of these problems is to use LaTeX to generate the TODO list for you. To do this, I used the index package. The index package reimplements the internal LaTeX index macros adding functionality. Of particular interest is its support for multiple indexes. Add the following to your preamble:

The first line loads the color package (since our TODOs will be colored to make them stand out from the surrounding text). The second line loads the index package. The next two lines:

\newindex{todo}{tod}{tnd}{TODO List} % start todo list
\newindex{fixme}{fix}{fnd}{FIXME List} % start fixme list

define two indexes. The \newindex command takes four arguments. These arguments correspond to the four pieces of information required to generate the index:

1. A short, unique tag that identifies the index.
2. The extension of the output file where the raw index information will be put by LaTeX.
3. The extension of the input file where the processed information created by MakeIndex will be stored to be read in later by LaTeX.
4. The title of the index.

The next two lines:

\newcommand{\todo}[1]{\textcolor{blue}{TODO: #1}\index[todo]{#1}} % macro for todo entries
\newcommand{\fixme}[1]{\textcolor{red}{FIXME: #1}\index[fixme]{#1}} % macro for fixme entries

define two new commands: \todo and fixme. To add a TODO simply add the following at the appropriate place in the text:

\todo{My TODO entry}

Similarly, for FIXMEs.

New commands can be added on a similar pattern. So, for example, suppose you want to add a CHANGE command. To do this, be sure to also define a new index:

\newindex{change}{chg}{cnd}{CHANGE List} % start change list
\newcommand{\change}[1]{\textcolor{green}{CHANGE: #1}\index[change]{#1}} % macro for change entries

Notice, that the commands are color coded, so be sure to change the color. Since the previous two commands were blue and red, I made the CHANGE command green.

If you want to generate a list of the TODOs, FIXMEs, etc, at the end of your document you need to use the \printindex command. This takes as an option the name of the index, so for TODOs and FIXMEs we would use:

\printindex[todo]
\printindex[change]

Before we typeset these indexes, we need to run the makeindex command. Suppose that the name of your LaTeX document is foo.tex. Then, in the terminal we would run:

$ makeindex -o foo.tnd foo.tod
$ makeindex -o foo.fnd foo.fix

The -o option is used to specify the name of the file generated by makeindex that is used, in turn, by LaTeX to typeset the index. Having run makeindex, if we now typeset the document, the indexes will be printed at the end of the document after a pagebreak. And if you are using the hyperref package, these will have links to the pages where the TODOs and FIXMEs are inserted. This step can be automated with a makefile such as Latexmk.pl.

Been working on some scripts to clean up the BibTeX file, to normalize cite keys, to render consistent author and journal names, to strip out local URLs, etc. So look forward to a new development branch and a directory of utilities.

Microblogging can clearly work with fiction, but what about more substantive works, like philosophical treatises? In a moment of intoxication inspiration, I came up with a quick Python one-liner¹ to compute how many lines in an English translation of Ludwig Wittgenstein’s celebrated “Tractatus Logico-Philosophicus” are 140 characters in length or less. I discovered that a bit under half of the lines are short enough to be Twittered (and, as the philosopher would say, what we cannot Twitter, we must pass over in silence).

In my own case, twittering philosophy has so far wholly consisted in mocking philosophers, gossiping about them, and git commit messages, thanks to GitHub’s service hooks. Perhaps others can offer tweets with more substantive philosophical content. After all, aphorism is not unknown to philosophy—the pre-Socratics and Nietzsche come to mind. For now, teh interwebs await a latter day Heraclitus.

• More than # spelling mistakes: The number of mistakes is customizable, and the extension uses Firefox’s built-in spell checker.
• All capital letters
• No capital letters
• Doesn’t start with a capital letter
• Excessive punctuation (!!!! ????)
• Excessive capitalization
• Profanity

Find myself struggling like Kirk under an alien influence. Must. Not. Make. Offensive. Remark…

Update Language Log has since had a recent spate of posts about similar products. Geoffrey K. Pullum and Mark Liberman post about SpinSpotter here and here, and Arnold Zwicky takes on apostrophree here

It is hosted at GitHub, so git users can get theme with git clone git://github.com/PhilGeek/clear-pond.git. Other wise, it can be downloaded here.

• Analysis
• Aristotelian Society Supplementary Volume
• Australasian Journal of Philosophy
• The British Journal of Aesthetics Current Issue
• The British Journal of Aesthetics Advanced Access
• British Journal for the History of Philosophy
• The British Journal for the Philosophy of Science Current Issue
• The British Journal for the Philosophy of Science
• Canadian Journal of Philosophy
• Dialectica
• Erkenntnis
• Ethics
• European Journal of Philosophy
• Hypatia
• Journal of Philosophical Logic
• Journal of Semantics Current Issue
• Journal of Semantics Advanced Access
• Linguistics and Philosophy
• Midwest Studies in Philosophy
• Mind Current Issue
• Mind Advanced Access
• Mind and Language
• Noûs
• Pacific Philosophical Quarterly
• Philosophia Mathematica Current Issue
• Philosophia Mathematica
• Philosophical Books
• Philosophical Forum
• Philosophical Investigations
• The Philosophical Quarterly
• The Philosophical Review
• Philosophical Studies
• Philosopher’s Imprint
• Philosophy Compass
• Philosophy and Phenomenological Research
• Philosophy and Public Affairs
• Philosophy of Science
• Phronesis Current Issue
• Phronesis Recent Issues
• Proceedings of the Aristotelian Society
• Ratio
• Studia Logica
• Synthese
• Topoi

Update Blackwell Synergy’s integration into Wiley-Interscience, the first step of a launch of a new online platform, has resulted in some hiccups. Some but not all of the feeds for Blackwell Synergy remain operative with material in Wiley-Interscience. This does not bode well for their survival in the new online platform. Will post at a later date with updated feeds.

The second is from my paper “Respecting Value”:

Too fun =)

• New multi-tabbed interface similar to Safari. This makes switching between open files faster and more intuitive.
• Full screen editing now available. This allows you to focus just on editing your files without distraction from other applications.
• Aquamacs no longer creates backup files by default: less clutter in your files.
• Now uses standard “unified” toolbar, with improved icons, for greater ease-of-use.
• Improved LaTeX support.
• Numerous improvements in text search.
• Can check for program updates from the application menu.

The LaTeX improvements include the inclusion of AUCTeX 11.85, better error reporting and improved syntax highlighting, and improved icons. Aquamacs 1.4 can be downloaded here.

When can we expect TextMate 2 to be released? Here is what Alan Odgaard has to say in the TextMate 2 FAQ:

[…] there is no ETA, and I won’t speak about timing before I am certain I can provide an (alpha/beta) release within the next month – because really, the more I say, the more people ask, and having to answer the same questions over and over again is (for me) mentally exhausting. So put TM 2.0 up there with Duke Nukem Forever and be positively surprised the day it is released :)

The release of footage of Duke Nukem Forever has prompted the following query on irc:

ph^: allan: Now that Duke Nukem forever has released a new gameplay-video … :p

Well, no official word from Allan yet, but Peter Haza (aka ph^) shares some insights into the state of TextMate 2 development in this interesting post.

Consider direct quotation—no easy phenomena. Part of the point of citation, here, is so that the reader can read the quotation in context, to decide for themselves whether the quoted author has been misrepresented. The usual case is to quote from a dead tree source—a printed book or journal. Imagine if books were quite different than from the way they actually are. Suppose that every time a book is closed the text would change, sometimes subtlely, sometimes less so. When your intrepid reader tracks down your citation, the quote may or may not be there. What would be the point? There would be very little, if any, point at all. The requisite stability would be missing from texts that spontaneously morph.

One good thing about dead tree sources is that they don’t change in this way. But now consider delivering text online. It is easy to change HTML or upload a new version of a PDF. The nature of the medium does not guarantee the stability guaranteed by ink on a page. Instead of natural law, we have the moral law. We must rely—God help us—on trust. This is manifest in bloggers’ convention of striking through changed text in a post. Leaving a trace of a misspelled word, a hasty judgment, or mal mot is a sign of good faith, and bloggers who depart from this convention are subject to (verbal) sanction in comments or in pingback posts.

As the delivery of academic journals is moving increasingly online, editors face a corresponding moral challenge. The Aristotelian Society publishes papers online before the print volume hits the stands. Once an author asked to change his article after the online version went live but before the print volume was typeset. What was the problem? Things change online all the time!—he implored. The problem was simple. It would violate a precondition for the possibility of citation.

I am now in the process of transitioning my work over to Git. One salient difference is that, with Subversion, I kept all my mission-critical text files in a single structured directory; Git, however, wants to find relationships among everything in the repository, so it is important to keep unrelated projects in different repositories. (Fortunately setting up Git repositories is a snap.) This is important to bear in mind when migrating from Subversion. If, like me, you maintained a single Subversion repository with separate subdirectories for each of your projects, you need to migrate each of these into separate Git repositories.

Here is how I began my migration.

I decided to start with my remind files:

$ mkdir -p /tmp/remind
$ cd !$
$ git-svn clone http://markelikalderon.com/svn/TheHub/Remind --no-metadata

The command:

git-svn clone

calls init, which creates a new Git repository, and fetch, which fetches the contents and history of the directory. git-svn clone takes the options of both init and fetch. One useful option is –no-metadata which strips out the no longer needed Subversion metadata.

Now I needed to configure my new Git repository. I began by creating a file and opening it in my text editor, TextMate:

$ touch ~/users.txt && mate ~/users.txt

I then added the following to users.txt:

kalderon PhilGeek <eli@markelikalderon.com>

‘kalderon’ being my Subversion user name and ‘PhilGeek’ being my Git user name. There should be one line each with this syntax for each of the users. Now I was ready to configure git:

% git config svn.authorsfile ~/users.txt

The final step is to clone this new Git repository to rid ourselves of any remaining svn cruft. I created a new GitHub project and then within the Git repository:

$ git remote add origin git@github.com:PhilGeek/remind.git
$ git push origin master

Finally, I cloned the remote repository into the directory where my remind files were to live locally and deleted the /tmp/remind directory.

Not too bad. But you might consider automating the process with a shell or ruby script, if this needs doing several times over.

Tell app "Terminal" to make new tab in first window

But, weirdly, “make” fails with Terminal.app. So you need, instead:

Tell application "System Events" to tell process "Terminal" to keystroke "t" using command down

Inelegant. So, a rather hackish command, but if you are interested in opening the directory of the current TextMate document in Terminal.app, you can download it here.

It’s our preference to use a text editor, like HomeSite, TextPad or TextMate, to “hand code” everything, rather than to use a wysiwyg (what you see is what you get) HTML and CSS authoring program, like Dreamweaver. We just find it yields better and faster results.

Donald Knuth, creator of TeX, describes his workflow for writing in an interview:

My general working style is to write everything first with pencil and paper, sitting beside a big wastebasket. Then I use Emacs to enter the text into my machine, using the conventions of TeX. I use tex, dvips, and gv to see the results, which appear on my screen almost instantaneously these days. I check my math with Mathematica.

I program every algorithm that’s discussed (so that I can thoroughly understand it) using CWEB, which works splendidly with the GDB debugger. I make the illustrations with MetaPost (or, in rare cases, on a Mac with Adobe Photoshop or Illustrator). I have some homemade tools, like my own spell-checker for TeX and CWEB within Emacs. I designed my own bitmap font for use with Emacs, because I hate the way the ASCII apostrophe and the left open quote have morphed into independent symbols that no longer match each other visually. I have special Emacs modes to help me classify all the tens of thousands of papers and notes in my files, and special Emacs keyboard shortcuts that make bookwriting a little bit like playing an organ. I prefer rxvt to xterm for terminal input. Since last December, I’ve been using a file backup system called backupfs, which meets my need beautifully to archive the daily state of every file.

…

I currently use Ubuntu Linux, on a standalone laptop—it has no Internet connection. I occasionally carry flash memory drives between this machine and the Macs that I use for network surfing and graphics; but I trust my family jewels only to Linux. Incidentally, with Linux I much prefer the keyboard focus that I can get with classic FVWM to the GNOME and KDE environments that other people seem to like better. To each his own.