Sweet victory

Update: These instructions refer to the pre-2.3 version, and many steps do not apply to the current version.

Scriblio is truly in beta form. We released it before it was all polished and buffed in order to get some feedback and start building some community around it. That, of course, comes with some frustrations. Despite my own involvement with the project, when you first saw it, I first saw it too. And, like many of you, my download/installation/configuration had a few false starts. But, as of Friday I am proud to report that I’ve successfully conquered the beast. Here’s my experience:

First, my goods: I’m running Apache 1.3.33, PHP version 5.2.0, and MySQL 5.0.24.

Here’s an annotated process:

  1. Be sure your Apache installation has mod_rewrite enabled.
  2. Download and install Wordpress 2.2.2. Note that 2.2.2 is NOT the current release. The current version, 2.3, is brand new and includes a bunch of changes that need to be accommodated in Scriblio - more on that later.
  3. Take time to get familiar with the dashboard components and set your permalinks. Do this through Options -> Permalinks; personally, I like Numeric. When you save, pay attention to the prompt regarding the .htaccess file - if it says that you must update it yourself, do so! (this may mean you have to create it.) If it says it’s been updated, you’re good.
  4. Download bsuite_core and place it in your wp-content/plugins/ folder. Then enable it in your blog’s dashboard/Plugins/.
  5. Repeat that process with bsuite_btags.
  6. Repeat again with the Scriblio plugin. I recommend getting the files from the svn depository, either by installing Subversion or by copying all the files in the trunk into a scriblio folder in your plugins folder. If you go this route, be sure to get them all including the import directory and all its contents.
  7. Create a Page that will provide the foundation for your catalog data. I went with ‘catalog’.
  8. Go to Options -> Scriblio and select that page as the browse base.
  9. I passed on the Scriblio theme and stuck with Default, but be sure to enable the Scriblio widget. That’s in Presentation -> Widgets. I dragged the Search widget into ‘Sidebar 1′, followed by the Scriblio widget.
  10. Download the starter content to your local desktop.
  11. Verify that your wp-content folder is writable by the server and import demo_content.xml via Manage -> Import -> Wordpress. When prompted choose ‘Submit’ and 61 records should be imported.
  12. Check out the front page and you should see a default Welcome post and a Harry Potter Series post that comes with the starter content. Try a search on ‘potter’. The default is to search both blog and catalog content, so all should show. Then limit to catalog items, then limit to blog & pages. (There’s only one result, so it automatically shows that post. If things don’t look right, go to Options -> bsuite and Re-initialize tables and Rebuild bsuite metadata index in that order.
  13. That should do it. If you’re feeling brave, try and import some MARC records. They must have a .mrc extension and be placed in the wp-content/plugins/scriblio/import/data. Mine is 030807.mrc. Then go to Options -> Scriblio -> MARC File Importer. The file name is data/030807.mrc; the second field is any two letter for identification; the last is the map to the unique id. Import and wait for it to finish, and then ‘Import harvested data’ to make the new records show in the system.

5 Responses to “Sweet victory”

  • 1
    Casey Says:

    I just updated the tar.gz download file _and_ posted a quick guide on getting started with Subversion _and_ made it easier to find the last updated status of the repository.

  • 2
    Michelle Says:

    Our library is considering various faceted browsing solutions, and I’m looking at Scriblio. One question that I can’t seem to find an answer to: which part of Scriblio (looking at the download steps - Scriblio or bSuite) creates the facets, and is it possible for a library to customize that code to create different types of facets?


  • 3
    Casey Says:


    So far, the facets come from the catalog data, the fields in the marc record (though it’s not limited to marc). Most sites so far are displaying the subject headings as facets that you can use to browse or narrow your search by.

    But you can also manipulate the data to do more. The importers now treat all 600-series fields alike, but you could tweak the importer to group geographic subjects in a different facet (actually, that’s something I’m working on).

    You can also tweak the data using SQL statements. Scriblio not only makes it easier for the user to find what she wants, it makes it far easier for the librarian to experiment with both the data and the display to get the results our users need.

  • 4
    Michelle Says:

    Thanks for the information, Casey.

  • 5
    élet és könyvtár » Blog Archive » Scriblio Says:

    [...] Igazából a használatához nem kell expertnek lenni, így érdemes kóstolgatni, egyszerűen telepíthető. Élesben a Plymouth State University Lamson Könyvtárában tekinthető meg. (Illetve a Cook [...]

Leave a Reply

Comments should show a courteous regard for the presence of other voices in the discussion. We reserve the right to edit or delete comments that do not adhere to this standard.

XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>