Mozilla.org/How to Work with Site: Difference between revisions

m
Undo revision 166744 by Emmanuelm (Talk)
m (Undo revision 166744 by Emmanuelm (Talk))
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 options—viewing things on our staging site or viewing them locally.  
If you'd like to look at your changes before committing them to the live site, there are a couple of options&mdash;viewing things on our staging site or viewing them locally.


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).  
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. This set-up for your computer is documented below (''note that we could use some help with making these instructions more user-friendly''):
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 ==
1) Check out [http://svn.mozilla.org/projects/mozilla.org/trunk/ trunk] somewhere


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)
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


=== MAC OSX Setup ===
3) Add cronjob for front-page feed parser.  Example would be:


==== Pre-Requisites ====
<code>*/10 * * * * root cd /data/www/www.mozilla.org/includes/; ./feed-parser.php -c ./feed-parser-config.xml</code>


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.
4) Add Apache vhost for site (example vhost is in [http://svn.mozilla.org/projects/mozilla.org/trunk/README README])
 
===== 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.
12

edits