source: trunk/www/getmp.php @ 29367

Last change on this file since 29367 was 28994, checked in by jmpp@…, 13 years ago
  • Rework the $mp_version* variables into $mp_version_major & $mp_version_latest, use them appropriately;
  • Abstract commonly used links in includes/common.inc and use them throughout all the files, but mainly in getmp.php;
  • Point the help section referenced in getmp.php to our trac portal;

NOTE: "Help" section and "SVN sources" in getmp.php still need to be rewritten.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
  • Property svn:mime-type set to text/x-php
File size: 6.2 KB
Line 
1<?php
2    /* $Id: getmp.php 28994 2007-09-12 22:33:44Z jmpp@macports.org $ */
3    $MPWEB = $_SERVER['DOCUMENT_ROOT'] . dirname($_SERVER['SCRIPT_NAME']);
4    include_once("$MPWEB/includes/common.inc");
5    print_header('MacPorts -- Download &amp; Installation', 'utf-8');
6?>
7
8<div id="content">
9
10    <h2 class="hdr">Get MacPorts</h2>
11
12    <p>MacPorts version <?php print "$mp_version_major"; ?> is available in binary form as a dmg disk image for <a
13    href="<?php print $tiger_dmg; ?>"> Tiger (Universal)</a> or <a href="<?php print $panther_dmg; ?>"> Panther</a>,
14    both containing a pkg installer, or in source form as either a <a href="<?php print $bz2_tarball ?>">tar.bz2</a>
15    package or a <a href="<?php print $gz_tarball; ?>">tar.gz</a> one. Checksums for all these are contained in the
16    <a href="<?php print $checksums; ?>">checksums file</a>.</p>
17
18    <p>To get a files listing of all our available downloads checkout the <a href="<?php print $downloads; ?>">
19    downloads section</a> of the site.</p>
20
21    <p>Please note that in order to install and run MacPorts on Mac OS X you must have Apple's Developer Tools
22    package installed, found at the <a href="http://developer.apple.com/tools/xcode/">Apple Developer site</a>
23    or on your Mac OS installation CDs/DVD.</p>
24
25    <p>If you want to use MacPorts on a platform other than Mac OS X, please be aware of the following requirements
26    (we assume that you have basics such as GCC and X11):</p>
27
28    <ul>
29        <li><a href="http://www.tcl.tk/">Tcl</a> (8.3 or 8.4), with threads</li>
30        <li><a href="http://gnustep.org/">GNUstep</a> (Base), for Foundation</li>
31        <li><a href="http://rsync.samba.org/">rsync</a></li>
32        <li><a href="http://curl.haxx.se/">cURL</a></li>
33        <li><a href="http://www.openssl.org/">OpenSSL</a> or <a href="http://martin.hinner.info/libmd/">libmd</a></li>
34    </ul>
35
36    <h3 class="subhdr">Mac OS X Package (.pkg) Installer</h3>
37
38    <p>The easiest way to install MacPorts on a Mac OS X system is by downloading the <a href="<?php print $tiger_dmg;
39    ?>">dmg for Tiger</a> or the <a href="<?php print $panther_dmg; ?>"> one for Panther</a> and running Installer.app
40    on the pkg contained therein by double clicking on them, following the on-screen instructions until completion. This
41    procedure will place a fully functional and default MacPorts installation on your host system, ready for usage. If
42    needed, your shell configuration files will be adapted by the installer to include the necessary settings to run
43    MacPorts. You may need to open a new shell for these changes to take effect.</p>
44
45    <p>Although not strictly necessary, it is still recommended that you synchronize your recent installation with our
46    rsync server to ensure you have the latest release available of the MacPorts infrastructure and of the &ldquo;Portfiles&rdquo;
47    containing the instructions employed in the building and installation of ports. To accomplish this simply execute:</p>
48
49    <pre>sudo port -d selfupdate</pre>
50
51    <p>It is also recommended to run the above command on a regular basis to keep your installation always current.
52    At this point you should be ready to enjoy MacPorts!</p>
53
54    <h3 class="subhdr">Source Installation</h3>
55
56    <p>If on the other hand you decide to install from source, there are still a couple of things you will need to
57    do once you've downloaded the tarball before you can install a port with the MacPorts system, namely compiling
58    and installing MacPorts itself. &ldquo;<kbd>cd</kbd>&rdquo; into the directory where you downloaded the package
59    and run &ldquo;<kbd>tar xjvf <a href="<?php print $bz2_tarball; ?>">MacPorts-<?php print "$mp_version_major"; ?>.tar.bz2
60    </a></kbd>&rdquo; or &ldquo;<kbd>tar xzvf <a href="<?php print $gz_tarball; ?>">MacPorts-<?php print "$mp_version_major";
61    ?>.tar.gz</a></kbd>&rdquo;, depending on whether you downloaded the bz2 tarball or the gz one, respectively.
62    This will unpack the MacPorts sources that you will proceed to build and install. To do so, execute the following:</p>
63
64<pre>cd MacPorts-<?php print $mp_version_major; ?>
65
66./configure &amp;&amp; make &amp;&amp; sudo make install</pre>
67
68    <p>Optionally:</p>
69
70<pre>cd ../
71rm -rf MacPorts-<?php print $mp_version_major; ?>*</pre>
72
73    <p>These steps need to be perfomed from an administrator account, for which &ldquo;<kbd>sudo</kbd>&rdquo;
74    will ask the password upon installation. This procedure will install a pristine MacPorts system and, if the
75    optional steps are taken, remove the as of now unnecessary MacPorts-<?php print "$mp_version_major"; ?> source
76    directory and corresponding tarball. To customize your installation you should read the output of
77    &ldquo;<kbd>./configure --help | more</kbd>&rdquo; and pass the appropriate options for the settings you wish to
78    tweak to the configuration script in the steps detailed above.</p>
79       
80    <p>You will need to adapt your shell's configuration files to find the binaries installed by MacPorts.
81    Lastly, you need to synchronize your recent installation with the MacPorts rsync server:</p>
82
83    <pre>sudo port -d selfupdate</pre>
84
85    <p>Upon completion MacPorts will be ready to install ports. Again, it is recommended to run the above
86    command on a regular basis to keep your installation current.</p>
87
88    <h3 class="subhdr">Help</h3>
89
90    <p>Help is also available through our <a href="<?php print $trac_url; ?>">Trac portal</a> should you need it.</p>
91
92    <h3 class="subhdr">SVN Sources</h3>
93
94    <p>If you are developer or a user with a taste for the bleeding edge and wish for the latest changes and
95    feature additions, you may acquire the MacPorts sources through SVN.</p>
96
97    <p>Use the following command to check the project out of the MacPorts anonymous subversion repository:</p>
98
99<pre>svn co <?php print $svn_url . '/trunk'; ?></pre>
100
101    <p>If you do not want to bother with fetching from SVN, you can download a nightly updated
102    <a href="/macports/downloads/macports-nightly-svn-snapshot.tar.gz"> SVN-snapshot</a>. Once extracted,
103    you can keep it up to date with the usual &ldquo;<kbd>svn update</kbd>&rdquo; commands.</p>
104
105    <p>If you'd simply like to view the SVN repository without checking it out, you can do so via the
106    <a href="http://trac.macports.org/projects/macports/browser">Trac browser</a>.</p>
107
108</div>
109
110<?php
111  print_footer();
112?>
Note: See TracBrowser for help on using the repository browser.