https://github.com/graceframework/sitemesh-jakarta
Jakarta version for SiteMesh 2.4.x
https://github.com/graceframework/sitemesh-jakarta
Last synced: 4 months ago
JSON representation
Jakarta version for SiteMesh 2.4.x
- Host: GitHub
- URL: https://github.com/graceframework/sitemesh-jakarta
- Owner: graceframework
- License: other
- Created: 2024-03-29T09:35:35.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-29T11:28:06.000Z (almost 2 years ago)
- Last Synced: 2025-07-23T04:10:08.436Z (7 months ago)
- Language: Java
- Size: 17.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.txt
- Changelog: CHANGES.txt
- License: LICENSE.txt
Awesome Lists containing this project
README
*************************************
** OpenSymphony SiteMesh 2.4.2 **
*************************************
SiteMesh is a web-page layout system that can be used to abstract common look
and feel from the functionality of a web-application and to assemble large
webpages from smaller components. Pages and components can have meta-data
extracted from them (such as body, title and meta-tags) which can be used by
decorators (skins) that are applied.
SiteMesh won't tread on your toes or force you to work in a certain way (except
for cleaner) - you install and carry on working as before. It seamlessly fits in
with existing frameworks.
Forget the hype - just try it! You'll be impressed with how it can simplify
things.
--------------------------
-- Obtaining --
--------------------------
The latest version of SiteMesh can be obtained from:
http://www.opensymphony.com/sitemesh/
--------------------------
-- Requirements --
--------------------------
SiteMesh requires a Java Servlet container conforming to the Servlet 2.3
specification. Versions prior to 2.3 are not enough.
Currently known containers that support this and SiteMesh was tested with:
* Orion 1.5.4 and up - http://www.orionserver.com
* Tomcat 4.0, 4.1 and 5.0.19 - http://jakarta.apache.org/tomcat
* Resin 2.1.11, 2.1.12, 2.1.13 and 3.0.7 - http://www.caucho.com
* Oracle OC4J 2 - http://www.oracle.com
* WebLogic 7.0 SP2, 8.1 and 8.1 SP2 - http://www.bea.com
* WebSphere 5.0 - http://www.ibm.com
* Jetty 4.2.20 - http://jetty.mortbay.org
--------------------------
-- Installation --
--------------------------
* Copy sitemesh-@VERSION@.jar to the WEB-INF/lib/ directory of your web-app.
* OPTIONAL: Copy sitemesh.xml to the WEB-INF/ directory if you need to specify a custom
decorator mapper configuration then the default configuration.
* Add the following to WEB-INF/web.xml:
sitemesh
com.opensymphony.sitemesh.webapp.SiteMeshFilter
sitemesh
/*
* ORION USERS ONLY. For performance reasons, Orion does not auto-load tab library descriptors
from Jars by default. To get passed this you will also have to copy sitemesh-decorator.tld
and sitemesh-page.tld to WEB-INF/lib and add the following to WEB-INF/web.xml:
http://www.opensymphony.com/sitemesh/decorator
/WEB-INF/lib/sitemesh-decorator.tld
http://www.opensymphony.com/sitemesh/page
/WEB-INF/lib/sitemesh-page.tld
--------------------------
-- Getting started --
--------------------------
Ok, let's assume you have some basic JSPs already on the site.
These should contain vanilla HTML.
If you don't, here's a JSP to get you started (test.jsp).
Hello world
Today is <%= new java.util.Date() %>.
Once you have some content (preferably more imaginative than the example above),
a decorator should be created (decorator.jsp).
<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>
My Site -
Now you need tell SiteMesh about that decorator and when to use it. Create the
file WEB-INF/decorators.xml:
/*
Access your original JSP (test.jsp) though your web-browser and it should look
pretty normal. Now if you add some styling to your decorator it shall
automatically be applied to all the other pages in your web-app.
You can define as many decorators as you want in decorators.xml. Example:
/*
/subdir/*
*.html
*.htm
/anotherdir/*
--------------------------
-- Further support --
--------------------------
You get the idea. Play around. See the SiteMesh website for
full documentation.
http://www.opensymphony.com/sitemesh/
--------------------------
-- Credits --
--------------------------
Thank these guys:
* Mathias Bogaert
* Mike Cannon-Brookes
* Victor Salaman
* Joseph Ottinger
* Hani Suleiman
* Scott Farquhar
- Joe Walnes