Author: cbrisson
Date: Tue Jun 26 16:11:38 2018
New Revision: 1834441

URL: http://svn.apache.org/viewvc?rev=1834441&view=rev
Log:
[site/tools] Add a contributions section ; add FeedTool as a contribution

Added:
    velocity/site/cms/trunk/content/tools/devel/contributions/
    velocity/site/cms/trunk/content/tools/devel/contributions.mdtext
    velocity/site/cms/trunk/content/tools/devel/contributions/FeedTool.mdtext
Modified:
    velocity/site/cms/trunk/content/css/site.css
    velocity/site/cms/trunk/content/tools/devel/left.nav

Modified: velocity/site/cms/trunk/content/css/site.css
URL: 
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/css/site.css?rev=1834441&r1=1834440&r2=1834441&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/css/site.css (original)
+++ velocity/site/cms/trunk/content/css/site.css Tue Jun 26 16:11:38 2018
@@ -269,6 +269,7 @@ a[href]:visited
 pre, code
 {
     font-size: 0.8em;
+    line-height: 1.2em;
 }
 
 .note

Added: velocity/site/cms/trunk/content/tools/devel/contributions.mdtext
URL: 
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/contributions.mdtext?rev=1834441&view=auto
==============================================================================
--- velocity/site/cms/trunk/content/tools/devel/contributions.mdtext (added)
+++ velocity/site/cms/trunk/content/tools/devel/contributions.mdtext Tue Jun 26 
16:11:38 2018
@@ -0,0 +1,19 @@
+Title: Apache Velocity Tools - Contributions
+
+## Contributions
+
+This page lists reusable users contributed code. Please note that this code 
has been barely compiled and rarely tested by Velocity commiters.
+
+[TOC]
+
+### Tools
+
+* [FeedTool](contributions/FeedTool.html) by **C. Townson** is a tool 
providing the ability to retrieve and manipulate RSS and Atom feeds from within 
Velocity templates. It is built upon the [Rome 
API](https://rometools.github.io/rome/).
+
+### Contributing code
+
+If you can and wish to share your code, you're most welcome!
+
+Tools which are sufficiently generics will be considered for inclusion in the 
releases. Others will be listed on that page if considered productive.
+
+In either case, you will have to open an issue on [Velocity Tools' 
JIRA](https://issues.apache.org/jira/projects/VELTOOLS), describe your 
contribution, attach your code, and also the apropriate [Contributor License 
Agreement or Software Grant](https://www.apache.org/licenses/#grants).

Added: velocity/site/cms/trunk/content/tools/devel/contributions/FeedTool.mdtext
URL: 
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/contributions/FeedTool.mdtext?rev=1834441&view=auto
==============================================================================
--- velocity/site/cms/trunk/content/tools/devel/contributions/FeedTool.mdtext 
(added)
+++ velocity/site/cms/trunk/content/tools/devel/contributions/FeedTool.mdtext 
Tue Jun 26 16:11:38 2018
@@ -0,0 +1,45 @@
+Title: Apache Velocity Tools - FeedTool
+
+## FeedTool
+
+[FeedTool](FeedTool.mdtext) is a tool providing the ability to retrieve and 
manipulate RSS and Atom feeds from within Velocity templates. It is built upon 
the [Rome API](https://rometools.github.io/rome/).
+
+The tool works by retrieving a feed from a specified URI and returning it in a 
ContextFeedWrapper class. The idea with the wrapper class is to have a 
convenient location for the provision of convenience methods for feed and feed 
entry manipulation ... although it could easily be incorporated into a single 
class.
+
+[TOC]
+
+### Dependencies
+
+* [Rome API](https://rometools.github.io/rome/)
+
+        :::xml
+        <dependency>
+            <groupId>com.rometools</groupId>
+            <artifactId>rome</artifactId>
+            <version>1.10.0</version>
+        </dependency>
+
+* [Rome Fetcher](https://rometools.github.io/rome/Fetcher/index.html)
+
+        :::xml
+        <dependency>
+            <groupId>com.rometools</groupId>
+            <artifactId>rome-fetcher</artifactId>
+            <version>1.10.0</version>
+        </dependency>
+
+* [JDom2](http://www.jdom.org/)
+
+        ::xml
+        <dependency>
+            <groupId>org.jdom</groupId>
+            <artifactId>jdom2</artifactId>
+            <version>2.0.6</version>
+        </dependency>
+
+### Code
+
+{{source_file(contribs/tools/FeedTool/FeedTool.java)}}
+
+{{source_file(contribs/tools/FeedTool/ContextFeedWrapper.java)}}
+

Modified: velocity/site/cms/trunk/content/tools/devel/left.nav
URL: 
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/left.nav?rev=1834441&r1=1834440&r2=1834441&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/tools/devel/left.nav (original)
+++ velocity/site/cms/trunk/content/tools/devel/left.nav Tue Jun 26 16:11:38 
2018
@@ -5,13 +5,14 @@
 * [GenericTools](generic.html)
 * [VelocityView](view.html)
 ## Docs
-* [Tools Summary](tools-summary.html)
+* [Standard Tools](tools-summary.html)
 * [Javadoc](apidocs/index.html)
 * [Upgrading](upgrading.html)
 * [Configuration](configuration.html)
 * [Standalone Use](standalone.html)
 * [Web Integration](frameworks.html)
 * [Creating Tools](creating-tools.html)
+* [Contributions](contributions.html)
 * [Glossary](/engine/devel/glossary.html)
 * [FAQ](http://wiki.apache.org/velocity/VelocityFAQ)
 * [Wiki](http://wiki.apache.org/velocity/)


Reply via email to