| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css"> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script> |
| <title>Managing links</title> |
| </head> |
| <body> |
| |
| <h2>Managing links</h2> |
| |
| <p> |
| Most of the extensions coming into the main Welcome pages offer links to open |
| further pages contributed by the extensions themselves. It is recommended to |
| create these pages in such a way as to continue with the shared Welcome visual |
| design. The main requirement is to show the appropriate navigator at the top of |
| the page. |
| </p> |
| |
| <p> |
| It is fairly easy to do that using the 'include' element. The idea is to |
| include the navigation content at the beginning of contributed page. Unlike the |
| current Welcome implementation, shared Welcome main pages have navigation |
| section that is different for each page. For this reason, pages that branch off |
| these pages should include the navigation from the parent page. For example: |
| </p> |
| |
| <pre> |
| <introContent> |
| <extensionContent id="extra" name="Extra" alt-style="css/swt.properties" style="css/overview.css" path="overview/@"> |
| <link |
| label="Extra Overview link" |
| url="http://org.eclipse.ui.intro/showPage?id=extraOverview" |
| id="extra-overview"> |
| <text>Showing the third-level extra page for overview</text> |
| </link> |
| </extensionContent> |
| <page id="extraOverview" <b>style="$theme$/html/overview.css"</b> style-id="page"> |
| <b><title style-id="intro-header">$introTitle$</title></b> |
| <b><group id="extra-group1" filteredFrom="swt"/></b> |
| <b><include path="overview/navigation-links"/></b> |
| <group id="page-content"> |
| <group id="content-header" label="EXTRA OVERVIEW" filteredFrom="swt"> |
| </group> |
| <text style-id="page-title" id="page-title" filteredFrom="html">EXTRA OVERVIEW</text> |
| <text style-id="page-description" id="page-description">Extra overview page description.</text> |
| <!-- Add content here --> |
| </group> |
| </page> |
| </introContent> |
| </pre> |
| |
| <p> |
| The extension above contributed into the overview page contributes a |
| link that shows another page whose definition is part of the extension. |
| Note how we define the title element using substitution variable (the |
| variable will be resolved based on the product property). We also |
| include the group 'navigation-links' that belongs to the 'overview' |
| page at the beginning of the page content definition. We also add the |
| 'extra-group1' div because it is can be used by some themes for adding |
| additional page decoration (indeed, it is used in 'Purple Mesh' theme |
| for that exact purpose). |
| </p> |
| |
| </body> |
| </html> |
