Posts Tagged ‘ticTOCs’

Java, John and JournalTOCs

Posted on April 17th, 2012 by Paul Stainthorp

I heard recently that the ticTOCs journal tables-of-contents service will close down in the next month or so. ticTOCs was a JISC-funded project which hasn’t been developed for several years now.

Screenshot of ticTOCs

It’s effectively been superseded by the JournalTOCs service, “the largest, free collection of scholarly Tables of Contents (TOCs)”. The outgoing service has published some advice for users on transferring saved lists of TOCs between ticTOCs and JournalTOCs.

ticTOCs did have one particularly useful feature: a text file of all the TOCs it contained (at http://www.tictocs.ac.uk/text.php), which I’ve been filtering and using since 2009 to create a custom package of RSS feeds for upload to the e-journals A-to-Z at Lincoln.

While JournalTOCs doesn’t provide the same simple text list feature, it does have a fully-documented API. This is much more powerful and flexible for developers, but it’s not quite so straightforward as /text.php to create my list (a subset of all the feeds in JournalTOCs, matching only those journals to which the University has full-text access) using desktop tools and no programming.

A chance comment from a colleague at another university about Lincoln having “developers coming out of its ears“(!) inspired me to ask on the LNCD development group for help.

Dr John Murray of the Lincoln School of Computer Science responded, and very kindly supplied a Java program which I can use to identify which journals in our A-to-Z are represented in JournalTOCs, and so build a list of links to valid RSS feeds. Starting with a comma-separated list of ISSNs (which I downloaded from the A-to-Z), the program takes each ISSN in turn and makes a call to the JournalTOCs journals API. Depending on the data returned by JournalTOCs, the program records each ISSN as ‘VALID’ or ‘INVALID’ (i.e. no RSS feed available) in a new .csv file.

Thank you very much, John!

[Aside: to use John's code I had to learn how to compile and run Java programs on my laptop (running Ubuntu 11.10). For the record—and because I imagine it'll be useful again in the future—I first had to install OpenJDK 6 by going to the terminal and running the command:

sudo apt-get install openjdk-6-jdk

…then, once OpenJDK had installed, using the following command to select the correct version of Java:

sudo update-alternatives --config java

…before compiling and running the program itself.]

Once all the ISSNs had been checked against the API and the validated list constructed (this took ~5hrs to run!), I used Microsoft Excel to filter out only the ‘VALID’ ISSNs matched in JournalTOCs, and used Excel’s =LOOKUP() function to pull in enough information about each journal from our managed title list (previously downloaded), to create a custom upload text file.

Screenshot of the A-to-Z

The updated package of journal article RSS feeds is now available to view on the A-to-Z. We’ll review and re-generate this every few months, as we do with all custom and publisher-generated e-journal packages. At the time of writing, it contains just over 10,000 journal article RSS feeds, each one corresponding to one of our full-text journals. I’ve also added an orange RSS icon and link to JournalTOCs for each one, using the A-to-Z’s public notes feature.

So: which other library APIs will accept an ISSN as an input, and what other custom packages could I create using John Murray’s code in the same way?

Fun things to do with JournalTOCs

Posted on June 9th, 2011 by Paul Stainthorp

I’ve been meaning to write this up for a while. I think JournalTOCs is excellent, and it’s nice to see they’ve used their recent redesign/relaunch to make the site much more usable. JournalTOCs is one of those things—LibraryThing‘s another—where I don’t understand why more library people (especially subject/research support librarian types) aren’t raving about it.

Put simply: JournalTOCs is a tool to search for (and within) the Tables of Contents for electronic journals which are available as RSS feeds. You can find it at: www.journaltocs.ac.uk

Screenshot of JournalTOCs

“JournalTOCs is the largest, free collection of scholarly journal Tables of Contents (TOCs): 16,424 journals (including 2,149 Open Access journals) from 840 publishers.”

(An aside: what did happen to the suspiciously-similar ticTOCs? Were the two projects/services related? Is JournalTOCs just the ‘production’ version of the ticTOCs experiment? Or were they in competition somehow? I can’t seem to tell.)

Here are some of the fun things you can do with JournalTOCs:

  1. Search for articles within journal by keyword – as well as for the journal itself by name or ISSN;
  2. Browse for journals by subject or publisher;
  3. Export individual article references to RefWorks;
  4. Register for a JournalTOCs account, sign in, then select journals to ‘follow’ by ticking a box next to each one. You can then export your followed list of journals as an OPML file—effectively, a bundle of RSS feeds—and import the bundle into a feed reader of your choice. (OPML is itself quite cool.)

For instance – here’s an OPML bundle of food science journals to which the Holbeach Campus Library has a subscription. I created it by searching for and following those journals in JournalTOCs, then going to my full list of followed journals (at: http://www.journaltocs.ac.uk/followedJournals.php) and clicking the ‘Save & Export‘ link at the bottom of the screen. This creates an OPML file of your followed journals, which you need to save to your computer.

Screenshot of JournalTOCs

I can then go to my Google Reader account and upload the OPML file (you’ll find the option to do that under the Settings > Reader settings menu). JournalTOCs have a little help guide of the process you’ll need to follow in Google Reader. Other feed readers (srsly? There are other feed readers?) will do something similar.

Screenshot from Google Reader

Once you’ve uploaded your OPML bundle to G. Reader, you’ll probably want to add all the TOC feeds to the same folder (I created one called ‘foodjournals’). It would be really nice if Google Reader allowed you to specify a destination folder on import (similar to what RefWorks does): instead you have to do this manually – unless I’m missing something?

Screenshot of Google Reader

  1. JournalTOCs has a set of monster APIs, well-documented, with calls for both journals and articles. We’re hoping to make some productive and constructive use of those APIs as part of the Jerome project (that’s another blog post I need to write), but frankly this sort of thing is a Mashed Librarian’s dream. I’m already [mashup alert! mashup alert!] started using the APIs (amongst others) to populate a Google Spreadsheet with information about food science journals by ISSN. Then we use the spreadsheet to mailmerge to a PowerPoint show which forms our rolling digital photo frame mini-display at Holbeach. (This is probably another blog post I ought to write up.)
    photo_ejournals_frame [old photo]
  2. There’s a user API as well, which you can use to retrieve a list of the journals followed by a registered user of JournalTOCs (identified by email address). So, if I wanted to share my list of favourited journals, instead of publishing an OPML file I could just provide a link to: http://www.journaltocs.ac.uk/api/user/paul@paulstainthorp.com – this is more dynamic than OPML, in that if I start following a new journal, it’ll automatically be picked up by the API, without my having to export a new OPML file each time;
  3. JournalTOCs also provide advice for administrators of e-journals published using OJS (Open Journals Systems) software. This is something we could do with our own University of Lincoln-published e-journals (Neo and the Occasional Working Papers series) which are hosted on ojs.lincoln.ac.uk

For more of this sort of thing, see the official JournalTOCs blog, their news updates page, and Roddy MacLeod’s blog.

For the sake of completeness, I should also mention the Zetoc RSS feeds service. It’s not quite the same as JournalTOCs, in that these are feeds mediated by the British Library’s TOC service rather than the ‘native’, publishers’ own feeds, but it’s useful for different reasons – and it does cover some of the gaps in JournalTOCs. It’s all RSS, so you can mix and match in your feed reader.