You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jspwiki.apache.org by ju...@apache.org on 2012/05/04 19:39:07 UTC

svn commit: r1334081 - /incubator/jspwiki/site/trunk/content/jspwiki/development/edit_website.mdtext

Author: juanpablo
Date: Fri May  4 17:39:07 2012
New Revision: 1334081

URL: http://svn.apache.org/viewvc?rev=1334081&view=rev
Log:
generated content set to TBD, extpaths.txt file was deleted by infra during the setup of the site

Modified:
    incubator/jspwiki/site/trunk/content/jspwiki/development/edit_website.mdtext

Modified: incubator/jspwiki/site/trunk/content/jspwiki/development/edit_website.mdtext
URL: http://svn.apache.org/viewvc/incubator/jspwiki/site/trunk/content/jspwiki/development/edit_website.mdtext?rev=1334081&r1=1334080&r2=1334081&view=diff
==============================================================================
--- incubator/jspwiki/site/trunk/content/jspwiki/development/edit_website.mdtext (original)
+++ incubator/jspwiki/site/trunk/content/jspwiki/development/edit_website.mdtext Fri May  4 17:39:07 2012
@@ -1,58 +1,62 @@
-Title: Edit Website
-
-(taken from MRUnit site)
-
-The website uses the Apache CMS. More detailed documentation is available on 
-the Apache Infrastructure pages including a quickstart guide on the
-[Apache bookmarklet][] and a [reference manual][]. It is also useful to look at
-[other Apache CMS sites][] for examples.
-
-## Process
-
-  1. Commit a change to the website's source [Markdown][] files located in
-<a href="https://svn.apache.org/repos/asf/incubator/jspwiki/site/trunk" 
-class="external>https://svn.apache.org/repos/asf/incubator/jspwiki/site/trunk</a>. 
-Before committing test that the site still builds locally by installing the
-[CMS build scripts][] and running:
-
-        buildsite/build_site.pl --source-base jspwiki-site --target-base jspwiki-website
-
-    If deleting a file or changing the name of a file make a trivial edit to
-lib/path.pm or lib/view.pm to force a full site rebuild. If making a simple edit
-it is easier to just use the Apache bookmarklet.
-
-  2. Wait a few minutes to get the email on the commits list that buildbot has
-rebuilt the [staging website][].
-  3. If the change looks ok, commit the change to the production website by one
-of the following:
-
-    * Using the Apache bookmarklet and selecting [Publish site][]
-    * curl -sL http://s.apache.org/cms-cli | perl on your local machine
-    * ssh -t <user\>@people.apache.org publish.pl jspwiki <your Apache ID\>
-
-## Posting generated content
-
-  1. Add the path to content/extpaths.txt relative to the extpaths.txt
-file to prevent the content getting deleted when the staging site is published
-  2. Commit the generated content directly to the [production site svn][]
-
-## Style
-
-  * Try to limit line length to 80 columns, fold -s <filename\> on Linux is
-helpful for limiting line length
-  * Use links in the [link name][] style rather than [link name][1] because it
-is more difficult to match up the numbers and removing links causes all the
-numbers to have to get updated
-  * Indent with spaces not tabs
-  * Use * for lists and indent lists by 2 spaces
-
-[Apache bookmarklet]: http://apache.org/dev/cms.html#usage
-[reference manual]: http://apache.org/dev/cmsref.html
-[other Apache CMS sites]: http://apache.org/dev/cmsadoption.html
-
-[production site svn]: https://svn.apache.org/repos/infra/websites/production/jspwiki
-
-[Markdown]: http://daringfireball.net/projects/markdown/syntax
-[CMS build scripts]: http://apache.org/dev/cmsref.html#local-build
-[staging website]: http://jspwiki.staging.apache.org/jspwiki/
+Title: Edit Website
+
+(taken from MRUnit site)
+
+The website uses the Apache CMS. More detailed documentation is available on 
+the Apache Infrastructure pages including a quickstart guide on the
+[Apache bookmarklet][] and a [reference manual][]. It is also useful to look at
+[other Apache CMS sites][] for examples.
+
+## Process
+
+  1. Commit a change to the website's source [Markdown][] files located in
+<a href="https://svn.apache.org/repos/asf/incubator/jspwiki/site/trunk" 
+class="external>https://svn.apache.org/repos/asf/incubator/jspwiki/site/trunk</a>. 
+Before committing test that the site still builds locally by installing the
+[CMS build scripts][] and running:
+
+        buildsite/build_site.pl --source-base jspwiki-site --target-base jspwiki-website
+
+    If deleting a file or changing the name of a file make a trivial edit to
+lib/path.pm or lib/view.pm to force a full site rebuild. If making a simple edit
+it is easier to just use the Apache bookmarklet.
+
+  2. Wait a few minutes to get the email on the commits list that buildbot has
+rebuilt the [staging website][].
+  3. If the change looks ok, commit the change to the production website by one
+of the following:
+
+    * Using the Apache bookmarklet and selecting [Publish site][]
+    * curl -sL http://s.apache.org/cms-cli | perl on your local machine
+    * ssh -t <user\>@people.apache.org publish.pl jspwiki <your Apache ID\>
+
+## Posting generated content
+
+<span class="warning">TBD</span>
+
+<!---
+  1. Add the path to content/extpaths.txt relative to the extpaths.txt
+file to prevent the content getting deleted when the staging site is published
+  2. Commit the generated content directly to the [production site svn][]
+-->
+
+## Style
+
+  * Try to limit line length to 80 columns, fold -s <filename\> on Linux is
+helpful for limiting line length
+  * Use links in the [link name][] style rather than [link name][1] because it
+is more difficult to match up the numbers and removing links causes all the
+numbers to have to get updated
+  * Indent with spaces not tabs
+  * Use * for lists and indent lists by 2 spaces
+
+[Apache bookmarklet]: http://apache.org/dev/cms.html#usage
+[reference manual]: http://apache.org/dev/cmsref.html
+[other Apache CMS sites]: http://apache.org/dev/cmsadoption.html
+
+[production site svn]: https://svn.apache.org/repos/infra/websites/production/jspwiki
+
+[Markdown]: http://daringfireball.net/projects/markdown/syntax
+[CMS build scripts]: http://apache.org/dev/cmsref.html#local-build
+[staging website]: http://jspwiki.staging.apache.org/jspwiki/
 [Publish site]: https://cms.apache.org/jspwiki/publish
\ No newline at end of file