taylor 2004/04/08 17:26:18
Modified: tutorial/xdocs/1 index.xml
tutorial/xdocs navigation.xml
Added: tutorial/xdocs/1 bottomnav.xml deploy.xml topnav.xml
leftnav.xml skins.xml
tutorial/xdocs/images image001.gif
Log:
chapter one of the tutorial converted to xdocs
PR:
Obtained from:
Submitted by:
Reviewed by:
CVS: ----------------------------------------------------------------------
CVS: PR:
CVS: If this change addresses a PR in the problem report tracking
CVS: database, then enter the PR number(s) here.
CVS: Obtained from:
CVS: If this change has been taken from another system, such as NCSA,
CVS: then name the system in this line, otherwise delete it.
CVS: Submitted by:
CVS: If this code has been contributed to Apache by someone else; i.e.,
CVS: they sent us a patch or a new module, then include their name/email
CVS: address here. If this is your work then delete this line.
CVS: Reviewed by:
CVS: If we are doing pre-commit code reviews and someone else has
CVS: reviewed your changes, include their name(s) here.
CVS: If you have not had it reviewed then delete this line.
Revision Changes Path
1.3 +3 -4 jakarta-jetspeed/tutorial/xdocs/1/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/tutorial/xdocs/1/index.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- index.xml 8 Apr 2004 18:13:45 -0000 1.2
+++ index.xml 9 Apr 2004 00:26:18 -0000 1.3
@@ -38,10 +38,9 @@
<li>2. <a href='topnav.html'>Modify the Top Navigation</a></li>
<li>3. <a href='leftnav.html'>Remove the Left Navigation</a></li>
<li>4. <a href='bottomnav.html'>Replace the Bottom Navigation</a></li>
-<li>5. <a href='title.html'>Change the Web Page Title</a></li>
-<li>6. <a href='skins.html'>Change the Skin, CSS</a></li>
-<li>7. <a href='merge.html'>How Property Merging Works in the Tutorial</a></li>
-<li>8. <a href='deploy.html'></a>Deploy</li>
+<li>5. <a href='skins.html'>Change the Skin, CSS</a></li>
+<li>6. <a href='merge.html'>How Property Merging Works in the Tutorial</a></li>
+<li>7. <a href='deploy.html'></a>Deploy</li>
</ul>
</p>
<p>
1.1 jakarta-jetspeed/tutorial/xdocs/1/bottomnav.xml
Index: bottomnav.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="[EMAIL PROTECTED]">David Sean Taylor</author>
<title>Change the Portal Bottom Navigation</title>
</properties>
<body>
<section name="Change the Portal Bottom Navigation">
<p>
Next we show how to replace the bottom navigation.
</p>
<source>
bottomnav.enable=true
bottomnav.vm=bottom-jportal.vm
</source>
<p>
<b>bottomnav.enable</b> turns on or off the bottom navigation.
</p>
<p>
<b>bottomnav.vm</b> -- You can use your own JSP or Velocity template here to
completely customize your bottom navigation.
That is exactly what we do here using a Velocity template tailored specifically for
the JPortal tutorial.
</p>
<source>
<![CDATA[
<br/>
<hr/>
<table width="100%">
<tr>
<td align="left">
<small>
JPortal Tutorial for Jetspeed - Version 1.4b4<br/>
</small>
</td>
#if ($config.getString("mail.support"))
<td align="center">
<a href="mailto:$config.getString("mail.support")">Support and Additional
Information</a>
</td>
#end
<td align="right">
<a href="http://www.bluesunrise.com";>
<img align="right" alt="Bluesunrise" border="0"
src="$clink.setURI("images/PoweredBS.gif")">
</a>
</td>
</tr>
</table>
]]>
</source>
</section>
</body>
</document>
1.1 jakarta-jetspeed/tutorial/xdocs/1/deploy.xml
Index: deploy.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="[EMAIL PROTECTED]">David Sean Taylor</author>
<title>Deploy</title>
</properties>
<body>
<section name="Deploy">
<p>
To deploy the system type:
</p>
<source>
maven deploy
-- or --
maven hotdeploy
</source>
<p>
Use hotdeploy if you have already deployed the system once.
This simply saves some time in packaging the JPortal deployment.
Next point your browser at:
</p>
<p>
<a
href='http://localhost:8080/jportal/portal'>http://localhost:8080/jportal/portal</a>
</p>
<p>
The portlets inside are still the same as the default Jetspeed deployment.
</p>
<p>
<img border='0' width='553' height='249' src="../images/image001.gif"/>
</p>
</section>
</body>
</document>
1.1 jakarta-jetspeed/tutorial/xdocs/1/topnav.xml
Index: topnav.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="[EMAIL PROTECTED]">David Sean Taylor</author>
<title>Change the Portal Top Navigation</title>
</properties>
<body>
<section name="Change the Portal Top Navigation">
<p>
Navigations are carried over from the <a
href='http://jakarta.apache.org/turbine/turbine-2.3/fsd.html#navigation'>Turbine-2</a>
classic web application design.
A website generally has a top and bottom navigation scheme.
This is generally defined as the header and footer of the website.
Jetspeed allows three navigations: top, bottom, and left.
For JPortal, we override navigation properties in <b>JPortalJetspeed.properties</b>.
Here are the top navigation settings:
</p>
<source>
# topnav.enable=true
# topnav.vm=top.vm
# topnav.logo.url=
# topnav.logo.file=images/jportal.gif
# topnav.user_login.enable=true
topnav.user_creation.enable=false
</source>
<p>
<b>topnav.enable</b> turns on or off the top navigation.
Try turning it off. You won't see the logo or login edit fields.
</p>
<p>
We have already described <b>topnav.logo.file</b> and <b>topnav.logo.url</b> in the
previous section.
</p>
<p>
<b>topnav.user_login.enable</b> turns on or off the single sign on edit fields for
entering a username and password.
</p>
<p>
<b>topnav.user_creation.enable</b> turns on or off the link to the Enter New User
portlet.
We will modify the default setting and set it to false.
</p>
<p>
<b>topnav.vm</b> is the most powerful setting.
You can use your own JSP or Velocity template here to completely customize your top
navigation.
</p>
</section>
</body>
</document>
1.1 jakarta-jetspeed/tutorial/xdocs/1/leftnav.xml
Index: leftnav.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="[EMAIL PROTECTED]">David Sean Taylor</author>
<title>Change the Portal Left Navigation</title>
</properties>
<body>
<section name="Change the Portal Left Navigation">
<p>
Next we show how to remove the left navigation.
</p>
<source>
leftnav.enable=false
# leftnav.vm=left.vm
# leftnav.width=10%
</source>
<p>
<b>leftnav.enable</b> turns on or off the left navigation.
The JPortal tutorial site doesn't require a left navigation, so we turn it off.
</p>
<p>
<b>leftnav.vm</b> You can use your own JSP or Velocity template here to customize
your left navigation.
</p>
<p>
<b>lefnav.width</b> specifies the percentage of the page width to be covered by the
left navigation.
</p>
</section>
</body>
</document>
1.1 jakarta-jetspeed/tutorial/xdocs/1/skins.xml
Index: skins.xml
===================================================================
<?xml version="1.0"?>
<!--
Copyright 2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
<properties>
<author email="[EMAIL PROTECTED]">David Sean Taylor</author>
<title>Change the Skin and Cascading Style Sheet</title>
</properties>
<body>
<section name="Change the Skin and Cascading Style Sheet">
<p>
Skins are used to define color, font, and borders for various components in
Jetspeed.
The skin definitions is referenced in portal resources such as controls,
controllers, portlets and
templates to create a centralized design theme.
Review the registry fragment called <b>jportal-skins.xreg</b>,
where we define a new skin to match our really gaudy colour theme for the Jportal
site.
</p>
<source>
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<registry>
<skin-entry name="jportal-skin" hidden="false">
<property name="text-color" value="#ffffff" hidden="false"/>
<property name="background-color" value="#ffffff" hidden="false"/>
<property name="title-text-color" value="#000000" hidden="false"/>
<property name="title-background-color" value="#ceff63"
hidden="false"/>
<property name="title-style-class" value="TitleStyleClass"
hidden="false"/>
<property name="highlight-text-color" value="#ffffff"
hidden="false"/>
<property name="highlight-background-color" value="#6331ff"
hidden="false"/>
</skin-entry>
</registry>
]]>
</source>
<p>
Then in the <b>JPortalJetspeed.properties</b>, the default skin for the portal site
is defined:
</p>
<source>
services.PortalToolkit.default.skin=jportal-skin
</source>
<p>
The default skin is applied to the portal whenever a specific skin is not declared
for a resource.
The default skin facilitates quickly creating a site look and feel with minimal
effort.
</p>
<p>
See the <a href='http://jakarta.apache.org/jetspeed/site/config_skin.html'>Jetspeed
Skin documentation</a>
for all available skin parameters.
</p>
<p>
Skins are used in combination with <a href='http://www.w3.org/Style/CSS/'>Cascading
Style Sheets</a> (CSS).
CSS is a simple mechanism for adding style (e.g. fonts, colors, spacing) to Web
documents,
defined as a standard by the <a href='http://www.w3.org/'>World Wide Web
Consortium</a> (W3C).
</p>
<p>
In the JPortalJetspeed.properties, the portal site stylesheet is defined:
</p>
<source>
site.stylesheet=css/jportal.css
</source>
<p>
Looking at the cascading style sheet for the JPortal site,
we see that the Jetspeed style sheet, <b>default.css</b>,
is included into this style sheet with the import at-rule:
</p>
<source>
<![CDATA[
@import "default.css";
A:link {
text-decoration : none;
color : #333366;
}
A:visited {
text-decoration : none;
color : #666699;
}
A:hover {
color : #CC3300;
}
A.index:link {
font-size : 11px;
color : #333366;
}
A.index:visited {
font-size : 11px;
color : #333366;
}
A.index:hover {
color : #CC3300;
}
]]>
</source>
<p>
We then go on to define several example styles overriding the settings in
default.css.
Styles declared in the style sheet can also be referenced in a skin, as we do in our
skin registry:
</p>
<source>
<![CDATA[
<property name="title-style-class" value="TitleStyleClass"
hidden="false"/>
]]>
</source>
</section>
</body>
</document>
1.7 +1 -2 jakarta-jetspeed/tutorial/xdocs/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/tutorial/xdocs/navigation.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- navigation.xml 8 Apr 2004 23:14:49 -0000 1.6
+++ navigation.xml 9 Apr 2004 00:26:18 -0000 1.7
@@ -41,8 +41,7 @@
<item name="Modify the Top Navigation" href="/1/topnav.html"/>
<item name="Remove the Left Navigation"
href="/1/leftnav.html"/>
<item name="Replace the Bottom Navigation"
href="/1/bottomnav.html"/>
- <item name="Change the Web Page Title" href="/1/title.html"/>
- <item name="Change the Skin and Cascading Style Sheet"
href="/1/skins.html"/>
+ <item name="Change the Skin and CSS" href="/1/skins.html"/>
<item name="Deploy" href='/1/deploy.html'/>
</menu>
1.1 jakarta-jetspeed/tutorial/xdocs/images/image001.gif
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
