[$name|Install$]
[$title|Download / Install$]
[$frame|HTMLPage.tmpl$]
<p>
Assuming you [$pageLink|Requires| already have DMD installed $]:
</p>

<ol style="list-style-type: decimal;">
<li>
	<p style="font-weight: bold">Download Goldie and SemiTwist D Tools.</p>
	<p>
	There are two ways to download these:
	</p>
	<ul>
	<li>
	<em>Prepackaged Downloads at [$link| http://www.dsource.org/projects/goldie/browser/downloads | Goldie downloads page $]</em>
	<p>
	These prepackaged releases include Goldie, SemiTwist D Tools and prebuilt
	local Goldie documentation.
	They're available with prebuilt binaries for
	specific OSes. While prebuilt binaries are not currently available for
	all OSes, compiling from source is easy, and
	[$link|http://www.dsource.org/projects/goldie/newticket| submissions $]
	of prebuilt binaries are welcome.
	</p>
	<h4>Why 7z?</h4>
	<p>
	The prepackaged releases are in [$ident|.7z$] format because it provides much
	higher compression than [$ident|.zip$] or [$ident|.tar.bz2$]. For Goldie,
	a [$ident|.7z$] is less than half the size a [$ident|.zip$] or [$ident|.tar.bz2$] would be.
	Besides, these days, no programmer should be without a [$ident|.7z$] tool.
	</p>
	<p>
	If you're on Windows, you can use
	[$link| http://www.7-zip.org/ | 7-Zip $] or [$link| http://www.rarlab.com/ | WinRAR $].
	If you're on a Unix-like system, you can use [$link| http://p7zip.sourceforge.net/ | P7ZIP $].
	On Debian or Ubuntu, you can install P7ZIP with the command:
	</p>
	<div class="code-plain">&gt;[$code|user| sudo apt-get install p7zip-full $]</div>	
	<p>
	When P7ZIP is installed, it may already be integrated with your file
	manager's default compression tool.
	</p>
	</li>

	<li>
	<em>Subversion</em>
	<p>
	Goldie and SemiTwist D Tools can both be obtained via Subversion:
	</p>
<div class="code-plain">&gt;[$code|user| svn co -r 213 http://svn.dsource.org/projects/semitwist/trunk SemiTwistDTools $]
&gt;[$code|user| svn co http://svn.dsource.org/projects/goldie/tags/v0.4 Goldie $]
</div>
	<p>
	The Subversion releases include prebuilt binaries for Windows. Read below
	to see how to build the binaries yourself. Prebuilt local Goldie
	documentation is not included, but you can easily build it
	(after you finish installing Goldie) with the instructions on the
	[$pageTitle|GenDocs$] page.
	</p>
	</li>
	</ul>
</li>

<li>
	<p>
	<span style="font-weight: bold">Build SemiTwist D Tools.</span>
	<br />[:<span style="font-style: italic">
	[You can skip this step if you obtained a release with prebuilt binaries for your OS.]
	</span>:]
	</p>
	<p>
	From the main SemiTwist D Tools directory:
	</p>
	<div class="code-plain">&gt;[$code|user| buildAll $]</div>
	<p>
	On WinXP, environment variables can be accessed by: Right-Click on
	"My Computer", "Properties", "Advanced" tab, "Environment Variables" button.
	You'll need to start a new command prompt for it to take effect. You might
	also need to log out and back in again.
	</p>
</li>

<li>
	<p>
	<span style="font-weight: bold">
	Add the executable directories for Goldie and SemiTwist D Tools to your
	PATH environment variable.
	</span>
	<br />[:<span style="font-style: italic">
	[This is optional, but recommended.]
	</span>:]
	</p>
	<p>
	These directories are:
	</p>
[$code|plain| {main Goldie directory}/bin/ 
{main SemiTwistDTools directory}/bin/ $]
	<p>
	See step #2 above for how to access the environment variables on WinXP.
	</p>
	<p>
	Having these on your PATH shouldn't cause any name collisions because all
	the executables for Goldie and SemiTwist D Tools are prefixed with
	[$code|inline|[:goldie-:]$] and [$code|inline|[:semitwist-:]$] respectively.
	</p>
</li>

<li>
	<p>
	<span style="font-weight: bold">Tell your compiler where to find Goldie and SemiTwist D Tools.</span>
	<br />[:<span style="font-style: italic">
	[You can skip this step if you only intend to use the prebuilt tools and not the D library.]
	</span>:]
	</p>
	<p>
	To do this for DMD:
	</p>
	<p>
	Go to DMD's [$code|inline|bin$] directory and open
	[$code|inline|sc.ini$] (Windows) or [$code|inline|dmd.conf$]
	(All other OSes). On the line that starts with [$code|inline|DFLAGS=$],
	add the following flags:
	</p>
	[$code|plain| -Ipath_to_SemiTwistDTools/src -Ipath_to_Goldie/src $]
</li>

<li>
	<p>
	<span style="font-weight: bold">Build Goldie's tools and sample apps.</span>
	<br />[:<span style="font-style: italic">
	[You can skip this step if you obtained a release with prebuilt binaries for your OS.]
	</span>:]
	</p>
	<p>
	From Goldie's root directory:
	</p>
	<div class="code-plain">&gt;[$code|user| semitwist-stbuild all $]</div>
	<p>
	To see how to build the debug versions of Goldie's tools and sample apps,
	or only build one tool, or perform a cleaning:
	</p>
	<div class="code-plain">&gt;[$code|user| semitwist-stbuild --help $]</div>
</li>
</ol>
