Task cont-5: create a table-of-contents in assembly tool, configure it, see it

The goal of this task is to create a table-of-contents, configure it in one’s own collection, and see it.

Prerequisite

Applications That Should be Running

jEditOQMath, ActiveMath, web-browser, assembly tool (started here)

Task description

  • go to ActiveMath with the web-browser
  • login as a user (registering if need be)
  • invoke the menu Tools > Assembly Tool
    • this will download a JNLP file which will start the application Assembly Tool first requesting your trust
    • you are now in front of a blank table-of-contents, free for you to edit
  • invoke _Edit > Add section _
  • now use your browser to go with ActiveMath to see some content from books
  • having found an item drag-and-drop the link of their title from the browser till the assembly tool within the section
    • repeat this for a few items
    • make sure that the items appear below the section you just created (you can double click them to view them)
  • the book can be seen within your books:
    • invoke File > upload book
    • go to the ActiveMath main menu
    • click the book with the title [Title]
  • the book can also be saved into your collection:
    • in the assembly tool, invoke _File > Save _
    • navigate to the directory oqmath you created in the new collection
    • name the file assembled-book.oqmath
      • saving them in oqmath directory and naming it with the suffix .oqmath ensures that this file is part of the sources
    • go to jEditOQMath, open the file assembled-book.oqmath
      • you obtain, after some time, a validation error indicating it cannot find the declaration of the element omd:omdoc, for a good reason, this file is without document-type hence cannot be validated
      • you can keep working with this file or, to make it more readable, invoke, OQMath > Clean up OMDoc
      • depending on the elements you dragged (any URLs can be dragged inside the assembly tool), you might obtain a few validation errors, removing the guilty elements is a way to live in peace, alternatively you ignore these errors (but… not the others!)
      • spot the first omgroup element, it will have an id attribute that is dynamically generated, adapt its value for you to remember it, e.g., assembled-book.
      • now open the collection’s content-descriptor (e.g. ContentDescr_my-collections.properties) which is in the directory containing the oqmath directory
      • find a few lines which start with RecBooks is, below them insert the following line: RecBooks.my-assembled-grouping.ID = mbase://<my-collection>/assembled-book having replaced <my-collection> with the identifier of your collection. If you are not sure it may be worth to use the searchable-item-list to check it before.
      • open the AntFarm tab on the left, select the build-file of your collection and press the running man
    • shut-down ActiveMath
    • recopy the content-descriptor into the conf directory inside ActiveMath (unless it was linked)
    • start ActiveMath
    • you should see your new recorded-book as any user (even anonymous)
    • note: the assembly tool can further edit the file assembled-book.oqmath (make it accept all files) but it will revert to namespace-full, using clean-up-omdoc again might be worth it.