directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r952987 - in /websites/staging/directory/trunk/content: ./ sources.html
Date Thu, 28 May 2015 12:17:21 GMT
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>
 
 
 



Mime
View raw message