Project Home

Nabu: Test Drive

Abstract

Instructions for trying out the Nabu installed on furius.ca.

Want to try out Nabu? We installed a Nabu server on this machine. You can create a test account and upload some content to give it a try.

  1. Download the Nabu publisher client. Save it from this link.

    • Make sure that you have a Python interpreter installed and that the version is 2.3 or greater;
    • Put the publisher in your path under the name nabu.
  2. Create a new user that will allow you to push content to our Nabu server:

  3. Use the created user/password to configure your client, for the publisher at URL: http://furius.ca/nabu/cgi-bin/nabu-publish-handler.cgi

    • you can create a file in your home directory, with these contents:

      user = '<username>'
      password = '<password>'
      server_url = 'http://furius.ca/nabu/cgi-bin/nabu-publish-handler.cgi'
      
  4. Create some documents.

    • create/edit a text file following the reStructuredText conventions anywhere on your local drive, with any text editor of your preference;
    • put the string :Id: <some-unique-id> anywhere in the first 1024 bytes of the file.
  5. Publish the content.

    • invoke the publisher on the created document, or in the directory that contains it:

      nabu <filename>
      

      or, if you have many documents in that directory:

      cd <dir>
      nabu
      
  6. View the contents of the database.

    • you will need your user and password to log in;

    • go to the contents/debug page

      This is not very fascinating, but you can see what gets uploaded. We will soon prepare some extractors to display the data in a more interesting way.

    • or go to the example presentation page, a simplistic blog-like view of the contents that I'm fiddling with.

For more information on client usage, see the Nabu usage document.

Notes: