Author: smukhina Date: 2008-10-31 12:23:18 -0400 (Fri, 31 Oct 2008) New Revision: 11431 Modified: branches/jbosstools-3.0.0.Beta1/birt/docs/en/master.xml branches/jbosstools-3.0.0.Beta1/birt/docs/en/modules/birt_designer.xml branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/images/editors_features/editors_features_2.png branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/images/editors_features/editors_features_6.png branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/images/visual_page/visual_page_7.png branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/modules/editors.xml branches/jbosstools-3.0.0.Beta1/portlet/docs/reference/en/modules/portlets_support.xml branches/jbosstools-3.0.0.Beta1/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml Log: https://jira.jboss.org/jira/browse/JBDS-463 chapters area updated. master.xml schema is updated Modified: branches/jbosstools-3.0.0.Beta1/birt/docs/en/master.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/birt/docs/en/master.xml 2008-10-31 16:15:59 UTC (rev 11430) +++ branches/jbosstools-3.0.0.Beta1/birt/docs/en/master.xml 2008-10-31 16:23:18 UTC (rev 11431) @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" -"?http://www.docbook.org/xsd/4.3/docbook.xsd" +"http://www.docbook.org/xml/4.3/docbookx.dtd" [ <!ENTITY introduction SYSTEM "modules/introduction.xml"> Modified: branches/jbosstools-3.0.0.Beta1/birt/docs/en/modules/birt_designer.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/birt/docs/en/modules/birt_designer.xml 2008-10-31 16:15:59 UTC (rev 11430) +++ branches/jbosstools-3.0.0.Beta1/birt/docs/en/modules/birt_designer.xml 2008-10-31 16:23:18 UTC (rev 11431) @@ -29,13 +29,13 @@ <para>The next part of user interface is different <property>Views</property> that can be arranged around the Layout Editor area the way you like:</para> <itemizedlist> - <listitem><para><emphasis role="bold">Palette</emphasis> - BIRT View that shows the standard report items you can add to your report using drag and drop.</para></listitem> - <listitem><para><emphasis role="bold">Outline</emphasis> - BIRT View that shows the structure of your report as a tree view.</para></listitem> - <listitem><para><emphasis role="bold">Navigator</emphasis> - Standard Eclipse view that shows your projects, and the reports within your projects.</para></listitem> - <listitem><para><emphasis role="bold">Data Explorer</emphasis> - BIRT View that shows your data sources (connections), data sets (queries) and report parameters. You also use this view to add data set columns to your report layout.</para></listitem> - <listitem><para><emphasis role="bold">Property Editor</emphasis> - BIRT View that displays properties for many report items. It has tabs and groupings that organize properties into categories.</para></listitem> - <listitem><para><emphasis role="bold">Properties View</emphasis> - Standard Eclipse view that shows all properties for a report item as a simple list. This view is optional, and we will not use it in this tutorial.</para></listitem> - <listitem><para><emphasis role="bold">Library Explorer View</emphasis> - BIRT allows the reuse of report objects, such as tables, data sources and styles. Objects created for reuse are stored in a library file. The Library Explorer will display Libraries that exist in the resource folder. Developed libraries can be added to the resource folder by selecting File→Publish Library to Resource Folder or by right clicking in Library Explorer and selecting add. The resource folder location can be configured. </para></listitem> + <listitem><para><emphasis role="bold">Palette</emphasis> - shows the standard report items you can add to your report using drag and drop.</para></listitem> + <listitem><para><emphasis role="bold">Outline</emphasis> - shows the structure of your report as a tree view.</para></listitem> + <listitem><para><emphasis role="bold">Navigator</emphasis> - shows your projects and reports within the projects.</para></listitem> + <listitem><para><emphasis role="bold">Data Explorer</emphasis> - shows your data sources, data sets and report parameters. You also can use this view to add data set columns to your report layout.</para></listitem> + <listitem><para><emphasis role="bold">Property Editor</emphasis> - displays properties for many report items.</para></listitem> + <listitem><para><emphasis role="bold">Properties View</emphasis> - shows all properties for a report item as a simple list.</para></listitem> + <listitem><para><emphasis role="bold">Library Explorer View</emphasis> - allows the reuse of report objects, such as tables, data sources and styles. Objects created for reuse are stored in a library file. The Library Explorer will display Libraries that exist in the Resource folder. Developed libraries can be added to the resource folder by selecting <emphasis>File→Publish Library in Resource Folder</emphasis>. The resource folder location can be configured. </para></listitem> @@ -60,23 +60,14 @@ <listitem><para><emphasis role="bold">Report Preview</emphasis> - Report Preview is used to test your newly created report with some real data.</para></listitem> <listitem><para><emphasis role="bold">Chart Builder</emphasis> - using the Chart Builder you can add any charts to the design of your report. Just select a chart type, then data and, finally, format the chart.</para></listitem> <listitem><para><emphasis role="bold">Expression Builder </emphasis> - expressions are simple scripts that return a value. They are used to assign data values to report elements, build image locations, hyperlinks, parameter default values etc.</para></listitem> - <listitem><para><emphasis role="bold">Cheat Sheets</emphasis> - Cheat sheets are small pices of useful dosumentation that lead you through a report creation process. Just select when you need and then follow the instructions.</para></listitem> + <listitem><para><emphasis role="bold">Cheat Sheets</emphasis> - Cheat sheets are small pices of useful documentation that lead you through a report creation process. Just select what you need and then follow the instructions.</para></listitem> <listitem><para><emphasis role="bold">Outline</emphasis> - this view provides a compact overview of the entire report structure.</para></listitem> </itemizedlist> - <para>There are a number of ways we can improve the report's appearance: </para> - - <itemizedlist> - <listitem><para>Add a title to the top of the report;</para></listitem> - <listitem><para> Add a title to the top of the report. </para></listitem> - <listitem><para> Add some color to enhance the column headings. </para></listitem> - <listitem><para> Shrink the size of the city and state columns. </para></listitem> - <listitem><para>Add some color to make the state and city group headers stand out. </para></listitem> - <listitem><para>Format the phone numbers. </para></listitem> - <listitem><para>Sort customers by name.</para></listitem> - </itemizedlist> </section> + + <para>In this guide we made a simple overview of the BIRT plugin: its installation, support, features etc. that will help you to make your first steps with it.</para> </chapter> Modified: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/images/editors_features/editors_features_2.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/images/editors_features/editors_features_6.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/images/visual_page/visual_page_7.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/modules/editors.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/modules/editors.xml 2008-10-31 16:15:59 UTC (rev 11430) +++ branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/modules/editors.xml 2008-10-31 16:23:18 UTC (rev 11431) @@ -839,13 +839,22 @@ <para>When working in JBoss Tools JSP editor you are constantly provided with feedback and contextual error checking as you type.</para> </section> + </section> + <section id="pages_styling"> + <title>Pages Styling</title> + + <para>Most web pages use the cascading style sheets (CSS) to control the way they look. + With <property>Visual Page Editor</property> you can easily stylise your pages. In + this section we are going to introduce you to a powerful mechanism that <property>VPE</property> provides for + a complete control over pages styling. </para> + <section id="inline_styling"> <title>Inline Style Editing</title> - <para>In the Visual part of the VPE there is a graphical toolbar, use it to add - inline styling to JSF and Struts tags on your page. The toolbar can be hidden by - clicking on arrow sign in the upper left corner.</para> + <para>In the Visual part of the <property>VPE</property> there is a graphical + toolbar, use it to add inline styling to JSF and Struts tags on your page. The + toolbar can be hidden by clicking on arrow sign in the upper left corner.</para> <figure> <title>Text Formatting</title> @@ -856,8 +865,8 @@ </mediaobject> </figure> - <para>For editing inline styles for DOM elements VPE also provides <property>CSS - Dialog</property>. It can be called from <emphasis> + <para>For editing inline styles for DOM elements <property>VPE</property> also + provides <property>CSS Dialog</property>. It can be called from <emphasis> <property>style</property> </emphasis> line in the <property>Properties view</property> for a currently selected element.</para> @@ -873,7 +882,7 @@ <para id="css_dialog"><property>CSS Dialog</property> has four tabs where css properties for text, background, borders and others can be specified. A simple - preview which is generated at the bottom of the <property>CSS Dialog</property> + preview which is generated at the top of the <property>CSS Dialog</property> allows you to see the changes before you apply them.</para> <figure> @@ -886,68 +895,167 @@ </figure> </section> - <section id="vpe_templating"> - <title>Templating</title> + <section id="external_stylesheets"> + <title>External Stylesheets</title> + <para>The pages you are working with in <property>VPE</property> can use external + stylesheets. <property>VPE</property> allows you to create new style classes in + existing stylesheets and/or edit them as well. For these purposes <property>CSS + Style Class Dialog</property> is provided.</para> + <para>Select the element for which you need to create or edit style class and press + button next to <emphasis> + <property>styleClass</property> + </emphasis> field in <property>Properties view</property>.</para> - <para>The VPE also makes it possible to create templates for unknown tags.</para> + <figure> + <title>Calling the CSS Style Class Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_17.png"/> + </imageobject> + </mediaobject> + </figure> - <para>To call the <property>Template dialog</property> for a tag, right-click on it - in Visual mode and select <emphasis> - <property>Template</property> - </emphasis> option.</para> - + <para>It&apos;ll pick up the <property>CSS Style Class Dialog</property> which + looks like on the figure below.</para> <figure> - <title>Calling Template Dialog</title> + <title>CSS Style Class Dialog</title> <mediaobject> <imageobject> - <imagedata fileref="images/visual_page/visual_page_7a.png"/> + <imagedata fileref="images/visual_page/visual_page_18.png"/> </imageobject> </mediaobject> </figure> + <para>First, you should specify the CSS file where you are going to put your style + class. Do this by pressing button next to the <emphasis> + <property>CSS file</property> + </emphasis> field.</para> + <figure> + <title>CSS File Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_19.png"/> + </imageobject> + </mediaobject> + </figure> - <para id="template_dialog">Here is what the <property>Template dialog</property> looks like.</para> - + <para>To create new CSS class write its name in the <emphasis> + <property>Style class</property> + </emphasis> field and then configure style settings switching between the tabs: <emphasis> + <property>Text/Font</property>, </emphasis> + <emphasis> + <property>Background</property>, </emphasis> + <emphasis> + <property>Boxes</property>, </emphasis> + <emphasis> + <property>Property Sheet</property>. </emphasis>To add existing styling to + the chosen element expand the list of the existed style classes and point to the + necessary one.</para> + <figure> - <title>Template Dialog</title> + <title>Style Class Selection</title> <mediaobject> <imageobject> - <imagedata fileref="images/visual_page/visual_page_7b.png"/> + <imagedata fileref="images/visual_page/visual_page_20.png"/> </imageobject> </mediaobject> </figure> - + <para><emphasis> - <property>Tag for Display</property> - </emphasis> field in the <property>Template dialog</property> requires - specifying a type of tag. It can be SPAN, DIV, TABLE or any other html element. - Here it&apos;s also possible to mark weather the tag is children or not (by checking <emphasis> - <property>Children</property></emphasis>), whether it contains an IMG tag (by checking <emphasis> - <property>Icon</property></emphasis>) and - specify a value for it.</para> + <property>Quick Edit</property> + </emphasis> gives a preview of the properties which are set for the existing + style class. You can easily modify them with the help of this wizard.</para> - <para>What comes to the <emphasis> - <property>Style</property></emphasis> field, you can fill it out manually or make use of the button - next to the field to bring the <link linkend="css_dialog">CSS Dialog</link> for - editing styles.</para> + <figure> + <title>Quick Edit</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_21.png"/> + </imageobject> + </mediaobject> + </figure> - <para>You can observe all defined templates in the <link linkend="VisualPageEditor2" - >VPE Preferences</link> on the Templates tab which you can quickly access by - pressing <link linkend="AdvancedSettings954">Preferences button</link>.</para> + <para>Preview at the top of the <property>CSS Style Class Dialog</property> + visualizes the result.</para> + + <para>The dialog for creating a new CSS class, which is called from <emphasis> + <property>New > Other... > JBoss Tools Web > CSS Class</property>, + </emphasis> looks the same.</para> <figure> - <title>Templates Tab of the VPE Preferences Page</title> + <title>New CSS Class Dialog</title> <mediaobject> <imageobject> - <imagedata fileref="images/visual_page/visual_page_7c.png"/> + <imagedata fileref="images/visual_page/visual_page_22.png"/> </imageobject> </mediaobject> </figure> - - <para>Here it&apos;s possible to edit or remove any listed in the table template.</para> - </section> </section> + <section id="vpe_templating"> + <title>Templating</title> + + <para>The VPE also makes it possible to create templates for unknown tags.</para> + + <para>To call the <property>Template dialog</property> for a tag, right-click on it in + Visual mode and select <emphasis> + <property>Template</property> + </emphasis> option.</para> + + <figure> + <title>Calling Template Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7a.png"/> + </imageobject> + </mediaobject> + </figure> + + <para id="template_dialog">Here is what the <property>Template dialog</property> looks + like.</para> + + <figure> + <title>Template Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7b.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><emphasis> + <property>Tag for Display</property> + </emphasis> field in the <property>Template dialog</property> requires specifying a + type of tag. It can be SPAN, DIV, TABLE or any other html element. Here + it&apos;s also possible to mark weather the tag is children or not (by checking <emphasis> + <property>Children</property> + </emphasis>), whether it contains an IMG tag (by checking <emphasis> + <property>Icon</property> + </emphasis>) and specify a value for it.</para> + + <para>What comes to the <emphasis> + <property>Style</property> + </emphasis> field, you can fill it out manually or make use of the button next to + the field to bring the <link linkend="css_dialog">CSS Dialog</link> for editing + styles.</para> + + <para>You can observe all defined templates in the <link linkend="VisualPageEditor2">VPE + Preferences</link> on the Templates tab which you can quickly access by pressing + <link linkend="AdvancedSettings954">Preferences button</link>.</para> + + <figure> + <title>Templates Tab of the VPE Preferences Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7c.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Here it&apos;s possible to edit or remove any listed in the table template.</para> + + </section> + <section id="AdvancedSettings954"> <title>Advanced Settings</title> Modified: branches/jbosstools-3.0.0.Beta1/portlet/docs/reference/en/modules/portlets_support.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/portlet/docs/reference/en/modules/portlets_support.xml 2008-10-31 16:15:59 UTC (rev 11430) +++ branches/jbosstools-3.0.0.Beta1/portlet/docs/reference/en/modules/portlets_support.xml 2008-10-31 16:23:18 UTC (rev 11431) @@ -32,8 +32,8 @@ </mediaobject> </figure> - <para>The wizard fills in The Web Project and Source Folder fields for you. Then you need to specify - the Java package and the Class name and click <emphasis> + <para>The wizard fills in The Web Project and Source Folder fields for you. Then you need to + specify the Java package and the Class name and click <emphasis> <property>Next</property> </emphasis>.</para> @@ -205,9 +205,9 @@ </imageobject> </mediaobject> </figure> - + <para>The JSF Portlet looks in the Browser as follows.</para> - + <figure> <title>JSF Portlet in the Browser Window</title> <mediaobject> @@ -217,4 +217,13 @@ </mediaobject> </figure> </section> + + <para>With this document you&apos;ve learnt how to get started with <property>JBoss + Portal</property> using <property>JBoss Tools</property> suite of Eclipse plugins. The + above chapters walked you through the steps on how to organize a web project with portlets + which includes a sample staff and deploy it onto the <property>JBoss Portal</property>.</para> + + <para>If you still have questions or suggestions you are always welcome on our <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... + >Forum</ulink>. Your feedback will be very much appreciated.</para> </chapter> Modified: branches/jbosstools-3.0.0.Beta1/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml 2008-10-31 16:15:59 UTC (rev 11430) +++ branches/jbosstools-3.0.0.Beta1/struts/docs/struts_tools_ref_guide/en/modules/rel_resources_links.xml 2008-10-31 16:23:18 UTC (rev 11431) @@ -16,4 +16,16 @@ <para>Find out necessary information on <ulink url="http://struts.apache.org/">Struts technology</ulink> if you don&apos;t know enough.</para> + <para>In summary, this reference should help you to get familiar with those parts of + <property>JBoss Tools</property> which are meant for development with Struts + technology. If you&apos;ve carefully gone through the document, you should know + now how to create/import Struts project or enable Struts capabilities for an + existing web project as well as organize and edit all necessary staff for your + Struts application using a set of views and editors provided by <property>JBoss + Tools</property>.</para> + + <para>If you&apos;d like to contribute your feedback is always appreciated. You can + leave your questions and suggestions on our <ulink + url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... + >Forum</ulink>.</para> </chapter>