You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@nutch.apache.org by Apache Wiki <wi...@apache.org> on 2014/06/25 07:10:04 UTC

[Nutch Wiki] Update of "CMS_Website_Update_HOWTO" by LewisJohnMcgibbney

Dear Wiki user,

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

The "CMS_Website_Update_HOWTO" page has been changed by LewisJohnMcgibbney:
https://wiki.apache.org/nutch/CMS_Website_Update_HOWTO?action=diff&rev1=14&rev2=15

- ## page was copied from Website_Update_HOWTO
  == What you need ==
  
- [[http://forrest.apache.org|Apache Forrest]] - Publishing framework used for Nutch Website maintenance. 
+ Take 10 minutes to
  
+  * Read the [[http://www.apache.org/dev/cms.html|Apache CMS documentation]]
+ 
+  * Read the Nutch Site [[http://svn.apache.org/repos/asf/nutch/cms_site/README.txt|README]]
+ 
+  * Get the [[https://cms.apache.org/#bookmark|CMS Bookmarklet]]
  
  == How to modify the docs ==
  
+ Read the [[http://www.apache.org/dev/cms.html#usage|Apache CMS Usage]]... again.
- 	1. Checkout nutch site code (https://svn.apache.org/repos/asf/nutch/site)
- 	1. Go to {{{forrest}}}. It is the root of Nutch Website Forrest project.
- 	1. Run {{{forrest}}} to build current version of documentation. If the build was successful it means Forrest was correctly installed and generated site is in {{{forrest/build/site}}} directory. If you get errors in validate-skins-stylesheets see http://forrest.apache.org/docs_0_90/faq.html#oldjing
- 	1. Modify files in {{{forrest/src}}} (mainly in {{{forrest/src/documentation/content/xdocs}}}). Run {{{forrest}}} in {{{forrest}}} and review the changes after build.
  
- == reviewing changes to the site ==
+ Thanks all folks.
  
- Type '''forrest run''' in your project root to start Forrest's built-in Jetty web server. Once it has started, point your browser at http://localhost:8888/, which will show your website, rendered on demand as each link is followed.
+ Hope you enjoy the CMS. 
  
- (Alternatively, if you wish to run Forrest from within an existing servlet container, type '''forrest webapp''' to build an open webapp in build/webapp/). You can now edit the XML content in build/webapp/content/xdocs and see the changes immediately in the browser. 
- 
- After this, type '''forrest validate''' to ensure that things are in order.
- 
- If you aren't a committer for this project, you now need to follow the instructions in HowToContribute to get your changes applied to the site.  You'll specifically want to read the sections on "Creating a patch" and "Proposing your work".  If you are a committer, it's time to deploy the site.
- 
- == How to deploy the site ==
- 
- 	1. When you are finally happy with your changes copy files from {{{forrest/build/site}}} directory to {{{publish}}} and commit both of them from /site to SVN.
- 	1. The modifications should be visible on the website within a few minutes.
- 
- == Skins Note ==
- 
- If you take a fresh copy of the website source from svn you will see several warnings as files are not found. 
- 
- Currently (Jun 2010) the website is still branded with Lucene. Forrest is configured to use the lucene skin. Unfortunately some of the images are missing from svn. You can get those images from lucene itself - or add them to svn if you have permission. It should be our intention to create a new Nutch skin by copying and modifying the old lucene skin. https://issues.apache.org/jira/browse/NUTCH-833
- 
- == Java 1.6 Note ==
- 
- If you get a fatal error in Forrest and you are using Java 1.6 check to see if it is [[https://issues.apache.org/jira/browse/FOR-984|this]] problem. Basically you need to upgrade to 0.9-dev and not use the released 0.8 version.
-