[struts-site] branch master updated: Cleans up section about templates

2017-09-24 Thread lukaszlenart
This is an automated email from the ASF dual-hosted git repository.

lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/master by this push:
 new 8e1fdf7  Cleans up section about templates
8e1fdf7 is described below

commit 8e1fdf75510a69cdcdb88aeaf10957f075c5d005
Author: Lukasz Lenart 
AuthorDate: Sun Sep 24 21:04:05 2017 +0200

Cleans up section about templates
---
 source/tag-developers/ajax-a-template.md|  24 ++
 source/tag-developers/ajax-div-template.md  | 161 ++
 source/tag-developers/ajax-event-system.md  |  38 +++
 source/tag-developers/ajax-head-template.md |  25 ++
 source/tag-developers/ajax-theme.md | 439 +++-
 source/tag-developers/css-xhtml-theme.md| 171 ---
 source/tag-developers/simple-theme.md   |  40 ++-
 source/tag-developers/xhtml-theme.md| 252 +---
 8 files changed, 439 insertions(+), 711 deletions(-)

diff --git a/source/tag-developers/ajax-a-template.md 
b/source/tag-developers/ajax-a-template.md
new file mode 100644
index 000..42301ea
--- /dev/null
+++ b/source/tag-developers/ajax-a-template.md
@@ -0,0 +1,24 @@
+---
+layout: default
+title: Tag Developers Guide (WIP)
+---
+
+# ajax a template
+
+The ajax theme is experimental. Feedback is appreciated.
+
+The ajax a template is used to make asynchronous calls to the server when the 
user clicks on the a href link. It is 
+useful when you need to communicate information back to the application from 
the UI, without requiring the entire page 
+to be re-rendered. An example would be removing an item from a list.
+
+The `preInvokeJS` attribute is used to determine whether the URL specified 
should be called or not, and must contain 
+Javascript that returns `true` or `false`. If you want to call a JavaScript 
function, use the format 
+`preInvokeJS='yourMethodName(data,type)'`. An example would be to show a 
confirm dialog to the user to double check 
+whether they want to remove a user from a list.
+
+**Remember**: the content returned by the `href` attribute must be JavaScript. 
That JavaScript will then be evaluated 
+within the webpage. If you only wish to publish an event to the topic 
specified, then simply return no result (or `NONE`) 
+from your action and utilize the `notifyTopics` attribute to specific the 
topic names.
+
+For an example of the interaction between the [div](dojo-div-tag.html) tag and 
the [a](dojo-a-tag.html) tag using 
+the topic pub/sub model, see the examples in the [ajax div 
template](ajax-div-template.html).
diff --git a/source/tag-developers/ajax-div-template.md 
b/source/tag-developers/ajax-div-template.md
new file mode 100644
index 000..8fbc82b
--- /dev/null
+++ b/source/tag-developers/ajax-div-template.md
@@ -0,0 +1,161 @@
+---
+layout: default
+title: Tag Developers Guide (WIP)
+---
+
+# ajax div template
+
+> The Ajax theme is experimental. Feedback is appreciated.
+
+The ajax [div](dojo-div-tag.html) template provides a much more interesting 
div rendering option that the other themes 
+do. Rather than simply rendering a `` tag, this template relies on 
advanced AJAX features provided 
+by the [Dojo Toolkit](http://dojotoolkit.org). While the 
[div](dojo-div-tag.html) tag could be used outside 
+of the [ajax theme](), it is usually not very useful. See the 
[div](dojo-div-tag.html) tag for more information on what 
+features are provided.
+
+## Features
+
+The remote div has a few features, some of which can be combined with the 
[a](dojo-a-tag.html) tag and 
+the [ajax a template](ajax-a-template.html). These uses are:
+
+- Retrieve remote data
+- Initialize the div with content before the remote data is retrieved
+- Display appropriate error and loading messages
+- Refresh data on a timed cycle
+- Listen for events and refresh data
+- JavaScript control support
+
+## Retrieve Remote Data
+
+The simplest way to use the div tag is to provide an `href` attribute. For 
example:
+
+```html
+http://www.weather.com/weather?zip=97239"/>
+```
+
+What this does after the HTML page is completely loaded, the specified URL 
will be retrieved asynchronously
+in the browser. The entire contents returned by that URL will be injected in 
to the div.
+
+## Initializing the Div
+
+Because the remote data isn't loaded immediately, it is sometimes useful to 
have some placeholder content that exists 
+before the remote data is retrieved. The content is essentially just the body 
of the div element. For example:
+
+```html
+http://www.weather.com/weather?zip=97239";>
+Placeholder...
+
+```
+
+If you wish to load more complex initial data, you can use the 
[action](action-tag.html) tag and the `executeResult` 
+attribute:
+
+```html
+http://www.weather.com/weather?zip=97239";>
+
+
+
+
+```
+
+## Loading and Error Messages
+
+If you'd like to display special messages when the data is being retri

[struts-site] branch master updated: Includes proper file

2017-09-24 Thread lukaszlenart
This is an automated email from the ASF dual-hosted git repository.

lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/master by this push:
 new ca18fa4  Includes proper file
ca18fa4 is described below

commit ca18fa4e87ef310f89f601f5f569247df8b3b82f
Author: Lukasz Lenart 
AuthorDate: Sun Sep 24 21:11:10 2017 +0200

Includes proper file
---
 source/tag-developers/ajax-head-template.md | 6 +-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/source/tag-developers/ajax-head-template.md 
b/source/tag-developers/ajax-head-template.md
index 3686080..14f2a97 100644
--- a/source/tag-developers/ajax-head-template.md
+++ b/source/tag-developers/ajax-head-template.md
@@ -10,7 +10,11 @@ JavaScript includes for the [Dojo 
Toolkit](http://dojotoolkit.org), which is use
 [ajax div template](ajax-div-template.html), and the [ajax tabbedPanel 
template](). It is required to use this tag, 
 `` , in your HTML `` block if you wish to use 
AJAX feature. The contents of **head.ftl** are:
 
-{% tag_attributes ajax/head.ftl %}
+{% tag_parameters  %}
+
+{% highlight html %}
+{% remote_file_content 
https://raw.githubusercontent.com/apache/struts/support-2-3/plugins/dojo/src/main/resources/template/ajax/head.ftl
 %}
+{% endhighlight %}
 
 > If you are having trouble getting the AJAX theme to work, you should include 
 > the above JavaScript in your page manually, 
 > changing "isDebug: false" to "isDebug: true".  This will log out debugging 
 > information directly to the screen.

-- 
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" '].


[struts-site] branch master updated: Drops unused tag

2017-09-24 Thread lukaszlenart
This is an automated email from the ASF dual-hosted git repository.

lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/master by this push:
 new e98d095  Drops unused tag
e98d095 is described below

commit e98d095d706574079f15e124002743381a81ce5c
Author: Lukasz Lenart 
AuthorDate: Sun Sep 24 21:13:26 2017 +0200

Drops unused tag
---
 source/tag-developers/ajax-head-template.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/source/tag-developers/ajax-head-template.md 
b/source/tag-developers/ajax-head-template.md
index 14f2a97..96e48ed 100644
--- a/source/tag-developers/ajax-head-template.md
+++ b/source/tag-developers/ajax-head-template.md
@@ -10,8 +10,6 @@ JavaScript includes for the [Dojo 
Toolkit](http://dojotoolkit.org), which is use
 [ajax div template](ajax-div-template.html), and the [ajax tabbedPanel 
template](). It is required to use this tag, 
 `` , in your HTML `` block if you wish to use 
AJAX feature. The contents of **head.ftl** are:
 
-{% tag_parameters  %}
-
 {% highlight html %}
 {% remote_file_content 
https://raw.githubusercontent.com/apache/struts/support-2-3/plugins/dojo/src/main/resources/template/ajax/head.ftl
 %}
 {% endhighlight %}

-- 
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" '].


[struts-site] branch asf-site updated: Updates production by Jenkins

2017-09-24 Thread git-site-role
This is an automated email from the ASF dual-hosted git repository.

git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
 new b40c492  Updates production by Jenkins
b40c492 is described below

commit b40c492af553566afc3a1fa5a03197866df708c5
Author: jenkins 
AuthorDate: Sun Sep 24 19:14:22 2017 +

Updates production by Jenkins
---
 .../{simple-theme.html => ajax-a-template.html}|  51 +-
 content/tag-developers/ajax-div-template.html  | 344 +++
 .../{simple-theme.html => ajax-event-system.html}  |  55 +-
 content/tag-developers/ajax-head-template.html | 286 +
 content/tag-developers/ajax-theme.html | 495 ++-
 content/tag-developers/css-xhtml-theme.html| 405 -
 content/tag-developers/simple-theme.html   |  92 +--
 content/tag-developers/xhtml-theme.html| 673 ++---
 8 files changed, 1499 insertions(+), 902 deletions(-)

diff --git a/content/tag-developers/simple-theme.html 
b/content/tag-developers/ajax-a-template.html
similarity index 81%
copy from content/tag-developers/simple-theme.html
copy to content/tag-developers/ajax-a-template.html
index 16c93ec..7067287 100644
--- a/content/tag-developers/simple-theme.html
+++ b/content/tag-developers/ajax-a-template.html
@@ -125,47 +125,26 @@
 
 
   
-https://github.com/apache/struts-site/edit/master/source/tag-developers/simple-theme.md";
 title="Edit this page on GitHub">Edit on GitHub
-simple theme
+https://github.com/apache/struts-site/edit/master/source/tag-developers/ajax-a-template.md";
 title="Edit this page on GitHub">Edit on GitHub
+ajax a template
 
-The simple theme renders “bare bones” HTML elements. The simple theme is 
most often used as a starting point for other themes. (See Extending Themes for more.)
+The ajax theme is experimental. Feedback is appreciated.
 
-For example, the textfield tag renders the 
HTML
+The ajax a template is used to make asynchronous calls to the server when 
the user clicks on the a href link. It is 
+useful when you need to communicate information back to the application from 
the UI, without requiring the entire page 
+to be re-rendered. An example would be removing an item from a list.
 
-
-
-
-tag without a label, validation, error reporting, or any other formatting 
or functionality.
+The preInvokeJS attribute is used to 
determine whether the URL specified should be called or not, and must contain 
+Javascript that returns true or false. If you want to call a JavaScript 
function, use the format 
+preInvokeJS='yourMethodName(data,type)'. An 
example would be to show a confirm dialog to the user to double check 
+whether they want to remove a user from a list.
 
-
-  
-
-  Both the xhtml theme and css_xhtml theme extend the simple theme. Look to them 
for examples of how to build on the foundation laid by the simple theme.
-
-  
-
-
-
-  
-
-
-  
-
-
-Head Tag
-
-The simple theme head template prints out a 
javascript include required for the datetimepicker 
tag to render properly.
-
-simple head template
-
-The simple themehead 
template only does one thing: it loads the minimal Ajax/Dojo support so that 
tags can import Dojo widgets easily.
-
-The source of the simple head.ftl template is:
-
-{snippet:id=all|lang=xml|url=struts2/core/src/main/resources/template/simple/head.ftl}
-
-
+Remember: the content returned by the href attribute must be JavaScript. That 
JavaScript will then be evaluated 
+within the webpage. If you only wish to publish an event to the topic 
specified, then simply return no result (or NONE) 
+from your action and utilize the notifyTopics attribute to specific the topic 
names.
 
+For an example of the interaction between the div tag and the a 
tag using 
+the topic pub/sub model, see the examples in the ajax div template.
 
   
 
diff --git a/content/tag-developers/ajax-div-template.html 
b/content/tag-developers/ajax-div-template.html
new file mode 100644
index 000..c7bb9ab
--- /dev/null
+++ b/content/tag-developers/ajax-div-template.html
@@ -0,0 +1,344 @@
+
+
+
+  
+  
+  
+  
+  
+
+  Tag Developers Guide (WIP)
+
+  
+  
+  
+  
+  
+
+  
+  
+  
+
+
+
+http://github.com/apache/struts"; class="github-ribbon">
+  https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa.png"; 
alt="Fork me on GitHub">
+
+
+
+  
+
+  
+
+  
+Menu
+Toggle navigation
+
+
+
+  
+  
+
+
+  
+
+  
+Home
+  
+  
+Welcome
+Downloads
+Announcements
+http://www.apache.org/licenses/";>License
+http://apache.org/foundation/thanks.html";>Thanks!
+ 

[struts-site] branch master updated: Uses proper remote file

2017-09-24 Thread lukaszlenart
This is an automated email from the ASF dual-hosted git repository.

lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/master by this push:
 new 6b1bf91  Uses proper remote file
6b1bf91 is described below

commit 6b1bf910f8b336ca2e228af73afe04a4cf9745f1
Author: Lukasz Lenart 
AuthorDate: Sun Sep 24 21:16:57 2017 +0200

Uses proper remote file
---
 source/tag-developers/ajax-head-template.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/tag-developers/ajax-head-template.md 
b/source/tag-developers/ajax-head-template.md
index 96e48ed..f47f07e 100644
--- a/source/tag-developers/ajax-head-template.md
+++ b/source/tag-developers/ajax-head-template.md
@@ -21,7 +21,7 @@ Note that Dojo is configured to use the same character 
encoding specified in `st
 example of how to use the [head](dojo-head-tag.html) tag with the AJAX theme, 
simply do the following in your HTML:
 
 {% highlight html %}
-{% remote_file_content 
https://raw.githubusercontent.com/apache/struts/master/apps/showcase/src/main/webapp/ajax/commonInclude.jsp
 %}
+{% remote_file_content 
https://raw.githubusercontent.com/apache/struts/support-2-3/apps/showcase/src/main/webapp/WEB-INF/ajax/commonInclude.jsp
 %}
 {% endhighlight %}
 
 > The above sample is from Struts trunk; for 2.0.6 you should use ` debug="true"/>`.

-- 
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" '].


[struts-site] branch asf-site updated: Updates production by Jenkins

2017-09-24 Thread git-site-role
This is an automated email from the ASF dual-hosted git repository.

git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
 new 628893c  Updates production by Jenkins
628893c is described below

commit 628893c3e414c536f2cb8f7fa3a7b2acee06df50
Author: jenkins 
AuthorDate: Sun Sep 24 19:18:18 2017 +

Updates production by Jenkins
---
 content/tag-developers/ajax-head-template.html | 6 +-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/content/tag-developers/ajax-head-template.html 
b/content/tag-developers/ajax-head-template.html
index b335ac5..7029c47 100644
--- a/content/tag-developers/ajax-head-template.html
+++ b/content/tag-developers/ajax-head-template.html
@@ -223,7 +223,11 @@ changing “isDebug: false” to “isDebug: true”.  This will 
log out debuggi
 Note that Dojo is configured to use the same character encoding specified 
in struts.xml , typically UTF-8. For a 
simple 
 example of how to use the head tag with the 
AJAX theme, simply do the following in your HTML:
 
-404: Not Found
+<%@ taglib prefix="s" 
uri="/struts-tags" %>
+<%@ taglib prefix="sx" uri="/struts-dojo-tags" 
%>
+
+
+
 
 
   The above sample is from Struts trunk; for 2.0.6 you should use .

-- 
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" '].


[struts-site] branch master updated: Allows define custom breadcrumbs per page

2017-09-24 Thread lukaszlenart
This is an automated email from the ASF dual-hosted git repository.

lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/master by this push:
 new d4dc803  Allows define custom breadcrumbs per page
d4dc803 is described below

commit d4dc803e546a0576d83771fb362cf8581d3af6f8
Author: Lukasz Lenart 
AuthorDate: Sun Sep 24 21:26:01 2017 +0200

Allows define custom breadcrumbs per page
---
 source/_layouts/default.html | 3 +++
 source/tag-developers/ajax-theme.md  | 3 +++
 source/tag-developers/css-xhtml-theme.md | 3 +++
 source/tag-developers/simple-theme.md| 3 +++
 source/tag-developers/xhtml-theme.md | 3 +++
 5 files changed, 15 insertions(+)

diff --git a/source/_layouts/default.html b/source/_layouts/default.html
index 696182f..34350bb 100644
--- a/source/_layouts/default.html
+++ b/source/_layouts/default.html
@@ -26,6 +26,9 @@
 
   
 Edit on 
GitHub
+{% if page.parent %}
+<< 
back to {{ page.parent.title }}
+{% endif %}
 {{ content }}
   
 
diff --git a/source/tag-developers/ajax-theme.md 
b/source/tag-developers/ajax-theme.md
index 5b5528e..259d943 100644
--- a/source/tag-developers/ajax-theme.md
+++ b/source/tag-developers/ajax-theme.md
@@ -1,6 +1,9 @@
 ---
 layout: default
 title: Tag Developers Guide (WIP)
+parent:
+  url: themes-and-templates.html
+  title: Themes and Templates
 ---
 
 # ajax theme
diff --git a/source/tag-developers/css-xhtml-theme.md 
b/source/tag-developers/css-xhtml-theme.md
index 3ab52a1..08d75c7 100644
--- a/source/tag-developers/css-xhtml-theme.md
+++ b/source/tag-developers/css-xhtml-theme.md
@@ -1,6 +1,9 @@
 ---
 layout: default
 title: Tag Developers Guide (WIP)
+parent:
+  url: themes-and-templates.html
+  title: Themes and Templates
 ---
 
 # css_xhtml theme
diff --git a/source/tag-developers/simple-theme.md 
b/source/tag-developers/simple-theme.md
index e7e756b..4cb1433 100644
--- a/source/tag-developers/simple-theme.md
+++ b/source/tag-developers/simple-theme.md
@@ -1,6 +1,9 @@
 ---
 layout: default
 title: Tag Developers Guide (WIP)
+parent:
+  url: themes-and-templates.html
+  title: Themes and Templates
 ---
 
 # simple theme
diff --git a/source/tag-developers/xhtml-theme.md 
b/source/tag-developers/xhtml-theme.md
index 071beb3..ceb5c2b 100644
--- a/source/tag-developers/xhtml-theme.md
+++ b/source/tag-developers/xhtml-theme.md
@@ -1,6 +1,9 @@
 ---
 layout: default
 title: Tag Developers Guide (WIP)
+parent:
+  url: themes-and-templates.html
+  title: Themes and Templates
 ---
 
 # xhtml theme

-- 
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" '].


[struts-site] branch asf-site updated: Updates production by Jenkins

2017-09-24 Thread git-site-role
This is an automated email from the ASF dual-hosted git repository.

git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/struts-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
 new 71f0eaf  Updates production by Jenkins
71f0eaf is described below

commit 71f0eafe65fef89e888e485eb3d6150e868ca298
Author: jenkins 
AuthorDate: Sun Sep 24 19:26:55 2017 +

Updates production by Jenkins
---
 content/announce-2002.html | 1 +
 content/announce-2003.html | 1 +
 content/announce-2004.html | 1 +
 content/announce-2005.html | 1 +
 content/announce-2006.html | 1 +
 content/announce-2007.html | 1 +
 content/announce-2008.html | 1 +
 content/announce-2009.html | 1 +
 content/announce-2010.html | 1 +
 content/announce-2011.html | 1 +
 content/announce-2012.html | 1 +
 content/announce-2013.html | 1 +
 content/announce-2014.html | 1 +
 content/announce-2015.html | 1 +
 content/announce-2016.html | 1 +
 content/announce.html  | 1 +
 content/birdseye.html  | 1 +
 content/builds.html| 1 +
 content/bylaws.html| 1 +
 content/coding-standards.html  | 1 +
 content/core-developers/index.html | 1 +
 content/dev-mail.html  | 1 +
 content/download.html  | 1 +
 content/downloads.html | 1 +
 content/getting-started/index.html | 1 +
 content/helping.html   | 1 +
 content/kickstart.html | 1 +
 content/mail.html  | 1 +
 content/maven-archetypes/index.html| 1 +
 content/plugins/convention/converting.html | 1 +
 content/plugins/index.html | 1 +
 content/plugins/plugin-developers.html | 1 +
 content/primer.html| 1 +
 content/releases.html  | 1 +
 content/security.html  | 1 +
 content/security/index.html| 1 +
 content/struts1eol-announcement.html   | 1 +
 content/struts1eol-press.html  | 1 +
 content/submitting-patches.html| 1 +
 content/tag-developers/a-tag.html  | 1 +
 content/tag-developers/access-to-valuestack-from-jsps.html | 1 +
 content/tag-developers/action-tag.html | 1 +
 content/tag-developers/actionerror-tag.html| 1 +
 content/tag-developers/actionmessage-tag.html  | 1 +
 content/tag-developers/ajax-a-template.html| 1 +
 content/tag-developers/ajax-and-javascript-recipes.html| 1 +
 content/tag-developers/ajax-common-header.html | 1 +
 content/tag-developers/ajax-div-template.html  | 1 +
 content/tag-developers/ajax-event-system.html  | 1 +
 content/tag-developers/ajax-head-template.html | 1 +
 content/tag-developers/ajax-tags.html  | 1 +
 content/tag-developers/ajax-theme.html | 3 +++
 content/tag-developers/alt-syntax.html | 1 +
 content/tag-developers/append-tag.html | 1 +
 content/tag-developers/bean-tag.html   | 1 +
 content/tag-developers/cewolf-charts-using-velocity-templates.html | 1 +
 content/tag-developers/checkbox-tag.html   | 1 +
 content/tag-developers/checkboxlist-tag.html   | 1 +
 content/tag-developers/combobox-tag.html   | 1 +
 content/tag-developers/component-tag.html  | 1 +
 content/tag-developers/css-xhtml-theme.html| 3 +++