Author: chris.laprun(a)jboss.com Date: 2007-10-12 17:06:39 -0400 (Fri, 12 Oct 2007) New Revision: 8623 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml docs/trunk/referenceGuide/en/modules/tutorials.xml Log: - Minor content improvements. Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2007-10-12 14:55:57 UTC (rev 8622) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2007-10-12 21:06:39 UTC (rev 8623) @@ -282,11 +282,11 @@ </instance> </deployment> </deployments>]]></programlisting> - This is a JBoss Portal specific descriptor that allows you create an instance of a portlet. The + This is a JBoss Portal specific descriptor that allows you to create instances of portlets. The <literal>portlet-ref</literal> value must match the <literal>portlet-name</literal> value given in the packaged <literal>portlet.xml</literal>. The <literal>instance-id</literal> - value can be named anything, but it must match the <literal>instance-ref</literal> value given - in the <literal>*-object.xml</literal> file we will explore below. + value can be named anything, but it must match <literal>instance-ref</literal> values given + in <literal>*-object.xml</literal> files as we shall below. </para> </listitem> <listitem> @@ -309,7 +309,7 @@ </deployments>]]></programlisting> <literal>*-object.xml</literal> files are JBoss Portal specific descriptors and allow users to - define the structure of their portal instances as well as create/configure thier windows and + define the structure of their portal instances as well as create/configure their windows and pages. In our example, we create a portlet window, specify that it will display the markup generated by the <literal>HelloWorldPortletInstance</literal> portlet instance, assign it to the <literal>default.default</literal> page, and specify where it should appear on that page. @@ -343,8 +343,8 @@ <listitem> <para> <programlisting><![CDATA[<instance-ref>HelloWorldPortletInstance</instance-ref>]]></programlisting> - The value of <literal>instance-ref</literal> must match the value of - <literal>instance-id</literal> found in the <literal>portlet-instances.xml</literal>. + The value of <literal>instance-ref</literal> must match the value of one of the + <literal>instance-id</literal> found in <literal>portlet-instances.xml</literal>. </para> </listitem> <listitem> Modified: docs/trunk/referenceGuide/en/modules/tutorials.xml =================================================================== --- docs/trunk/referenceGuide/en/modules/tutorials.xml 2007-10-12 14:55:57 UTC (rev 8622) +++ docs/trunk/referenceGuide/en/modules/tutorials.xml 2007-10-12 21:06:39 UTC (rev 8623) @@ -246,7 +246,7 @@ portlet supports in the <literal>render</literal> method. This is accomplish via the <literal>mime-type</literal> element, which is <emphasis>required</emphasis> for every portlet. Of course, the declared MIME types must match the capability of the portlet. - + It also allows you to pair which modes and window states are supported for each markup type. In out case, as all portlets must support the VIEW portlet mode, we didn't have to declare it. We did need @@ -282,11 +282,11 @@ </instance> </deployment> </deployments>]]></programlisting> - This is a JBoss Portal specific descriptor that allows you create an instance of a portlet. The + This is a JBoss Portal specific descriptor that allows you to create instances of portlets. The <literal>portlet-ref</literal> value must match the <literal>portlet-name</literal> value given in the packaged <literal>portlet.xml</literal>. The <literal>instance-id</literal> - value can be named anything, but it must match the <literal>instance-ref</literal> value given - in the <literal>*-object.xml</literal> file we will explore below. + value can be named anything, but it must match <literal>instance-ref</literal> values given + in <literal>*-object.xml</literal> files as we shall below. </para> </listitem> <listitem> @@ -309,11 +309,11 @@ </deployments>]]></programlisting> <literal>*-object.xml</literal> files are JBoss Portal specific descriptors and allow users to - define the structure of their portal instances as well as create/configure thier windows and + define the structure of their portal instances as well as create/configure their windows and pages. In our example, we create a portlet window, specify that it will display the markup - generated by the <literal>HelloWorldPortletInstance</literal> portlet instance, assign it to the + generated by the <literal>HelloWorldPortletInstance</literal> portlet instance, assign it to the <literal>default.default</literal> page, and specify where it should appear on that page. - + <itemizedlist> <listitem> <para> @@ -343,8 +343,8 @@ <listitem> <para> <programlisting><![CDATA[<instance-ref>HelloWorldPortletInstance</instance-ref>]]></programlisting> - The value of <literal>instance-ref</literal> must match the value of - <literal>instance-id</literal> found in the <literal>portlet-instances.xml</literal>. + The value of <literal>instance-ref</literal> must match the value of one of the + <literal>instance-id</literal> found in <literal>portlet-instances.xml</literal>. </para> </listitem> <listitem> @@ -368,7 +368,7 @@ </imageobject> </mediaobject> </para> - + <para> Portal 2.6 introduces the notion of <emphasis>content type</emphasis>, which is a generic mechanism to specify which content will be displayed by a given portlet window. The <literal>window</literal> section @@ -438,7 +438,7 @@ easily modify the XML descriptors, resources files, JSF/JSP pages. A simple <literal>touch</literal> operation (or equivalent) on the <literal>web.xml</literal> file will let any live JBoss Application Server instance know that it needs to hot-redeploy your web application. - </para> + </para> </sect3> <sect3> <title>Deploying your portlet</title> @@ -612,7 +612,7 @@ </listitem> </itemizedlist> </para> - </sect3> + </sect3> <sect3> <title>JSP files and the portlet taglib</title> <para> @@ -709,7 +709,7 @@ </imageobject> </mediaobject> </para> - </sect3> + </sect3> </sect2> <sect2 id="sunri_42x"> <title>A simple Sun's JSF Reference Implementation (RI) portlet on JBoss AS 4.2.x</title> @@ -720,7 +720,7 @@ from PortletSwap.com, using this link: <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_6/bundles...;. </para> - </sect3> + </sect3> <sect3> <title>Package Content</title> <para> @@ -847,7 +847,7 @@ </para> </listitem> <listitem> - <para><literal>jsf-portlet.jar</literal> This library that can be downloaded here: <ulink url="https://jsfportletbridge.dev.java.net/servlets/ProjectDocumentL... + <para><literal>jsf-portlet.jar</literal> This library that can be downloaded here: <ulink url="https://jsfportletbridge.dev.java.net/servlets/ProjectDocumentL... contains the classes for the JSF-Portlet bridge. Since they are not included with the JSF implementation (unlike myfaces) neither in JBoss AS, it is required to have this library available in the package.</para> @@ -855,7 +855,7 @@ </itemizedlist> </para> </sect3> - <!-- + <!-- <sect3> <title>JSP files</title> <para>TODO!!</para> @@ -868,7 +868,7 @@ <literal>helloworldjspportlet.war</literal> file in a way similar to what we saw in <xref linkend="first_portlet_build"/>. </para> - <!-- + <!-- <para> The <literal>explode</literal> target will produce the following: <mediaobject> @@ -888,7 +888,7 @@ </imageobject> </mediaobject> </para> - </sect3> + </sect3> </sect2> <sect2 id="myfaces_40x"> <title>A simple MyFaces JSF Portlet on JBoss AS 4.0.5+</title> @@ -899,7 +899,7 @@ from PortletSwap.com, using this link: <ulink url="http://anonsvn.jboss.org/repos/portletswap/portlets/2_6/bundles...;. </para> - </sect3> + </sect3> <sect3> <title>Package Content</title> <para> @@ -1005,7 +1005,7 @@ </itemizedlist> </para> </sect3> - <!-- + <!-- <sect3> <title>JSP files</title> <para>TODO!!</para> @@ -1018,7 +1018,7 @@ <literal>helloworldjsfportlet.war</literal> file in a way similar to what we saw in <xref linkend="first_portlet_build"/>. </para> - <!-- + <!-- <para> The <literal>explode</literal> target will produce the following: <mediaobject> @@ -1038,7 +1038,7 @@ </imageobject> </mediaobject> </para> - </sect3> + </sect3> </sect2> <sect2> <title>Adapting MyFaces JSF Portlet to work on JBoss AS 4.2.x</title>