Archive for category: Writing

Introducing citeproc-js

January 29th, 2010 by Frank Bennett

Citation copy-editing is one of those deceptively small burdens that have a way of taking over the working day. If left untended, the task of tidying up casually scribbled references can snowball to crisis proportions as a submission deadline approaches. Similarly, when a submission to one publisher is unsuccessful, significant effort may be required to recast its citations in the format required by another. Collaboration outside of one’s own field can bring with it an unwelcome tangle of fresh style-guide quandaries to ponder and fight through. These are things that the machines, if they want to make themselves useful, should be doing for us.

There is plenty of collective experience in this line, and as fate would have it, there are also plenty of collective solutions. In the TeX/LaTeX world, authors and their editors can today choose between BibTeX and BibLaTeX — both of them excellent utilities — with the several variants of the former supported by no fewer than four separate versions of the BibTeX program. [1] Users of WYSIWYG word processors can look to the bibliographic support built into Word or Open Office, or they can turn to an external solution such as EndNote ™, ProCite ™, Reference Manager ™, or more recently Zotero or Mendeley. Migrating data between these environments is a process fraught with uncertainty, but it is sometimes unavoidable when you need this kind of output, and it can only be produced on that kind of system …

(more…)

LaTeXSearch: 1M snippets in a searchable database

January 24th, 2010 by dario

Springer announced last week the launch of LaTeXSearch.com, a free online service allowing users to search a huge database of LaTeX snippets from Springer journals and publications. This follows the launch of a similar service, a few months ago exposing Springer’s database of scientific images (which suggests a precise strategy on how to build Web services on top of content in their publication database).

LaTeXSearch does what it promises, using similarity algorithms “to normalize and compare LaTeX strings so that, if similar equations are written slightly differently, the outputs are normalized and matched, granting you the broadest possible results set”. The only glitch is that snippets are not cached but generated on the fly, with the annoying result that it can take quite some time to display the rendered version of LaTeX formulas in search results.

Review of Google Wave as a scholarly HTML editor

November 17th, 2009 by jose

Google_Wave_logo

Peter Sefton wrote a series of posts on wave. He has published on Scholarly HTML so I read attentively what he has to say. What follows is some highlights of his posts, and my thinking about where things are going. There are at least four things that bother me about wave –as it is today:

1- It’s not really HTML

I thought that waves being XML documents would be a good thing because it’d separate content and formatting. But it seems that they made some strange decisions about how to represent formatting with “very tenuous relationship to HTML”. For example

While there is talk of ‘XML documents’ in the whitepapers etc, a wave document in the current implementation is apparently a series of lines of text. All formatting and what you might think of as structure, such as whether something is a heading or not, is considered an annotation.

(more…)

The Changing Dynamics of Scientific Collaborations

November 13th, 2009 by dario

Call for participation for a workshop at CSCW 2010
[submission deadline: November 20, 2009]

cscw 2010The confluence of two major trends in scientific research is leading to an upheaval in standard scientific practice and collaborative technologies. A new generation of scientists, working in large-scale collaborations, is repurposing social software for use in collaborative science. Existing social tools such as chat, IM, and FriendFind are being adopted and modified for use as group problem-solving facilities. At the same time, exponentially greater and more complex datasets are being generated at a rate that is challenging the limits of current hardware, software, and human cognitive capability. A concerted effort to create software that will support new scientific practices and handle this data tsunami is redefining the collaboratory and represents a new frontier for computer supported cooperative work.

This follow-on event to a similarly themed workshop at CHI 2009 is intended to foster community among researchers and practitioners from multiple disciplines interested in the changing dynamics of scientific collaborations.
(more…)

Blog-sized lit reviews

November 6th, 2009 by james

When I started my DPhil, I set myself assignments in order to cover the lit review in easy bite-sized chunks. This worked pretty well but the collated material was scattered across different Word documents, which meant that I couldn’t look at everything at one glance or search the content.

However at about the same time, I also started free-writing to generate ideas. If you’re not familiar with the technique, it’s simply writing for a fixed amount of time without stopping. You don’t delete anything on the fly and just go, writing down anything that comes to mind until the timer sounds or your wrists cramp up, whichever comes first.

Instead of putting this writing into Word documents though, I decided to set up a local installation of the blogging engine Movable Type. In retrospect, I think this was probably just an excuse to play with blogging software but it turned out to be a good decision. I could add content from any computer with access to the server, the basic input form meant that I focused on content not style, and of course, I had all the blogging bells-and-whistles attached. Comments could be added at a later date, the information sorted and searched, shared with my supervisor and so on.

I’m not sure why I didn’t think of it at the time but I would now recommend combining the two ideas: use a blog to write your lit review. (I say “write”, but I really mean “draft”. The structure of blog writing is quite different from academic writing and besides, you’ll want to tidy up references, tables, etc. for the final version. But a blog post is still big enough to cover the bulk of the material and help you organize your thoughts.)

The final stumbling block of course is how to get the content out of the blogging engine and into a presentable format. Fortunately, there’s a script called WPTEX that will convert your Wordpress blog into a LaTeX document. I found this software about six months ago and it does what it says on the tin: give it some basic details and it will parse all of your posts, tidying up the code and creating LaTeX source files which you can then compile as a standalone PDF book or for inclusion as part of your thesis.

The script’s not perfect and I can think of several improvements, particularly in the way that it converts URLs for paper presentation. But if you’re starting a PhD, I’d recommend giving it a go. A blog-sized lit review is a great way to manage this difficult task and of course, if you make the blog public, you can engage with the wider community in your field, getting feedback and maybe even making a bit of a name for yourself. Happy blogging!