[cellml-discussion] Proof of concept: using git for specification development

[Randall Britten]

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 at cellml.org [mailto:cellml-discussion-

> bounces at cellml.org] 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.

> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.cellml.org/pipermail/cellml-discussion/attachments/20071122/e8905a10/attachment-0001.htm