Tim,I just added a comment on http://www.ja-sig.org/issues/browse/UP-1916 which describes what we will use in uP3 for directory structures.
uPortal 3 has been re-organized into a standard Maven 2 project structure. The 'webpages' directory in uPortal 2 was, well, confusing. All of the files there ended up in both the classpath and available directly to the browser as a direct child under the uPortal webapp. The files have been placed in their appropriate locations and layout/skin related files are now in the following locations:
/uportal-war/src/main/resources/ - Classpath resources related to the layout/theme/ui /uportal-war/src/main/webapp/ - Browser accessible resources (images, css, js) go here. This is also where the WEB-INF directory is.
If you're not familiar with Maven I'd recommend reading: http://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html
I'll also be documenting file locations for the whole project in the uPortal 3 Manual wiki space.
-Eric Timothy Carroll wrote:
+1 to paring down the number of options+1 to the directory structure suggestions with one minor suggested change... (have a dlm node in the tree under which you have tab-column rather than DLM-tab-column. we currently have a dlm/tab-column theme as well as a dlm/tab-subtab-column directory structure)we have been struggling with this very thing in our implementation. at one point, i remember the structure causing some real confusion because some of the themes used structure stylesheets that were outside of the directory structure that they resided in (where another structure stylesheet actually existed as well... which made it too easy to assume that the theme was using the structure stylesheet that was closest in proximity).we are in the process of creating a commons area for images as well. so, this thread comes at a good time, as it will give us some guidance in our upcoming updates to the 2.6 branch.as we move forward can we make references to how the source tree would look, in addition to the actual deployment location? maybe i'm missing something (i have not been following the up3 threads as closely as i should), but it appears that we will be moving the transforms from webpages/stylsheet and webpages/media to the source directory ??? please clarify ???Eric Dalquist wrote:I'd like to get some feedback about some upcoming changes to the uPortal 3 theme.The next release of uP3 will include a theme provided by Gary Thompson from Unicon that includes some neat features such as fly-out menus, lighter xhtml, and well defined and broken up XSL. While talking with him about incorporating this new theme he had some suggestions relating to structure, theme and skin file locations.Currently layout files are in /uportal-war/src/main/resources/org/jasig/portal/layout/ with no obvious declaration of which files are for the structure or which are for the theme. I would like to simply add structure/ and theme/ directories under layout/ and move the appropriate files under each.Similarly with skin files we currently have directories that look like /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/spring/ I would like to simplify this structure and remove the entire /org/jasig/portal/layout/tab-column/xhtml-theme/ bit and just have a skins/ directory in the base media directory, perhaps adding a common/ directory for shared js, css, images:/uportal-war/src/main/webapp/media/common/javascript /uportal-war/src/main/webapp/media/common/css /uportal-war/src/main/webapp/media/skins/springWith both layout XSL and skins I would also like to review what we are shipping with uPortal 3 to see if the variety of XSLs and skins actually add value.For structure transforms we currently have:/uportal-war/src/main/resources/org/jasig/portal/layout/DLM-tab-column/tab-column.xsl (this is the default in 2.6) /uportal-war/src/main/resources/org/jasig/portal/layout/nested-categories/nested-categories.xsl /uportal-war/src/main/resources/org/jasig/portal/layout/tab-column/tab-column.xslFor theme transforms we currently have:/uportal-war/src/main/resources/org/jasig/portal/layout/DLM-tab-column/nested-tables/nested-tables.xsl (this is the default in 2.6) /uportal-war/src/main/resources/org/jasig/portal/layout/nested-categories/deck-of-cards/deck-of-cards.xsl /uportal-war/src/main/resources/org/jasig/portal/layout/tab-column/deck-of-cards/deck-of-cards.xsl /uportal-war/src/main/resources/org/jasig/portal/layout/tab-column/nested-tables/nested-tables.xsl /uportal-war/src/main/resources/org/jasig/portal/layout/tab-column/xhtml-theme/xhtml-theme.xslFor skins we currently have:/uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/cp /uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/imm /uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/java /uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/matrix /uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/uosm /uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/vsac /uportal-war/src/main/webapp/media/org/jasig/portal/layout/nested-categories/deck-of-cards /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/nested-tables /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/grape /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/metal /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/ocean /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/spring (this is the default in 2.6) /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/usflag /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tab-column/xhtml-theme/winter /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tree-column/imm /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tree-column/sun /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tree-column/usom /uportal-war/src/main/webapp/media/org/jasig/portal/layout/tree-column/vsacIf you're interested in what any of these skins look like you can usually find a thumbnail in the /skin/ folder under each: https://www.ja-sig.org/svn/up2/trunk//uportal-war/src/main/webapp/media/org/jasig/portal/layout/DLM-tab-column/nested-tables/imm/skin/To me this seems like an overwhelming number of choices and I would bet that we really don't want all of these there as most of them are probably bad examples especially in light of the work Gary is doing. I would like to propose to remove at least the following files:All /tab-column/ structure and theme files. All /DLM-tab-column/ skinsAll /tree-column/ skins since we don't appear to ship a theme transform to even generate tree column.With the addition of the new theme for uP3 we would be using/uportal-war/src/main/resources/org/jasig/portal/layout/DLM-tab-column/tab-column.xslThe new xhtml theme XSL The new xhtml theme skin filesDocumentation would be provided on how to switch back to the 2.6 nested-tables.xsl and spring skin and the currently available skins for the theme would still be availble. We would still be including the nested-categories and the deck-of-cards themes as demos of other ideas for themes UIs.I know this is a long email but _any_ feedback you have about this would be very much appreciated.-Eric
smime.p7s
Description: S/MIME Cryptographic Signature
