WWO Publishing

From Digital Scholarship Group
Revision as of 10:15, 5 December 2018 by Sbauman (talk | contribs) (first crack at publication page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

WWO Publishing

Testing

Before publishing it is easiest to move all files you want to publish into one directory (typically distribution/, but more honest to leave the newest ones in on_deck until you have actually published. The process is the same either way, it just means you have to perform some of the steps twice.

And remember to remove any files you don’t want published from the directories you are playing with. (Only files of the glob format “*.*.xml” will be processed.)

  1. $ cd /path/to/source/dir/probably/distribution/
  2. $ make wf     # Test well-formedness; all must pass except that in some cases duplicate IDs might be tolerable. Still, a very bad idea. Fix it.
  3. Issue either make validate OR make both — they do the same thing, just in different order. ("validate" tests each file against RELAX NG, then tests each file against Schematron; "both" tests each file first against RELAX NG and then against Schematron.)
  4. $ make WWO     # N.B. that you will likely have to specify some paths to needed directories on the commandline; issue just make for further info. The output goes to /var/lib/tomcat8/webapps/WWO/data/wwp/ by default, but this is easily changed by setting XTF= on the commandline; e.g. make XTF=/var/lib/tomcat6/webapps/WWOtesting WWO. Note that if you are in a directory named distribution/, this command will also go build emerson.almanack.xml.
  5. Take the output of make WWO and put it in the data/wwp/ directory of the XTF installation where you want to build the index. (Depending on what machine you are on and what directories you specified, above, this may already be done.) Replace old data. Note that our entire XTF directory is under Subversion control, so an easy way to do this is to check the newly created files in wherever you created them and check them out where you want to index them.
  6. $ cd /var/lib/tomcat6/webapps/WWO/        # on indexing machine
  7. $ tar xzf index index_PREV_DATE.tgz # create a backup, as not under Subversion control
  8. $ cd /var/lib/tomcat6/webapps/WWO/bin/    # could have been just cd bin/
  9. $ ./textIndexer -clean -index default     # I actually preface with `time`
  10. $ sudo chgrp -R tomcat ../index/  &&  sudo chmod -R g+w ../index/