[68164] branches/gsoc10-mpwa

jrozner at macports.org jrozner at macports.org
Thu May 27 21:03:28 PDT 2010


Revision: 68164
          http://trac.macports.org/changeset/68164
Author:   jrozner at macports.org
Date:     2010-05-27 21:03:23 -0700 (Thu, 27 May 2010)
Log Message:
-----------
added static content and routing for it

Modified Paths:
--------------
    branches/gsoc10-mpwa/app/controllers/application_controller.rb
    branches/gsoc10-mpwa/app/helpers/application_helper.rb
    branches/gsoc10-mpwa/app/views/layouts/application.html.erb
    branches/gsoc10-mpwa/app/views/partials/_nav.html.erb
    branches/gsoc10-mpwa/config/routes.rb

Added Paths:
-----------
    branches/gsoc10-mpwa/app/controllers/pages_controller.rb
    branches/gsoc10-mpwa/app/helpers/pages_helper.rb
    branches/gsoc10-mpwa/app/views/pages/
    branches/gsoc10-mpwa/app/views/pages/contact.html.erb
    branches/gsoc10-mpwa/app/views/pages/index.html.erb
    branches/gsoc10-mpwa/app/views/pages/install.html.erb
    branches/gsoc10-mpwa/test/functional/pages_controller_test.rb
    branches/gsoc10-mpwa/test/unit/helpers/
    branches/gsoc10-mpwa/test/unit/helpers/pages_helper_test.rb

Property Changed:
----------------
    branches/gsoc10-mpwa/db/
    branches/gsoc10-mpwa/tmp/

Modified: branches/gsoc10-mpwa/app/controllers/application_controller.rb
===================================================================
--- branches/gsoc10-mpwa/app/controllers/application_controller.rb	2010-05-28 03:42:27 UTC (rev 68163)
+++ branches/gsoc10-mpwa/app/controllers/application_controller.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -7,4 +7,16 @@
 
   # Scrub sensitive parameters from your log
   filter_parameter_logging :password
+
+  $trac_url = 'http://trac.macports.org/'
+  $svn_url = 'http://svn.macports.org/repository/macports/'
+  $downloads_url = 'http://distfiles.macports.org/MacPorts/'
+  $guide_url = 'http://guide.macports.org'
+  $latest_version = '1.8.2'
+  $snowleopard_dmg = "#{$downloads_url}Macports-#{$latest_version}-10.6-SnowLeopard.dmg"
+  $leopard_dmg = "#{$downloads_url}Macports-#{$latest_version}-10.5-Leopard.dmg"
+  $tiger_dmg = "#{$downloads_url}Macports-#{$latest_version}-10.4-Tiger.dmg"
+  $bz2_tarball = "#{$downloads_url}MacPorts-#{$latest_version}.tar.bz2"
+  $gz_tarball = "#{$downloads_url}MacPorts-#{$latest_version}.tar.gz"
+  $checksums = "#{$downloads_url}MacPorts-#{$latest_version}.chk.txt"
 end

Added: branches/gsoc10-mpwa/app/controllers/pages_controller.rb
===================================================================
--- branches/gsoc10-mpwa/app/controllers/pages_controller.rb	                        (rev 0)
+++ branches/gsoc10-mpwa/app/controllers/pages_controller.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,7 @@
+class PagesController < ApplicationController
+  def show
+    respond_to do |format|
+      format.html { render :action => params[:page] }
+    end
+  end
+end

Modified: branches/gsoc10-mpwa/app/helpers/application_helper.rb
===================================================================
--- branches/gsoc10-mpwa/app/helpers/application_helper.rb	2010-05-28 03:42:27 UTC (rev 68163)
+++ branches/gsoc10-mpwa/app/helpers/application_helper.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -1,3 +1,7 @@
 # Methods added to this helper will be available to all templates in the application.
 module ApplicationHelper
+  def obfuscate_email(email)
+    email.sub!(/@/, '<img src="/images/at.gif" alt="at" />') 
+    return "<span class=\"email\">#{email}</span>"
+  end
 end

Added: branches/gsoc10-mpwa/app/helpers/pages_helper.rb
===================================================================
--- branches/gsoc10-mpwa/app/helpers/pages_helper.rb	                        (rev 0)
+++ branches/gsoc10-mpwa/app/helpers/pages_helper.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,2 @@
+module PagesHelper
+end

Modified: branches/gsoc10-mpwa/app/views/layouts/application.html.erb
===================================================================
--- branches/gsoc10-mpwa/app/views/layouts/application.html.erb	2010-05-28 03:42:27 UTC (rev 68163)
+++ branches/gsoc10-mpwa/app/views/layouts/application.html.erb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -31,7 +31,7 @@
       <%= link_to(image_tag('valid-xhtml11-blue.png', :alt => "Valid XHTML 1.1"), 'http://validator.w3.org/check?uri=referer') %>
       <%= link_to(image_tag('vcss.png', :alt => "Valid CSS"), 'http://validator.w3.org/check?uri=referer') %>
     </p>
-    <p>Copyright &#xA9; 2002&#x2013;<%= Time.now.strftime("%Y") %>, <%= link_to 'The MacPorts Project', root_url %>.Hosted by <%= link_to 'Mac OS Forge', 'http://www.macosforge.org' %>. All rights reserved.</p>
+    <p>Copyright &#xA9; 2002&#x2013;<%= Time.now.strftime("%Y") %>, <%= link_to 'The MacPorts Project', root_url %>. Hosted by <%= link_to 'Mac OS Forge', 'http://www.macosforge.org' %>. All rights reserved.</p>
   </div>
 
 </body>

Added: branches/gsoc10-mpwa/app/views/pages/contact.html.erb
===================================================================
--- branches/gsoc10-mpwa/app/views/pages/contact.html.erb	                        (rev 0)
+++ branches/gsoc10-mpwa/app/views/pages/contact.html.erb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,72 @@
+<div id="content">
+
+  <h2 class="hdr">Getting in Touch With Us</h2>
+
+  <p>There are a number of ways in which you can get in contact with people involved with The MacPorts Project, depending on who you need to contact and the type of support and/or feedback you're looking for:</p>
+
+  <ul>
+    <li><%= link_to 'Public Mailing Lists', '#Lists' %></li>
+    <li><%= link_to 'Administrative Contact', '#PortMgr' %></li>
+    <li><%= link_to 'Administrative Contact', '#Tracker' %></li>
+    <li><%= link_to 'IRC', '#IRC' %></li>
+    <li><%= link_to 'Individuals', '#Individuals' %></li>
+  </ul>
+
+  <h3>Getting Help</h3>
+
+  <p>If you're looking for help to troubleshoot a particular failure installing or using MacPorts, providing us with as much information about your host platform as you can gather will help us help you in turn to look into the problem. The following simple steps comprise our recommended procedure to obtain support:</p>
+
+  <ol>
+    <li>First and foremost, check the MacPorts <%= link_to 'Documentation', $guide_url %>, man pages, <%= link_to 'FAQ', "#{$trac_url}wiki/FAQ" %> and <%= link_to 'problems hotlsit', "#{$trac_url}wiki/ProblemHotlist" %>.</li>
+    <li>Second, check the archives of the appropriate mailing list you intend to post to (below) to see if your question has already been asked and dealt with.</li>
+    <li>Finally, if you still haven't found the answer to your problem, send e-mail to the appropriate mailing list with the following information:
+      <ul>
+        <li>output generated by the &#8220;<kbd>port</kbd>&#8221; command's <kbd>-v</kbd> (verbose) or <kbd>-d</kbd>(debug) flags;</li>
+        <li>platform details such as operating system version (e.g. 10.4.10), hardware architecture (e.g. Intel or PowerPC), and the version of Xcode installed -- the &#8220;<kbd>sw_vers</kbd>&#8221; and &#8220;<kbd>uname -a</kbd>&#8221; commands are of great help in this regard;</li>
+        <li>any third party software that may exist in places such as <kbd>/usr/local</kbd> and/or <kbd>/sw</kbd>.</li>
+      </ul>
+    </li>
+  </ol>
+
+
+  <h3 class="subhdr" id="Lists">Public Mailing Lists</h3>
+
+  <p>The MacPorts Project hosts a number of specialized mailing lists you can freely subscribe to:</p>
+
+  <ul>
+    <li><%= link_to 'MacPorts Users', 'http://lists.macosforge.org/mailman/listinfo/macports-users/' %>(<%= link_to 'archives', 'http://lists.macosforge.org/pipermail/macports-users/' %>): <p>General discussion of MacPorts installation and usage. A moderate volume list.</p></li>
+    <li><%= link_to 'MacPorts Developers', 'http://lists.macosforge.org/mailman/listinfo/macports-dev/' %>(<%= link_to 'archives', 'http://lists.macosforge.org/pipermail/macports-dev/' %>): <p>Where project members and contributors discuss the MacPorts &#8220;base&#8221; system itself and future development plans, and related &#8220;Portfile&#8221; writing best practices. A low volume list.</p></li>
+    <li><%= link_to 'MacPorts Changes', 'http://lists.macosforge.org/mailman/listinfo/macports-changes/' %>(<%= link_to 'archives', 'http://lists.macosforge.org/pipermail/macports-changes/' %>): <p>Read-only, low to moderate volume list of changes to our <%= link_to 'SVN repository', $svn_url %> for both &#8220;base&#8221; code and Portfiles, among others.</p>
+    </li>
+    <li><%= link_to 'MacPorts Tickets', 'http://lists.macosforge.org/mailman/listinfo/macports-tickets/' %>(<%= link_to 'archives', 'http://lists.macosforge.org/pipermail/macports-tickets/' %>): <p>Read-only, moderate volume list of ticket activity on our <%= link_to 'Trac bug tracker', $trac_url %>.</p></li>
+    <li><%= link_to 'MacPorts Announce', 'http://lists.macosforge.org/mailman/listinfo/macports-announce/' %>(<%= link_to 'archives', 'http://lists.macosforge.org/pipermail/macports-announce/' %>): <p>Read-only, low volume list for project related major announcements.</p></li>
+  </ul>
+
+  <p>Note that due to spam control policies you must subscribe to our non read-only lists in order to post to any of them. Members are expected to abide by the very simple <%= link_to 'Netiquette Guidelines', 'http://www.dtcc.edu/cs/rfc1855.html' %> that are common to most open forums when posting; of particular relevance is sticking to plain text messages, our language of choice (English), and reducing the number and size of attachments in any way possible (e.g, by using paste bins such as <%= link_to 'lisppate', 'http://paste.lisp.org/new/macports' %> or <%= link_to 'pastie', 'http://pastie.caboo.se' %> and passing along the paste URL rather than full error messages).</p>
+
+  <h3 class="subhdr" id="PortMgr">Administrative Contact</h3>
+
+  <p>The private and read-only &#8220;<%= obfuscate_email "macports-mgr at lists.macosforge.org" %>&#8221; mailing list is where you should send mail to in case you need to get in touch with the The MacPorts Project's <%= link_to 'management team', "#{$guide_url}#project.portmgr" %> (A.K.A. &#8220;PortMgr&#8221;), in case you have any administrative request or if you wish to discuss anything you might feel is of private nature (like the interaction between MacPorts and NDA'd software).</p>
+
+  <p>This is also where you should turn to if you are a developer and/or a contributor interested in joining The MacPorts Project with full write access to our SVN repository and Wiki pages, either to work on MacPorts itself or as a ports maintainer. Please read the <%= link_to 'documentation available', "#{$guide_url}#project.membership" %> on joining for more information.</p>
+
+  <h3 class="subhdr" id="Tracker">Bug Tracker</h3>
+
+  <p>We use the popular <%= link_to 'Trac', 'http://trac.edgewall.org/' %> web-based tool for our <%= link_to 'bug tracking', "#{$trac_url}roadmap" %> and <%= link_to 'Wiki', "#{$trac_url}wiki" %> needs, thus buying ourselves seamless read-only integration with our SVN repository through its <%= link_to 'source browser', "#{$trac_url}browser" %> and the project <%= link_to 'timeline', "#{$trac_url}timeline" %> (where ticket activity can also be viewed). Note that in order to interact with Trac for anything other than read only operations, you need to <%= link_to 'register', "#{$trac_url}auth/register" %> with Mac OS Forge for a Wordpress/Trac combined account.</p>
+
+  <p>If you think you've found a bug either in one of our <%= link_to 'available ports', ports_path %> or in MacPorts itself, or on the other hand if you'd like to make a contribution of any kind to the project, feel free to <%= link_to 'open a ticket', "#{$trac_url}newticket" %> to help us look into the problem and/or submission. Please keep in mind that we usually get a fairly high number of duplicate reports for common problems and therefore appreciate any help we can get in the process of streamlining our ticket duties. <%= link_to 'searching', "#{$trac_url}search" %> the Trac database &amp; mailing list archives (above), and reading our <%= link_to 'FAQ', "#{$trac_url}wiki/FAQ" %> &amp; <%= link_to 'problems hotlist', "#{$trac_url}wiki/ProblemHotlist" %> to see if your report has already been filed is recommended, as well as reading the <%= link_to 'ticketing guidelines', "#{$guide_url}#project.tickets" %> that will help you create a better report.</p>
+
+  <p>Viewing existing tickets through the facilities offered by predefined and custom <%= link_to 'ticket reports', $trac_url %> that allow for detailed queries is also available.</p>
+
+
+  <h3 class="subhdr" id="IRC">IRC</h3>
+
+  <p>For a more real-time discussion of any MacPorts related topic, the <%= link_to '#macports', 'irc://chat.freenode.net/#MacPorts' %> channel on the <%= link_to 'Freenode network', 'http://www.freenode.net' %> is where some of us usually hang out, MacPorts developers and community members alike. Everyone is free and welcomed to join us, even if it is for a random fun conversation or a productive troubleshooting session, but please keep in mind that no one is guaranteed to be around at any particular moment and that channel members are not obligated to answer your questions. If you fail to get any traction at time, do not take it personally and simply direct your questions to the mailing lists instead.</p>
+
+  <p>The language of choice for the IRC channel is also English, for obvious reasons of universality, so sticking to it is appreciated.</p>
+
+  <h3 class="subhdr" id="Individuals">Individuals</h3>
+
+  <p>To find out who the people behind MacPorts are and what they are up to, visit the <%= link_to 'team members page', "#{$trac_url}wiki/MacPortsDevelopers"%> on our Wiki and our <%= link_to 'CIA project page', 'http://cia.vc/stats/project/MacPorts' %>, which also shows SVN commit activity and many other project statistics.</p>
+
+</div>
\ No newline at end of file

Added: branches/gsoc10-mpwa/app/views/pages/index.html.erb
===================================================================
--- branches/gsoc10-mpwa/app/views/pages/index.html.erb	                        (rev 0)
+++ branches/gsoc10-mpwa/app/views/pages/index.html.erb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,33 @@
+<div id="content">
+
+  <h2 class="hdr">The MacPorts Project Official Homepage</h2>
+
+  <p>The MacPorts Project is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading either command-line, X11 or Aqua based open-source software on the <%= link_to 'Mac OS X', 'http://www.apple.com/macosx/' %> operating system. To that end we provide the command-line driven MacPorts software package under a <%= link_to 'BSD License', 'http://opensource.org/licenses/bsd-license.php' %>, and through it easy access to thousands of ports that <%= link_to 'greatly simplify', "#{$guide_url}#introduction" %> the task of <%= link_to 'compiling and installing', "#{$guide_url}#using" %> open-source software on your Mac.</p>
+
+  <p>We provide a single software tree that attempts to track the latest release of every software title (port) we distribute, without splitting them into &#8220;stable&#8221; Vs. &#8220;unstable&#8221; branches, targetting mainly the current Mac OS X release (10.6, A.K.A Snow Leopard) and the immediately previous one (10.5, A.K.A. Leopard). There are currently <%# link_to "<b>#{Port.count} ports</b>" %> in our tree, distributed among <%# Category.count %> different categories, and more are being added on a regular basis.</p>
+
+  <h3 class="subhdr">Getting started</h3>
+
+  <p>For information on installing MacPorts please see the <%= link_to 'installation', install_path %> section of this site and explore the myriad of download options we provide and our base system requirements.</p>
+
+  <p>If you run into any problems installing and/or using MacPorts we also have many options to help you, depending on how you wish to get <%= link_to 'get in touch with us', contact_path %>. Other important help resources are our online documentation, A.K.A <a href="<?php print $guide_url; ?>"> The MacPorts Guide</a>, and our Trac <%= link_to 'Wiki server &amp; bug tracker', $trac_url %>.</p>
+
+  <p><b>Latest MacPorts <%= link_to 'release', install_path %>: <%= $latest_version %></b></p>
+
+  <h3 class="subhdr">Getting involved</h3>
+
+  <p>There are many ways you can get involved with MacPorts and peer users, system administrators &amp; developers alike. Browse over to the &#8220;<%= link_to 'Contact Us', contact_path %>&#8221; section of our site and:</p>
+
+  <ul>
+    <li>Explore our <%= link_to 'mailing list', "#{contact_path}#Lists" %>, either if it is for some general user support or to keep on top of the latest MacPorts developments and commits to our software repository.</li>
+    <li>Check out our <%= link_to 'Support &amp; Development', "#{contact_path}#Tracker" %> portal for some bug reporting and live tutorials through the integrated Wiki server.</li>
+    <li>Or simply come join us for a friendly <%= link_to 'IRC Chat', "#{contact_path}#IRC" %> if you wish for more direct contact with the <%= link_to 'people behind', "#{contact_path}#Individuals" %> it all.</li>
+  </ul>
+
+  <p>If on the other hand you are interested in joining The MacPorts Project in any way, then don't hesitate to contact the project's management team, &#8220;<%= link_to 'PortMgr', "#{contact_path}#PortMgr" %>&#8221;, to explain your particular interest and present a formal application. We're always looking for more helping hands that can extend and improve our ports tree and documentation, or take MacPorts itself beyond its current limitations and into new areas of the vast software packaging field. We're eager to hear from you!</p>
+
+  <br />
+
+  <p>Browse over to our generous landlord's homepage, <%= link_to 'Mac OS Forge', 'http://www.macosforge.org' %>, for information on other related projects.</p>
+
+</div>
\ No newline at end of file

Added: branches/gsoc10-mpwa/app/views/pages/install.html.erb
===================================================================
--- branches/gsoc10-mpwa/app/views/pages/install.html.erb	                        (rev 0)
+++ branches/gsoc10-mpwa/app/views/pages/install.html.erb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,125 @@
+<div id="content">
+
+  <h2 class="hdr">Installing MacPorts</h2>
+
+  <p>MacPorts version <%= $latest_version %> is available in various formats for download and installation (note, if you are upgrading your Mac OS X to a new major release, see the <%= link_to 'migration info page', "#{$trac_url}wiki/Migration" %>):
+  </p>
+
+  <ul>
+    <li>&#8220;dmg&#8221; disk images for <%= link_to 'Snow Leopard', $snowleopard_dmg %>, <%= link_to 'Leopard', $leopard_dmg %> and <%= link_to 'Tiger', $tiger_dmg %> as a legacy platform, containing pkg installers for use with the Mac OS X Installer. By far the simplest installation procedure that most users should <%= link_to 'follow', '#pkg' %> after meeting the requirements listed <%= link_to 'below', '#requirements' %>.</li>
+    <li>In <%= link_to 'source form', '#source' %> as either a <%= link_to 'tar.bz2', $bz2_tarball %> package or a <%= link_to 'tar.gz', $gz_tarball %> one for manual compilation, if you intend to customize your installation in any way.</li>
+    <li><%= link_to 'SVN checkout', '#svn' %> of the unpackaged sources, if you wish to follow MacPorts development.</li>
+    <li>The <%= link_to 'selfupdate', '#selfupdate' %> target of the <kbd>port(1)</kbd> command, for users who already have MacPorts installed and wish to upgrade to a newer release.</li>
+  </ul>
+
+  <p>Checksums for our packaged <%= link_to 'downloads', $downloads_url %> are contained in the corresponding <%= link_to 'checksums file', $checksums %>.</p>
+
+  <div id="requirements">
+    <p>Please note that in order to install and run MacPorts on Mac OS X, your system must have installations of the following components:</p>
+    <ol>
+      <li>Apple's <%= link_to 'Xcode', 'http://developer.apple.com/tools/xcode' %> Developer Tools (version 3.2.1 or later for Snow Leopard, 3.1.4 or later for Leopard, or 2.5 for Tiger), found at the <%= link_to 'Apple Developer Connection', 'http://connect.apple.com' %> site or on your Mac OS X installation CDs/DVD. Ensure that the optional components for command line development are installed ("Unix Development" in the Xcode 3.x installer).</li>
+      <li>The X11 windowing environment (A.K.A. &#8220;X11 User&#8221;) for ports that depend on the functionality it provides to run.
+        <ul>
+          <li>The &#8220;X11 User&#8221; package is an optional installation on your system CDs/DVD for Tiger, enabled through the &#8220;Customize&#8221; button of the installer, whereas it is included by default on Leopard and Snow Leopard.</li>
+          <li>You can use the xorg-server port instead of Apple's X11.app if you wish.</li>
+        </ul>
+      </li>
+    </ol>
+  </div>
+
+
+  <h3 class="subhdr" id="pkg">Mac OS X Package (.pkg) Installer</h3>
+
+  <p>The easiest way to install MacPorts on a Mac OS X system is by downloading the dmg for <%= link_to 'Snow Leopard', $snowleopard_dmg %>, <%= link_to 'Leopard', $leopard_dmg %> or <%= link_to 'Tiger', $tiger_dmg %> and running the system's Installer by double-clicking on the pkg contained therein, following the on-screen instructions until completion.</p>
+
+  <p>This procedure will place a fully-functional and default MacPorts installation on your host system, ready for usage. If needed your shell configuration files will be <%= link_to 'adapted by the installer', "#{$guide_url}#installing.shell" %> to include the necessary settings to run MacPorts and the programs it installs, but you may need to open a new shell for these changes to take effect.</p>
+
+  <p>The MacPorts &#8220;<kbd>selfupdate</kbd>&#8221; command will also be run for you by the installer to ensure you have our latest available release and the latest revisions to the &#8220;Portfiles&#8221; that contain the instructions employed in the building and installation of ports. After installation is done, it is recommended that you run this step manually on a regular basis to to keep your MacPorts system always current:</p>
+  
+  <pre>sudo port -v selfupdate</pre>
+
+  <p>At this point you should be ready to enjoy MacPorts!</p>
+
+  <p>Type &#8220;<kbd>man port</kbd>&#8221; at the command line prompt and/or browse over to our <%= link_to 'Guide', "#{$guide_url}" %> to find out more information about using MacPorts. <%= link_to 'Help', '#help' %> is also available. </p>
+
+
+  <h3 class="subhdr" id="source">Source Installation</h3>
+
+  <p>If on the other hand you decide to install MacPorts from source, there are still a couple of things you will need to do after downloading the tarball before you can start installing ports, namely compiling and installing MacPorts itself:</p>
+
+
+  <ol>
+    <li>&#8220;<kbd>cd</kbd>&#8221; into the directory where you downloaded the package and run &#8220;<kbd>tar xjvf <%= link_to "MacPorts-#{$latest_version}.tar.bz2", $bz2_tarball %></kbd>&#8221; or &#8220;<kbd>tar xzvf <%= link_to "MacPorts-#{$latest_version}.tar.gz", $gz_tarball %></kbd>&#8221;, depending on whether you downloaded the bz2 tarball or the gz one, respectively.</li>
+    <li>Build and install the recently unpacked sources:
+      <ul>
+        <li><kbd>cd MacPorts-<%= $latest_version %></kbd></li>
+        <li><kbd>./configure &amp;&amp; make &amp;&amp; sudo make install</kbd></li>
+      </ul>
+      Optionally:
+      <ul>
+        <li><kbd>cd ../</kbd></li>
+        <li><kbd>rm -rf MacPorts-<%= $latest_version %>*</kbd></li>
+      </ul>
+    </li>
+  </ol>
+
+  <p>These steps need to be perfomed from an administrator account, for which &#8220;<kbd>sudo</kbd>&#8221; will ask the password upon installation. This procedure will install a pristine MacPorts system and, if the optional steps are taken, remove the as of now unnecessary MacPorts-<%= $latest_version %> source directory and corresponding tarball.</p>
+
+  <p>To customize your installation you should read the output of &#8220;<kbd>./configure --help | more</kbd>&#8221; and pass the appropriate options for the settings you wish to tweak to the configuration script in the steps detailed above.</p>
+
+  <p>You will need to manually adapt your shell's environment to work with MacPorts and your chosen installation <kbd> prefix</kbd> (the value passed to <kbd>configure</kbd>'s <kbd>--prefix</kbd> flag, defaulting to <kbd>/opt/local</kbd>):
+  </p>
+
+  <ul>
+    <li><kbd>Add ${prefix}/bin</kbd> and <kbd>${prefix}/sbin</kbd> to the start of your <kbd>PATH</kbd> environment variable so that MacPorts-installed programs take precedence over system-provided programs of the same name.</li>
+    <li>If a standard <kbd>MANPATH</kbd> environment variable already exists (that is, one that doesn't contain any empty components), add the <kbd>${prefix}/share/man</kbd> path to it so that MacPorts-installed man pages are found by your shell.</li>
+    <li>For Tiger and earlier only, add an appropriate X11 <kbd>DISPLAY</kbd> environment variable to run X11-dependent programs, as Leopard takes care of this requirement on its own.</li>
+  </ul>
+
+  <p>Lastly, you need to synchronize your installation with the MacPorts rsync server:</p>
+
+  <pre>sudo port -v selfupdate</pre>
+
+  <p>Upon completion MacPorts will be ready to install ports!</p>
+
+  <p>It is recommended to run the above command on a regular basis to keep your installation current. Type &#8220;<kbd>man port</kbd>&#8221; at the command line prompt and/or browse over to our <%= link_to 'Guide', $guide_url %> to find out more information about using MacPorts. <%= link_to 'Help', '#help' %> is also available.</p>
+
+
+  <h3 class="subhdr" id="svn">SVN Sources</h3>
+
+  <p>If you are developer or a user with a taste for the bleeding edge and wish for the latest changes and feature additions, you may acquire the MacPorts sources through subversion. See the Guide section on <%= link_to 'installing from subversion', "#{$guide_url}#installing.macports.subversion" %>.</p>
+
+  <p>Purpose-specific branches are also available at the <kbd><%= "#{$svn_url}branches" %></kbd> url.</p>
+
+  <p>Alternatively, if you'd simply like to view the SVN repository without checking it out, you can do so via the <%= link_to 'Trac source browser', "#{$trac_url}browser" %>.</p>
+  
+  
+  <h3 class="subhdr" id="selfupdate">Selfupdate</h3>
+
+  <p>If you already have MacPorts installed and have no restrictions to use the rsync networking protocol (tcp port 873 by default), the easiest way to upgrade to our latest available release, <b><%= $latest_version %></b>, is by using the <kbd>selfupdate</kbd> target of the <kbd>port(1)</kbd> command. This will both update your ports tree (by performing a <kbd>sync</kbd> operation) and rebuild your current installation if it's outdated, preserving your customizations, if any.</p>
+  
+
+  <h3 class="subhdr" id="other">Other Platforms</h3>
+
+  <p>Running on platforms other than Mac OS X is not the main focus of The MacPorts Project, so remaining cross-platform is not an actively-pursued development goal. Nevertheless, it is not an actively-discouraged goal either and as a result some experimental support does exist for other POSIX-compliant platforms such as *BSD and GNU/Linux.</p>
+
+  <p>The full list of requirements to run MacPorts on these other platforms is as follows (we assume you have the basics such as GCC and X11):</p>
+
+  <ul>
+    <li><%= link_to 'Tcl', 'http://www.tcl.tk' %> (8.4 or 8.5), with threads.</li>
+    <li><%= link_to 'GNUstep', 'http://gnustep.org' %> (Base), for Foundation.</li>
+    <li><b>mtree</b> for directory hierarchy.</li>
+    <li><%= link_to 'rsync', 'http://rsync.samba.org' %> for syncing the ports.</li>
+    <li><%= link_to 'cURL', 'http://curl.haxx.se' %> for downloading distfiles.</li>
+    <li><%= link_to 'OpenSSL', 'http://www.openssl.org' %> or <%= link_to 'libmd', 'http://martin.hinner.info/libmd' %> for checksums.</li>
+  </ul>
+
+  <p>Normally you must install from <%= link_to 'source', '#source' %> or from an <%= link_to 'SVN checkout', '#svn' %> to run MacPorts on any of these platforms. Experimental packaging is available for the FreeBSD (.tbz package), Fedora (.rpm package) and Ubuntu (.deb package) operating systems.</p>
+
+  <h3 class="subhdr" id="help">Help</h3>
+
+  <p>Help on a wide variety of topics is also available in the project <%= link_to 'Guide', $guide_url %> and through our <%= link_to 'Trac portal', $trac_url %> should you run into any problems installing and/or using MacPorts. Of particular relevance are the <%= link_to 'installation', "#{$guide_url}#installing" %> &amp; <%= link_to 'usage', "#{$guide_url}#using" %> sections of the former and the <%= link_to 'FAQ', "#{$trac_url}wiki.FAQ" %> section of the <%= link_to 'Wiki', "#{$trac_url}wiki" %>, where we keep track of questions frequently fielded on our <%= link_to 'mailing lists', "#{contact_path}#lists" %>.</p>
+
+  <p>If any of these resources do not answer your questions or if you need any kind of extended support, there are many ways to <%= link_to 'contact us', contact_path %>!</p>
+
+</div>
\ No newline at end of file

Modified: branches/gsoc10-mpwa/app/views/partials/_nav.html.erb
===================================================================
--- branches/gsoc10-mpwa/app/views/partials/_nav.html.erb	2010-05-28 03:42:27 UTC (rev 68163)
+++ branches/gsoc10-mpwa/app/views/partials/_nav.html.erb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -6,23 +6,23 @@
         <li><%= link_to 'Home', root_path %></li>
         <li><%= link_to 'Installing MacPorts', install_path %></li>
         <li><%= link_to 'Available Ports', ports_path %></li>
-        <li><%= link_to 'Documentation', 'http://guide.macports.org' %></li>
-        <li><%= link_to 'Support &amp; Development', 'http://trac.macports.org' %></li>
+        <li><%= link_to 'Documentation', $guide_url %></li>
+        <li><%= link_to 'Support &amp; Development', $trac_url %></li>
         <li><%= link_to 'Contact Us', contact_path %></li>
-        <li><%= link_to 'News', 'http://tac.macports.org/news' %></li>
+        <li><%= link_to 'News', "#{$trac_url}news" %></li>
       </ul>
     </dd>
 
     <dt>Shortcuts</dt>
       <dd>
         <ul>
-          <li><%= link_to 'Available Downloads', 'http://distfiles.macports.org/MacPorts' %></li>
-          <li><%= link_to 'MacPorts FAQ', 'http://trac.macports.org/wiki/FAQ' %></li>
-          <li><%= link_to 'Report a Bug', 'http://trac.macports.org/newticket' %></li>
-          <li><%= link_to 'Bug reporting Guidelines', 'http://http://guide.macports.org/#project.tickets' %></li>
-          <li><%= link_to 'Subversion Repository', 'http://svn.macports.org/repository/macports' %></li>
-          <li><%= link_to 'MacPorts Team', 'http://tac.macports.org/wiki/MacPortsDevelopers' %></li>
-          <li><%= link_to 'Becoming a Member', 'http://guide.macports.org/#project.membership' %></li>
+          <li><%= link_to 'Available Downloads', $downloads_url %></li>
+          <li><%= link_to 'MacPorts FAQ', "#{$trac_url}wiki/FAQ" %></li>
+          <li><%= link_to 'Report a Bug', "#{$trac_url}newticket" %></li>
+          <li><%= link_to 'Bug reporting Guidelines', "#{$trac_url}#project.tickets" %></li>
+          <li><%= link_to 'Subversion Repository', $svn_url %></li>
+          <li><%= link_to 'MacPorts Team', "#{$trac_url}wiki/MacPortsDevelopers" %></li>
+          <li><%= link_to 'Becoming a Member', "#{$guide_url}#project.membership" %></li>
           <li><%= link_to 'Mac OS Forge', 'http://www.macosforge.org' %></li>
         </ul>
       </dd>

Modified: branches/gsoc10-mpwa/config/routes.rb
===================================================================
--- branches/gsoc10-mpwa/config/routes.rb	2010-05-28 03:42:27 UTC (rev 68163)
+++ branches/gsoc10-mpwa/config/routes.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -1,5 +1,7 @@
 ActionController::Routing::Routes.draw do |map|
 
-  map.connect ':controller/:action/:id'
-  map.connect ':controller/:action/:id.:format'
+  map.install 'install', :controller => :pages, :action => :show, :page => :install
+  map.contact 'contact', :controller => :pages, :action => :show, :page => :contact
+  map.ports 'ports', :controller => :pages, :action => :show, :page => :ports #temporary until the scaffolding is generated
+  map.root :controller => :pages, :action => :show, :page => :index
 end


Property changes on: branches/gsoc10-mpwa/db
___________________________________________________________________
Added: svn:ignore
   + *sqlite3


Added: branches/gsoc10-mpwa/test/functional/pages_controller_test.rb
===================================================================
--- branches/gsoc10-mpwa/test/functional/pages_controller_test.rb	                        (rev 0)
+++ branches/gsoc10-mpwa/test/functional/pages_controller_test.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class PagesControllerTest < ActionController::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

Added: branches/gsoc10-mpwa/test/unit/helpers/pages_helper_test.rb
===================================================================
--- branches/gsoc10-mpwa/test/unit/helpers/pages_helper_test.rb	                        (rev 0)
+++ branches/gsoc10-mpwa/test/unit/helpers/pages_helper_test.rb	2010-05-28 04:03:23 UTC (rev 68164)
@@ -0,0 +1,4 @@
+require 'test_helper'
+
+class PagesHelperTest < ActionView::TestCase
+end


Property changes on: branches/gsoc10-mpwa/tmp
___________________________________________________________________
Added: svn:ignore
   + *

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100527/4a1bec35/attachment-0001.html>


More information about the macports-changes mailing list