12
edits
Mozilla.org/How to Work with Site: Difference between revisions
Jump to navigation
Jump to search
Mozilla.org/How to Work with Site (view source)
Revision as of 03:05, 6 September 2009
, 6 September 2009→Staging Site
| Line 67: | Line 67: | ||
<code>svn ci -m "Comment goes here" foo.html</code> | <code>svn ci -m "Comment goes here" foo.html</code> | ||
=Staging Site= | = Staging Site = | ||
If you'd like to look at your changes before committing them to the live site, there are a couple of | If you'd like to look at your changes before committing them to the live site, there are a couple of options—viewing things on our staging site or viewing them locally. | ||
There is a staging site available at http://www-stage.mozilla.org. | There is a staging site available at http://www-stage.mozilla.org. However, this isn't the best place to work on changes since the site is set up just to automatically pass on changes to the live site (this gives you a chance to check on things after committing a change to the repository). | ||
Another staging option is to run a version of the site locally based on the files checked out from the repository. | Another staging option is to run a version of the site locally based on the files checked out from the repository. This set-up for your computer is documented below (''note that we could use some help with making these instructions more user-friendly''): | ||
== Localhost Site Setup == | |||
The following directions will show you how to setup a version of [http://mozilla.org mozilla.org] on your local machine under the domain name [http://mozilla.dev mozilla.dev] (Note: Once you are done with this guide, that link should work for you) | |||
=== MAC OSX Setup === | |||
==== Pre-Requisites ==== | |||
4) Add Apache vhost for site (example vhost is in [http://svn.mozilla.org/projects/mozilla.org/trunk/README README]) | Most of the really big pieces needed to run a site are built in to OS X. The majority of the work to get a development version of mozilla.org running is configuring these things. | ||
===== Already Included in OSX ===== | |||
*; Apache | |||
*; PHP | |||
===== Need to Install ===== | |||
*; Subversion (SVN) : There are many ways to get Subversion for OSX | |||
** If you have installed Developer Tools then you already have Subversion | |||
** The binaries from Collabnet are the simplest and fastest ways to get running if you don't already have it. <br /> '''Collabnet Subversion for OSX''' (''Universal Binary 10.4+'') ''[http://www.open.collab.net/downloads/community/ Download]'' [[File:Moz.wiki.mozweb-install.subversion.png]] | |||
*; [http://code.google.com/p/virtualhost-sh/ virtualhost.sh] by [http://patrickgibson.com/ Patrick Gibson] : An ingenious little time-saver for OSX and Ubuntu that will make a /etc/hosts entry and setup apache in one easy step. | |||
[[File:virtualhost-sh.png]] | |||
* To install merely download and put virtualhost.sh in ~/Sites/ or somewhere in your path | |||
<pre><b>$ svn --version</b> | |||
svn, version 1.6.5 (r38866) | |||
compiled Sep 5 2009, 10:55:17 | |||
Copyright (C) 2000-2009 CollabNet. | |||
Subversion is open source software, see http://subversion.tigris.org/ | |||
This product includes software developed by CollabNet (http://www.Collab.Net/). | |||
The following repository access (RA) modules are available: | |||
* ra_neon : Module for accessing a repository via WebDAV protocol using Neon. | |||
- handles 'http' scheme | |||
- handles 'https' scheme | |||
* ra_svn : Module for accessing a repository using the svn network protocol. | |||
- with Cyrus SASL authentication | |||
- handles 'svn' scheme | |||
* ra_local : Module for accessing a repository on local disk. | |||
- handles 'file' scheme | |||
* ra_serf : Module for accessing a repository via WebDAV protocol using serf. | |||
- handles 'http' scheme | |||
- handles 'https' scheme</pre> | |||
1) Check out [http://svn.mozilla.org/projects/mozilla.org/trunk/ trunk] somewhere | |||
2) Copy [http://svn.mozilla.org/projects/mozilla.org/trunk/includes/config.inc.php-dist includes/config.inc.php-dist] to includes/config.inc.php and edit appropriately | |||
3) Add cronjob for front-page feed parser. Example would be: | |||
<code>*/10 * * * * root cd /data/www/www.mozilla.org/includes/; ./feed-parser.php -c ./feed-parser-config.xml</code> | |||
4) Add Apache vhost for site (example vhost is in [http://svn.mozilla.org/projects/mozilla.org/trunk/README README]) | |||
In the future we may change how staging works, but [[Mozilla.org#Contact_Us|let us know]] if you have any questions about this current setup. | In the future we may change how staging works, but [[Mozilla.org#Contact_Us|let us know]] if you have any questions about this current setup. | ||