A brief note on the development of Topics in Molecular Quantum Mechanics.

See also the revision notes.


This brief technical note is intended to provide information on the software tools used to create the tutorial Topics in Molecular Quantum Mechanics.

As mentioned elsewhere, the equations in Topics in Molecular Quantum Mechanics are encoded in MathML, which can be viewed with a MathML enabled Web browser, such as Mozilla. Those using Internet Explorer can choose a plug-in from a list. One version of this document has been formatted for IE 5.5 with MathPlayer 1.0, but those using IE 6.0 should consider upgrading to MathPlayer 2.0, which can now use the same formatting of the MathML Web pages as the Mozilla browsers. Those using Mozilla Firefox 1.0 may need to download fonts from http://www.mozilla.org/projects/mathml/fonts. The character encoding of the Web pages with MathML content is Unicode (UTF-8). If the Web pages don't appear to render correctly after you install the correct browser or plug-in, go to your browser's menu bar and select "View", "Encoding", "Unicode (UTF-8)".

[Caution]Viewing the tutorial from your local hard drive.

If you download the tutorial to your hard drive, be sure that that the Cascading Style Sheet freedom.css is available in the same directory as the HTML or XTML files. You should also have directories called images and MQM_graphics, which, at the moment, just contains nine graphics files all together. If you use Internet Explorer there may also be problems using the XTML version of the tutorial from your local hard drive. If this is the case, then try using the HTML version, or download a Mozilla browser.

Topics in Molecular Quantum Mechanics is being written using the DocBook document type definition (DTD), and processed using the command line Extensible Stylesheet Language Transformation (XSLT) processor xsltproc. An excellent place to begin learning how to use DocBook is DocBook: The Definitive Guide, by Norman Walsh and Leonard Muellner, with contributions from Bob Stayton. It can be read online at http://www.docbook.org/tdg/en/html/docbook.html. Those using DocBook will also need to know how to process the documents using an Extensible Stylesheet Language Transformation (XSLT) processor, such as xsltproc. There are a couple excellent tutorials available via the Internet on how to process DocBook documents. One is Bob Stayton's DocBook XSL: The Complete Guide, which is also available via the Internet at http://www.sagehill.net/docbookxsl/index.html. Ashley J.S Mills also has a nice tutorial at http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tutorials/docbooksys/docbooksyshome.html.

For now, we will only mention that the command line parameters in Example 1 were executed with xsltproc within a Python script.

The formatting of the equation numbers was accomplished with a customization layer in the file freedom.xsl, and the alignment of the equation numbers is done with the Cascading Style Sheet (CSS) freedom.css. The contents of freedom.xsl are shown in Example 2.