How to for Windows users: git and docbook.
There are other ways of doing this, but the following
worked.
Overview:
A)Initial setup
A1) Install Msys/Git
A2) Git checkout of CellML spec docbook source
A3) Installation of xsltproc
A4) Installation of docbook-xsl
B)Routine operations
Details:
A) Initial setup:
A1) MSys and Git:
A1.1) Note: the installer does not seem to work from behind
a firewall if the firewall blocks direct outward connections.
A1.2) Note: in the next step, you can choose the install
target directory. I’ll assume the default was used “C:\msysgit”
and refer to it later.
A1.3) Download and run http://msysgit.googlecode.com/files/GitMe-0.4.2.exe
A2) Checkout:
A2.1) Run msys (see step B1)
A2.2) Execute the git commands as per Andrew's e-mail,
repeated here:
git clone git://repo.or.cz/cellml-draft-miller.git
andrews-spec-version
cd andrews-spec-version
git checkout -b normative remotes/origin/normative
A3) xsltproc:
A3.1) Follow the instructions at http://www.sagehill.net/docbookxsl/InstallingAProcessor.html#InstallXsltproc,
just the short section under "Installing xsltproc on Windows"
A4) docbook-xsl
A4.1) Note: The path in the next step assumes the default
was chosen for step A1.2, so adjust this as necessary.
A4.2) Make the following subdirectories under the
Msys/share directory for the xsl files: C:\msysgit\share\xml\docbook\stylesheet\nwalsh
A4.3) Download latest version (currently docbook-xsl-1.73.2.zip)
from http://sourceforge.net/projects/docbook/
A4.4) Unzip the contents into the directory referred to
in A4.2
B) Routine use
B1) Run "msys.bat" (it is located in the
directory chosen in step A1 above. It opens a terminal window, and one
can operate the command line tools in a similar fashion to a Linux/Unix like OS.
B2) cd to “andrews-spec-version”
B3) Get the latest updates if you want: “git pull”
(Note: I’m still new to git, so there may be variations here.)
B4) Run “./genspec.sh”
B5) This should have generated “toplevel.xhtml”
B6) Browse the generated spec: “explorer toplevel.xhtml”
(Note that somehow Firefox will launch here if it is your default browser J)
This should allow you to at least keep up with any
changes in the original repository.
Regards,
Randall
> -----Original Message-----
> From: cellml-discussion-bounces-+N4dcC6UsuQdnm+yROfE0A@xxxxxxxxxxxxxxxx
[mailto:cellml-discussion-
> bounces-+N4dcC6UsuQdnm+yROfE0A@xxxxxxxxxxxxxxxx] On Behalf Of Andrew Miller
> Sent: Monday, 12 November 2007 10:22 a.m.
>
> There is an MingW / MSYS based git port as well -
> http://msysgit.googlecode.com/files/GitMe-0.4.2.exe
- I haven't tried
> it
> myself.
>
