lucene-solr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Solr Wiki] Update of "Website_Update_HOWTO" by HossMan
Date Fri, 18 Mar 2011 19:28:58 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Solr Wiki" for change notification.

The "Website_Update_HOWTO" page has been changed by HossMan.
The comment on this change is: forrest variable injection was removed, see  SOLR-2434.
http://wiki.apache.org/solr/Website_Update_HOWTO?action=diff&rev1=11&rev2=12

--------------------------------------------------

  == Prerequisite ==
   1. Install [[http://forrest.apache.org|Apache Forrest]] version 0.8 (note: you must have
`java` pointing to jdk1.5, not a jdk1.6, lest you be faced with mysterious syntax errors )
   1. Checkout the solr code.
-  1. run {{{ant clean init-forrest-entities}}} to ensure that the {{{build/solr-specific-forrest-variables.ent}}}
file containing variables for use in Forrest generated documents (like specversion in the
tutorial) is created and up to date.  This is done automatically by most Solr ant targets.
   1. Go to {{{trunk/src/site}}} (which contains the forrest.properties file)
   1. Run {{{forrest}}} to build current version of documentation to make sure that Forrest
was correctly installed. The generated site will be in {{{trunk/src/site/build/site/}}}. 
You may need to clear out trunk/src/site/build if the solr-specific-forrest-variables.ent
doesn't "take".
  == Website update steps ==
   1. Run {{{forrest run}}} and browse to http://localhost:8888 to review the changes.  You
should be able to modify the source documents and hit reload on your browser without rebuilding
the site.
-     * NOTE: unlike the xdoc files, changes to {{{build/solr-specific-forrest-variables.ent}}}
are not picked up by a running instance of forrest.
   1. When you are satisfied with your changes, regenerate the site with {{{forrest}}}, (recursively)
copy {{{trunk/src/site/build/site/*}}} to {{{trunk/site/}}}, and commit changes to both {{{trunk/src/site/src}}}
and {{{trunk/site}}} (add any new files first, but exclude the build directory).
   1. To deploy the site, {{{ssh people.apache.org}}} and then {{{cd /www/lucene.apache.org/solr;
svn up}}}
   1. Wait ~30 minutes for the site to be sync'd and then check the public site.
  
  == Announce? ==
  
- If the reason for updating the site was to post some sort of significant new news (ie: a
release, a new committer, an upcoming talk, etc...) or to add completely new documentation
consider sending out an announcement email to the solr-user@, solr-dev@, and general@ lucene
mailing lists.
+ If the reason for updating the site was to post some sort of significant new news (ie: a
release, a new committer, an upcoming talk, etc...) or to add completely new documentation
consider sending out an announcement email to the solr-user@, dev@, and general@ lucene mailing
lists.
  

Mime
View raw message