<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 12 (filtered medium)">
<style>
<!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
@font-face
{font-family:"\@SimSun";
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p.MsoPlainText, li.MsoPlainText, div.MsoPlainText
{mso-style-priority:99;
mso-style-link:"Plain Text Char";
margin:0cm;
margin-bottom:.0001pt;
font-size:10.5pt;
font-family:Consolas;}
span.PlainTextChar
{mso-style-name:"Plain Text Char";
mso-style-priority:99;
mso-style-link:"Plain Text";
font-family:Consolas;}
.MsoChpDefault
{mso-style-type:export-only;}
@page Section1
{size:612.0pt 792.0pt;
margin:72.0pt 92.4pt 72.0pt 92.4pt;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:731197386;
mso-list-type:hybrid;
mso-list-template-ids:-572495474 1556663758 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l0:level1
{mso-level-number-format:alpha-upper;
mso-level-text:"%1\)";
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
ol
{margin-bottom:0cm;}
ul
{margin-bottom:0cm;}
-->
</style>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple>
<div class=Section1>
<p class=MsoPlainText>How to for Windows users: git and docbook. <o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>There are other ways of doing this, but the following
worked.<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>Overview:<o:p></o:p></p>
<p class=MsoPlainText>A)Initial setup<o:p></o:p></p>
<p class=MsoPlainText>A1) Install Msys/Git<o:p></o:p></p>
<p class=MsoPlainText>A2) Git checkout of CellML spec docbook source<o:p></o:p></p>
<p class=MsoPlainText>A3) Installation of xsltproc<o:p></o:p></p>
<p class=MsoPlainText>A4) Installation of docbook-xsl<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>B)Routine operations<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>Details:<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>A) <b>Initial setup</b>:<o:p></o:p></p>
<p class=MsoPlainText>A1) <b>MSys and Git</b>:<o:p></o:p></p>
<p class=MsoPlainText>A1.1) Note: the installer does not seem to work from behind
a firewall if the firewall blocks direct outward connections.<o:p></o:p></p>
<p class=MsoPlainText>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.<o:p></o:p></p>
<p class=MsoPlainText>A1.3) Download and run <a
href="http://msysgit.googlecode.com/files/GitMe-0.4.2.exe">http://msysgit.googlecode.com/files/GitMe-0.4.2.exe</a><o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>A2) <b>Checkout</b>:<o:p></o:p></p>
<p class=MsoPlainText>A2.1) Run msys (see step B1)<o:p></o:p></p>
<p class=MsoPlainText>A2.2) Execute the git commands as per Andrew's e-mail,
repeated here:<o:p></o:p></p>
<p class=MsoPlainText>git clone git://repo.or.cz/cellml-draft-miller.git
andrews-spec-version<o:p></o:p></p>
<p class=MsoPlainText>cd andrews-spec-version<o:p></o:p></p>
<p class=MsoPlainText>git checkout -b normative remotes/origin/normative<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>A3) <b>xsltproc</b>: <o:p></o:p></p>
<p class=MsoPlainText>A3.1) Follow the instructions at <a
href="http://www.sagehill.net/docbookxsl/InstallingAProcessor.html#InstallXsltproc">http://www.sagehill.net/docbookxsl/InstallingAProcessor.html#InstallXsltproc</a>,
just the short section under "Installing xsltproc on Windows"<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>A4) <b>docbook-xsl<o:p></o:p></b></p>
<p class=MsoPlainText>A4.1) Note: The path in the next step assumes the default
was chosen for step A1.2, so adjust this as necessary.<o:p></o:p></p>
<p class=MsoPlainText>A4.2) Make the following subdirectories under the
Msys/share directory for the xsl files: C:\msysgit\share\xml\docbook\stylesheet\nwalsh<o:p></o:p></p>
<p class=MsoPlainText>A4.3) Download latest version (currently docbook-xsl-1.73.2.zip)
from <a href="http://sourceforge.net/projects/docbook/">http://sourceforge.net/projects/docbook/</a><o:p></o:p></p>
<p class=MsoPlainText>A4.4) Unzip the contents into the directory referred to
in A4.2<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><b><o:p> </o:p></b></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>B) <b>Routine use</b><o:p></o:p></p>
<p class=MsoPlainText>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.<o:p></o:p></p>
<p class=MsoPlainText>B2) cd to “andrews-spec-version”<o:p></o:p></p>
<p class=MsoPlainText>B3) Get the latest updates if you want: “git pull”
(Note: I’m still new to git, so there may be variations here.)<o:p></o:p></p>
<p class=MsoPlainText>B4) Run “./genspec.sh”<o:p></o:p></p>
<p class=MsoPlainText>B5) This should have generated “toplevel.xhtml”<o:p></o:p></p>
<p class=MsoPlainText>B6) Browse the generated spec: “explorer toplevel.xhtml”
(Note that somehow Firefox will launch here if it is your default browser <span
style='font-family:Wingdings'>J</span>)<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>This should allow you to at least keep up with any
changes in the original repository.<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>Regards,<o:p></o:p></p>
<p class=MsoPlainText>Randall<o:p></o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText><o:p> </o:p></p>
<p class=MsoPlainText>> -----Original Message-----<o:p></o:p></p>
<p class=MsoPlainText>> From: cellml-discussion-bounces@cellml.org
[mailto:cellml-discussion-<o:p></o:p></p>
<p class=MsoPlainText>> bounces@cellml.org] On Behalf Of Andrew Miller<o:p></o:p></p>
<p class=MsoPlainText>> Sent: Monday, 12 November 2007 10:22 a.m.<o:p></o:p></p>
<p class=MsoPlainText>> <o:p></o:p></p>
<p class=MsoPlainText>> There is an MingW / MSYS based git port as well -<o:p></o:p></p>
<p class=MsoPlainText>> http://msysgit.googlecode.com/files/GitMe-0.4.2.exe
- I haven't tried<o:p></o:p></p>
<p class=MsoPlainText>> it <o:p></o:p></p>
<p class=MsoPlainText>> myself.<o:p></o:p></p>
<p class=MsoPlainText>> <o:p></o:p></p>
</div>
</body>
</html>