Eclipse Community Forums: Platform - User Assistance (UA)

Help

Home

Home » Eclipse Projects » Platform - User Assistance (UA) » Override Eclipse CSS

Show: Today's Messages :: Show Polls :: Message Navigator

Override Eclipse CSS [message #474617]

Thu, 16 October 2008 15:38

Eclipse User

Originally posted by: j.hurrell.don'tspamme.castsoftware.com

This must be such a common request, but I can't find anything about it
in this newsgroup, nor on Google.

I use my own CSS stylesheet to govern the format of my plugin html help
pages. This works fine. However, it seems that the CSS files that are
automatically added by Eclipse are overriding my CSS and making the page
look slightly odd.

This is the header before I view it via Eclipse:

<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="StyleSheet" type="text/css" href="../css/cast.css">
<title>Plug-in for Eclipse</title>
</head>

When viewed through Eclipse help system the header looks like this:

<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="StyleSheet" type="text/css" href="../css/cast.css">
<title>Plug-in for Eclipse</title>

<link rel="stylesheet"
href=" ../content/PLUGINS_ROOT/org.eclipse.help.webapp/advanced/bre adcrumbs.css "
charset="ISO-8859-1" type="text/css"></link>
<script type="text/javascript"
src="../content/PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script>

<link rel="stylesheet"
href="../content/PLUGINS_ROOT/PRODUCT_PLUGIN/narrow_book.css "
type="text/css"></link>
<link rel="stylesheet"
href=" ../content/PLUGINS_ROOT/PRODUCT_PLUGIN/win32_narrow_book.css "
type="text/css"></link>
<script type="text/javascript">

</script>

</head>

Any ideas how to stop the Eclipse CSS from "upsetting" my own CSS?

Thanks

Report message to a moderator

Re: Override Eclipse CSS [message #474618 is a reply to message #474617]

Thu, 16 October 2008 16:02

Eclipse User

Originally posted by: j.hurrell.don'tspamme.castsoftware.com

Note that the display only seems to be "upset" when viewing my help
through the Eclipse internal Help window view.

When using the Help > Help Contents option, my plugin displays as it
should, However, on closer examination, Eclipse doesn't seem to add the
following two stylesheets when viewed through the Help > Help COntents menu:

<link rel="stylesheet"
href="../content/PLUGINS_ROOT/PRODUCT_PLUGIN/narrow_book.css "
type="text/css"></link>
<link rel="stylesheet"
href=" ../content/PLUGINS_ROOT/PRODUCT_PLUGIN/win32_narrow_book.css "
type="text/css"></link>

Any ideas how I can rectify this or stop Eclipse using its own stylesheets?

James Hurrell wrote:
> This must be such a common request, but I can't find anything about it
> in this newsgroup, nor on Google.
>
> I use my own CSS stylesheet to govern the format of my plugin html help
> pages. This works fine. However, it seems that the CSS files that are
> automatically added by Eclipse are overriding my CSS and making the page
> look slightly odd.
>
> This is the header before I view it via Eclipse:
>
> <head>
> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
> <link rel="StyleSheet" type="text/css" href="../css/cast.css">
> <title>Plug-in for Eclipse</title>
> </head>
>
> When viewed through Eclipse help system the header looks like this:
>
> <head>
> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
> <link rel="StyleSheet" type="text/css" href="../css/cast.css">
> <title>Plug-in for Eclipse</title>
>
> <link rel="stylesheet"
> href=" ../content/PLUGINS_ROOT/org.eclipse.help.webapp/advanced/bre adcrumbs.css "
> charset="ISO-8859-1" type="text/css"></link>
> <script type="text/javascript"
> src="../content/PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script>
>
> <link rel="stylesheet"
> href="../content/PLUGINS_ROOT/PRODUCT_PLUGIN/narrow_book.css "
> type="text/css"></link>
> <link rel="stylesheet"
> href=" ../content/PLUGINS_ROOT/PRODUCT_PLUGIN/win32_narrow_book.css "
> type="text/css"></link>
> <script type="text/javascript">
> 
> </script>
>
> </head>
>
> Any ideas how to stop the Eclipse CSS from "upsetting" my own CSS?
>
> Thanks

Report message to a moderator

Re: Override Eclipse CSS [message #474619 is a reply to message #474617]

Mon, 20 October 2008 16:27

Chris Goldthorpe

Messages: 815
Registered: July 2009

Senior Member

It is a common request, in Eclipse 3.4 we added a new product
customization that lets you override the standard CSS. From

http://help.eclipse.org/ganymede/topic/org.eclipse.platform. doc.isv/guide/ua_help_setup_preferences.htm

The four css preferences allow for the control of page appearance by
inserting css files into every page served by the help server. Each can
each contain zero or more comma separated paths of the form
/plugin/path. These paths should contain only ASCII characters.
If a path contains ${os} then that will be replaced with the name of the
OS, any other parameters of the form ${parameter} are reserved for
future use.

topic_css A list of css file(s) to include in every non navigation page
served by help system.
nav_css A list of css file(s) to include in every navigation page served
by help system
narrow_css A list of css file(s) to include in every page displayed in
the help view or help tray .
disabled_css A list of css file(s) to include in every page served by
help system from a capability that is not enabled.

Report message to a moderator

Re: Override Eclipse CSS [message #474701 is a reply to message #474619]

Tue, 21 October 2008 15:49

Eclipse User

Originally posted by: j.hurrell.don'tspamme.castsoftware.com

Chris Goldthorpe wrote:
> It is a common request, in Eclipse 3.4 we added a new product
> customization that lets you override the standard CSS. From
>
> http://help.eclipse.org/ganymede/topic/org.eclipse.platform. doc.isv/guide/ua_help_setup_preferences.htm
>
>
> The four css preferences allow for the control of page appearance by
> inserting css files into every page served by the help server. Each can
> each contain zero or more comma separated paths of the form
> /plugin/path. These paths should contain only ASCII characters.
> If a path contains ${os} then that will be replaced with the name of the
> OS, any other parameters of the form ${parameter} are reserved for
> future use.
>
> topic_css A list of css file(s) to include in every non navigation page
> served by help system.
> nav_css A list of css file(s) to include in every navigation page served
> by help system
> narrow_css A list of css file(s) to include in every page displayed in
> the help view or help tray .
> disabled_css A list of css file(s) to include in every page served by
> help system from a capability that is not enabled.

Thanks Chris. I'm struggling somewhat with this... reading around the
subject, i gather these preferences should be placed in a
plugin_customization.ini file? Is that correct?

If so, where do i place the .ini file (at the root of the Help plugin?)
and does it need referencing somewhere - such as the plugin.xml?

Or have I misunderstood and the plugin_customization.ini file can only
be used when you launch Eclipse and it is valid for all plugins?

Report message to a moderator

Re: Override Eclipse CSS [message #474702 is a reply to message #474701]

Tue, 21 October 2008 16:34

Chris Goldthorpe

Messages: 815
Registered: July 2009

Senior Member

James Hurrell wrote:

>
> Thanks Chris. I'm struggling somewhat with this... reading around the
> subject, i gather these preferences should be placed in a
> plugin_customization.ini file? Is that correct?
>
> If so, where do i place the .ini file (at the root of the Help plugin?)
> and does it need referencing somewhere - such as the plugin.xml?
>
> Or have I misunderstood and the plugin_customization.ini file can only
> be used when you launch Eclipse and it is valid for all plugins?

The way I usually do this is to add a command line option when you start
eclipse such as

eclipse -pluginCustomization plugin_customization.ini

I think that you can also specify the location of the customization file
at the product file, see
http://help.eclipse.org/ganymede/topic/org.eclipse.platform. doc.isv/reference/extension-points/org_eclipse_core_runtime_ products.html

Report message to a moderator

Re: Override Eclipse CSS [message #474703 is a reply to message #474702]

Wed, 22 October 2008 09:01

Eclipse User

Originally posted by: j.hurrell.don'tspamme.castsoftware.com

Chris Goldthorpe wrote:

>
> The way I usually do this is to add a command line option when you start
> eclipse such as
>
> eclipse -pluginCustomization plugin_customization.ini
>
> I think that you can also specify the location of the customization file
> at the product file, see
> http://help.eclipse.org/ganymede/topic/org.eclipse.platform. doc.isv/reference/extension-points/org_eclipse_core_runtime_ products.html
>

Many thanks Chris. That seems to work fine.

Report message to a moderator