Task inst-1: AM-local-installation: can see server running with example content

This task represents the first step into starting local usage of ActiveMath.

• for now, uou need to follow installation instructions using ActiveMath-SVN
• please make sure you are loading the ActiveMath Content examples
  • (part of HowToInstall)
  • if not: see page 2 of install book: copy-me
    • Unix command-line: link the content descriptor into conf
      • cd ~/activemath
      • cd conf
      • ln -s ../omdoc1/examplesSrc/ContentDescr\_Examples.properties
    • Windows and other GUIs: copy the content descriptor into conf
      • open the directory activemath then omdoc1 then exampleSrc
      • copy ContentDescr_Examples.properties to conf inside activemath
    • normally, you need to restart ActiveMath then since the configuration has changed

Task inst-2: first web-experience: can download picture and a language variant

This task is the first web-experience with ActiveMath local installation.

Prerequisites:

• install local ActiveMath
• have the browser and ActiveMath running

Tasks

• find two different jpeg pictures
  • FIXME: provide two to download in case
• copy them inside webapps/ActiveMath
• rename them picture.jpg and picture_de.jpg
• using your web-browser, go to picture.jpg
• then go to picture.jpg?lang=de (you should see the second picture)
• then go to picture.jpg?lang=fr (you should see the first picture)
• then change your browser’s preferred language to be german (you should see the second picture with picture.jpg
• you can then delete the two pictures

Task inst-3: checkout a collection and activate it

This task explains how to check-out a collection, LeAM_calculus, from a subversion repository and how to update it.

Prerequisite:

• AM-local-installation
• applications-on: ActiveMath, file-browser, web-browser
• other requirements: good bandwidth, good machine (unless using a smaller content collection than LeAM_calculus).

Task steps

• checking out the collection, we have several cases
  • it might be available as a single zipped archive in which case:
    • please download the zip archive
    • unpack it, it should contain a single directory, named after the collection
    • move that single directory into the content directory inside the activemath directory
  • it might be available under a subversion repository, as is the case of for LeAM_calculus collection, you need to check it out.
    • you should then have a collection URL, which is, in the case of LeAM_calculus, http://svn.activemath.org/LeAM-calculus/LeAM_calculus/
    • using the Unix command-line subversion client, you do so by cd-ing into the activemath directory and invoking cd content followed by svn co <theURL>, this may take some time
    • using tortoise SVN you navigate inside the file browser until the content directory inside the activemath directory then create a directory of the collections’ name (e.g. LeAM_calculus) then navigate to this new folder and right-click and invoke Tortoise SVN > Check-out, enter the appropriate URL, and check-out
  • it might be available from a LibreSource synchronizer project, as is the case of for the Komma collection, you need to check it out.
    • first create in the content directory an empty directory with the exact name of this collection (komma for the case above)
    • then go to the LibreSource synchronizer page and invoke the link create workspace
    • as base path, enter the path to the empty directory you just created
    • then, again from the synchronizer page, reload and invoke the UPDATE link
    • you should then have your directory ready
• once the collection is checked-out it needs to be activated
  • please shutdown ActiveMath
  • if on a Unix system, cd to the activemath directory, invoke cd conf then, supposing this is LeAM_calculus, invoke ln -s ../content/LeAM_calculus/ContentDescr_LeAM_calculus.properties
  • if on another machine, or not wishing to use the command-line, copy the content-descriptor, i.e. the file stored in the root of the collection with a name starting with ContentDescr, into the directory conf inside the activemath directory
• you may now start ActiveMath again. The index will be built with all the new content, this may take time, please let it happen until server’s console is not moving anymore
• go to your browser, books of this content-collection should now be displayed in the main menu of ActiveMath

• alternatively, you can search for it or browse collections

• updating the collection only works if checked-out from a versioning server, we explain how to do so for a collection checked-out with subversion (or a zip file prepared for such)

  • if using the Unix command-line, simply cd to the directory of the collection (the directory inside the content folder bearing the name of the collection), then invoke svn update
  • if using TortoiseSVN, simply navigate with the file explorer until the directory of the collection, then right-click and invoke SVN update

Comments welcome!

Task inst-4: start jEditOQMath

This task is the first launch of the jEditOQMath authoring tool, using Java Web Start.

Prerequisites

• local ActiveMath installation
• working java installation
• applications on: the web browser

Task steps

• find the jEditOQMath web-page with google, you should find the jEditOQMath home
• from there, find the link to the developer snapshot java-web-start
• click it… let it download
• answer yes to trust this certficate
• answer yes to let it install
• answer yes to the proposals of menus and file associations (jdk >1.5)
• see splash screen
• answer “ok” about the warning of the AntFarm plugin missing javac (FIXME this is a plague!!)
• set the path to ActiveMath inside Plugins > Plugin-options then click “OQMath Jedit”, choosing the directory of ActiveMath, that is, the one that contains conf, lib, and thirdParty
• now go to your desktop’s file browser (Finder on MacOSX, Windows Explorer on Windows, others on others…) and find your ActiveMath directory, inside there the omdoc1 directory, then the cd directory, you should find a file arith1.omdoc
• double click arith1.omdoc, it should open in jEditOQMath, showing you an XML source of this file

Task inst-5: create-a-collection

This task describes the introduction of a first collection. This task needs fleshing.

Prerequisites

• local ActiveMath installation
• jEditOQMath start including setting the ActiveMath-home in jEditOQMath
• applications on: browser, jEditOQMath, ActiveMath

Task steps

• invoke OQMath > Start a collection
• give it a good name, it will be used often
• let it run for a bit
• restart ActiveMath
• you should see Complete Recbook with the content of the collection you just started
• click the link, you should see the book’s first page