svn commit: r952987 - in /websites/staging/directory/trunk/content: ./ sources.html

[bu...@apache.org]

Author: buildbot
Date: Thu May 28 12:17:21 2015
New Revision: 952987

Log:
Staging update by buildbot for directory

Modified:
    websites/staging/directory/trunk/content/   (props changed)
    websites/staging/directory/trunk/content/sources.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu May 28 12:17:21 2015
@@ -1 +1 @@
-1678776
+1682223

Modified: websites/staging/directory/trunk/content/sources.html
==============================================================================
--- websites/staging/directory/trunk/content/sources.html (original)
+++ websites/staging/directory/trunk/content/sources.html Thu May 28 12:17:21 2015
@@ -329,6 +329,53 @@ For committers to be able to commit modi
 </tr>
 </tbody>
 </table>
+<h2 id="web-site">Web Site</h2>
+<p>The Web site itslef is stored in a repository and can be updated easily. Let's see how it works.</p>
+<p>What is important here is that the pages are written using Markdown. Once a page has been modified, it can be committed, which will generate the static pages on a staging web site. When everything is checked and sounds correct, the staging site can be published on the production site, which will be pushed to the mirrors every hour. Here is the process :</p>
+<ul>
+<li>Modified the markdown pages</li>
+<li>Commit them</li>
+<li>Check on the staging site to see if it's correct (see <a href="http://directory.staging.apache.org/">http://directory.staging.apache.org/</a>)</li>
+<li>Publish the site using the <a href="http://www.apache.org/dev/cmsref.html">Apache CMS</a></li>
+</ul>
+<h3 id="repository">Repository</h3>
+<p>All the web site can be fetched at <a href="http://svn.apache.org/repos/asf/directory/site/trunk/">https://svn.apache.org/repos/asf/directory/site/trunk/</a>. be sure to use <em>https</em> in order to be able to commit your changes...</p>
+<h3 id="structure">Structure</h3>
+<p>The following structure is used :</p>
+<div class="codehilite"><pre><span class="n">cgi</span><span class="o">-</span><span class="n">bin</span>
+
+<span class="n">content</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="n">apacheds</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="n">api</span>
+  <span class="p">.</span>
+  <span class="p">.</span>
+  <span class="o">+--</span> <span class="p">(</span><span class="n">common</span> <span class="n">pages</span><span class="p">)</span>
+
+<span class="n">lib</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="n">path</span><span class="p">.</span><span class="n">pm</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="n">view</span><span class="p">.</span><span class="n">pm</span>
+
+<span class="n">templates</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="n">apacheds</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="n">api</span>
+  <span class="p">.</span>
+  <span class="p">.</span>
+  <span class="o">+--</span> <span class="n">studio</span>
+  <span class="o">|</span>
+  <span class="o">+--</span> <span class="p">(</span><span class="n">index</span><span class="p">.</span><span class="n">html</span><span class="p">,</span> <span class="n">etc</span><span class="p">)</span>
+</pre></div>
+
+
+<p>Usually, you won't have to change the templates and lib section (except when cutting a release). Most of ypur updates will impact the content/<project> pages.</p>
+<h3 id="publiching-the-web-site">Publiching the web site</h3>
+<p>You have to install the <a href="http://www.apache.org/dev/cms.html#usage">CMS bookmarklet</a> for that. Then simply open the directory web site and click on the bookmarklet, enter your apache credentials (you have to be a committer) and click on the 'Publish' button.</p>
+<p>The best way to undertand how to use the CMS system is to follow <a href="https://www.youtube.com/watch?v=xcDZN3Lu6HA">this video</a>.</p>