From jbosstools-commits at lists.jboss.org Mon Mar 31 11:57:13 2008 Content-Type: multipart/mixed; boundary="===============4255016345037426810==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r7213 - in trunk/jsf/docs/userguide/en: modules and 1 other directory. Date: Mon, 31 Mar 2008 11:57:08 -0400 Message-ID: --===============4255016345037426810== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: ykryvinchanka Date: 2008-03-31 11:57:08 -0400 (Mon, 31 Mar 2008) New Revision: 7213 Modified: trunk/jsf/docs/userguide/en/images/palette/palette_15.png trunk/jsf/docs/userguide/en/images/palette/palette_16.png trunk/jsf/docs/userguide/en/images/palette/palette_23.png trunk/jsf/docs/userguide/en/modules/palette.xml Log: http://jira.jboss.com/jira/browse/JBDS-232 New info + screens added in chapt Modified: trunk/jsf/docs/userguide/en/images/palette/palette_15.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/jsf/docs/userguide/en/images/palette/palette_16.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/jsf/docs/userguide/en/images/palette/palette_23.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Modified: trunk/jsf/docs/userguide/en/modules/palette.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/jsf/docs/userguide/en/modules/palette.xml 2008-03-31 15:12:09 UTC= (rev 7212) +++ trunk/jsf/docs/userguide/en/modules/palette.xml 2008-03-31 15:57:08 UTC= (rev 7213) @@ -1,7 +1,6 @@ - Jboss Tools palette @@ -10,11 +9,10 @@ JBoss Tools Palette - This chapter will introdus you to the functionality provide by <= property>JBoss Tools - Palette. Palette allowes you to quickly and easily = creat your JSP or JSF - page. Now you can do it more faster without additional knowlege. + This chapter will introduce you to the functionality provide by = JBoss Tools + Palette. Palette allows you to quickly and easily c= reate your JSP or JSF + page. Now you can do it more faster without additional knowledge.<= /para> The JBoss Tools Palette allows you to: - Insert tags into a JSP or JSF page with one click @@ -23,7 +21,6 @@ Add custom and 3rd party tags - The JBoss Tools Palette contains a developer's project tag libra= ries and provides possibility to add any tag libraries to it. Also you can choose a = necessary one from the list of already existent tag libraries: @@ -53,7 +50,6 @@ XHTML -
JBoss Tools Palette @@ -62,36 +58,30 @@
- - By default the Palette is represented in Web Development Perspec= tive with four groups. If you can't see it, select - Window > Show View Other... > JBoos Tools Web = > JBoss + Window > Show View Other... > JBoss Tools Web = > JBoss Tools Palette from the menu bar. =
Palette Options - To case your work, you can configure the Palette for your ow= n, by selecting the + To ease your work, you can configure the Palette for your ow= n, by selecting the corresponding icon on the Palette toolbar. There is a possibility to configure the JBoss Tools Palette:= - to edit the palette content by= adding, removing or changing the palette elements - to show/hide groups, subgroups= - to import groups, subgroups -
Palette Buttons @@ -100,18 +90,15 @@
-
Palette Editor - JBoss Tools Palette contains existing libraries of tags,= thus the Palette editor is intended to wor= k with them or create your new one, as well. - To open the editor, click right mouse button on the + To open the editor, click on the Palette Editor icon: -
Palette Editor Icon @@ -120,22 +107,21 @@
- The window has two parts. There is a reflected g= rouped list of components on the left side of the palette editor. Each group= is divided into multiple groups, every of which is a tag library. The right= side of the palette editor is an editing window where it's possib= le to change values of - group, tag library attributes that you've cho= sen on the left part - of the window. It can also be made by using + group or tag library attributes that you've c= hosen on the left part + of the window. + It can also be done by right click and using Edit=E2=80=A6 - button. + option. For example, JSF group con= sists of Core, Facelets, HTML tag libraries and the at= tributes as name, description and hidden which are availabl= e for editing: -
Tag Libraries of the JSF Group @@ -144,7 +130,6 @@
- The Palette Editor provides the following possib= ilities when working with existing tags or icons: @@ -174,10 +159,9 @@ wish to remove and chose the Delete Set option from the pop-up menu or cli= ck the - Delet + Delete keyboard button. - to edit icons in the chosen set When the set of icons is created, new icons = can be imported to it. @@ -197,7 +181,6 @@ Finish button. - to work with a group of tag libraries The first step in work with the editor is cr= eating a group of @@ -234,10 +217,8 @@ The removal option is enabled only for c= ustom folders. - to work with a tag library - The group maintains a list of tag libraries.= If you'd like to create your own library, click right mouse but= ton on the group and choose @@ -275,7 +256,6 @@ libraries. - to work with a tag element When the library folder is created, new tags= can be added to it. @@ -302,37 +282,12 @@ End Text for your tag element. If your tag = text is too long, use the Change... - button to see it all. After all th= e attributes are set, - click - Finish - button. - - Note: - If you do not choose the icon it will be= assigned by - default. - - You are allowed to edit or delete the tag . = If you'd like to - change the attributes of the tag or choose ano= ther icon for it, use the - right editing window of the palette editor or = the - Edit... - option from the pop-up menu. In or= der to remove the tag, - right click on the tag that you wish to remove= and chose the - Delete - option or click the - Delete - keyboard button. - - Important: - The removal option is enabled only for c= ustom tags. JBoss Palette - tags can not be removed but can be modifie= d. - - - Parameters of the Palette element are put in= to the table on the right. - Table cells are provided with editors and moda= l dialogue windows for - choosing necessary icons. For 'start text= ' and - 'end text'(or macro) there is a poss= ibility to control - the cursor position by using "|" sym= bol. - + button to see it all. For + start text + and + end text + there is a possibility to control = the cursor position by + using "|" symbol.
Parameters of the Palette element</titl= e> <mediaobject> @@ -342,20 +297,38 @@ </mediaobject> </figure> </listitem> - + <para>After all the attributes are set, click <emphasi= s> + <property>Finish</property> + </emphasis> button.</para> + <note> + <title>Note: + If you do not choose an icon the default one= will be assigned. + + You are allowed to edit or delete the tag . If y= ou'd like to + change the attributes of the tag or choose another= icon for it, use the + right editing window of the palette editor or the = + Edit... + option from the pop-up menu. In order = to remove the tag, right + click on the tag that you wish to remove and chose= the + Delete + option or click the + Delete + keyboard button. + + Important: + The removal option is enabled only for custo= m tags. JBoss Palette tags + can not be removed but can be modified. +
-
Show/Hide - Show/Hide is a very useful feature that allows you to co= ntrol the number of tag groups that are shown on the palette. - Click @@ -363,7 +336,6 @@ button, at the top right side of the J= Boss Tools Palette. -
Show/Hide Button @@ -372,14 +344,12 @@
- In the dialog Show/Hide Drawers check the groups= the libraries of which you want to be shown on the palette: -
Show/Hide Drawers @@ -388,11 +358,10 @@
- If libraries are not displayed in the palette, check whe= ther they are selected. Click the plus sign to expand the libraries of the group a= nd make sure that a tick is put next to the wanted libraries. - @@ -401,7 +370,6 @@ now be shown on the palette: -
New Added Groups @@ -410,43 +378,32 @@
- The name of the elements is compound. The first part is = the group=E2=80=99s name and the second is the library=E2=80=99s name.
-
Import - The Import button lets you add a custom or 3rd party tag= library to JBoss Tools Palette. Find out more information on how to add particula= r tags see the Adding Custom JSF Tags section. - - +
- -
Using the Palette - - -
Inserting Tags into a JSP File - A new tag can be added into any text file including jsp,= htm, html and xhtml. - It's very simple to do this. Open your JSP file and= place the cursor in a - place where you'd like to add a tag and then click th= at tag in the palette. - In the Insert Tag window, that appear= s, you can set the value of + Let's do it. Open your JSP file and place the curso= r in a place where + you'd like to add a tag and then click that tag in th= e palette. In the + Insert Tag window, that appears, = you can set the value of general and advanced attributes of the tag that you chose. -
Inserting Tag @@ -455,11 +412,9 @@
- In the example below, the commandButton tag has been inserted. -
Inserting Tag @@ -476,7 +431,6 @@ "tag" attributes. - The cursor position after adding a tag into a file is sp= ecified by "|" symbol in the tag template on the right in t= he Palette Editor window. @@ -488,11 +442,11 @@
- Above you can see where the cursor position for HTML/Fo= rm/input is set. Thus, - after adding this tag into your file the cursor will be in= the attribute - "type". Then, you can straight use the combinati= on of buttons - Ctrl + Space to inquire about a p= rompting. - + Above you can see where the cursor position for + HTML > Form > input + is set. Thus, after adding this tag into your = file the cursor will be in + the attribute "type". Then, you can straight use= the combination + of buttons Ctrl + Space to inquire ab= out a prompting.
Cursor position @@ -501,9 +455,7 @@
-
-
Adding Custom JSF Tags to the JBoss Tools Palette</titl= e> @@ -518,14 +470,12 @@ <para>The Import button on the JBoss Tools Palette</pa= ra> </listitem> </itemizedlist> - <para>Before you can add your custom component library, you ne= ed to make sure it is included in your project. Either place the <emphasis role= =3D"italic"> <property>".tld"</property> </emphasis> file or the <emphasis role=3D"italic"> <property>".jar"</property> </emphasis> that includes your tag library under the lib f= older in your project. </para> - <section id=3D"Drag_and_Drop65332"> <?dbhtml filename=3D"DragAndDrop.html"?> <title>Drag-and-Drop @@ -533,7 +483,6 @@ view is not active, select Window > Show View > Web Projects from the menu bar. -
Web Projects View @@ -542,16 +491,21 @@
- Also make sure that the JBoss Tools Palette is open.= Select the tag library that you want to add and simply drag-and-drop it on to= the JBoss Tools Palette. - You will see the following dialog window. As you can= see JBoss Developer - Studio takes care of all the details. Chosen TLD file,= name and prefix of the - library and Library URL are detected, thus just need t= o set the Group name to - which you wish to place this tag library. You can eith= er add this tag library to - an existing Group or just create a new one. - + Studio takes care of all the details. Chosen + TLD file + , + name + and + prefix + of the library and + Library URL + are detected, thus just need to set the + Group + name to which you wish to place this tag l= ibrary. You can either add + this tag library to an existing Group or just create a = new one.
Import Tags From TLD File Form @@ -562,7 +516,6 @@
Once you are finished, you will see the new tag libr= ary added to the JBoss Tools Palette. -
JBoss Tools Palette with New Tag Library @@ -572,7 +525,6 @@
-
Import Button @@ -580,7 +532,6 @@ Import button. You can see this button at the top= right side of the JBoss Tools Palette. -
Import Button @@ -589,7 +540,6 @@
- By clicking on the Import button you will see the Import Tag window a simil= ar like in the Browse... button to locate the tag library that you w= ant to add: - -
+
Select TLD File @@ -610,16 +559,11 @@
-
- - -
Rich Faces Support - JBoss Developer Studio comes with a tight integration with <= emphasis> Rich Faces component framework. Rich Faces and Ajax4jsf in JB= oss Tools Palette always @@ -629,10 +573,9 @@ If you'd like to know the last version of Rich = Faces component framework see JBoss RichFaces site. - After installing JBDS Rich Faces components, as well, a= s + Rich Faces components, as well, as Ajax4jsf ones are already on the JBoss Tools Pale= tte: -
Rich Faces Components @@ -641,43 +584,6 @@
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --===============4255016345037426810==--