Re: [platform-ua-dev] Need help with Eclipse book.css file

[Dejan Glozic <dejan@xxxxxxxxxx>]

Jodi,

'PRODUCT_PLUGIN' is the plug-in/bundle that contributes active product that
is used to launch Eclipse. When you launch Eclipse SDK, this plug-in is
org.eclipse.sdk and book.css can be found there. The fact that you are
seeing the indirection is due to historic reasons (we had book.css in each
document plug-in). If we were to start from scratch, we would have
'PLUGINS_ROOT/PRODUCT_PLUGIN/book.css' in each document.

For your own product, place your book.css in the plug-in that contributes
the active product.

The other CSS you are mentioning (narrow_book.css) is a version of the CSS
that is applied to documents when shown inside the dynamic Help view inside
Eclipse perspective. We offer the opportunity to revise some settings to
make documents fit better in the smaller and narrower space (notice how
documents use smaller fonts when shown there).

Regards,

Dejan Glozic, Ph.D.
Manager, Eclipse Development 1A
D1/R0Q/8200/MKM
IBM Canada Ltd.
Tel. 905 413-2745  T/L 969-2745
Fax. 905 413-4850



                                                                           
             "Jodi Karzowski"                                              
             <jkarzowski@gmail                                             
             .com>                                                      To 
             Sent by:                  platform-ua-dev@xxxxxxxxxxx         
             platform-ua-dev-b                                          cc 
             ounces@xxxxxxxxxx                                             
             g                                                     Subject 
                                       [platform-ua-dev] Need help with    
                                       Eclipse book.css file               
             05/03/2006 07:24                                              
             PM                                                            
                                                                           
                                                                           
             Please respond to                                             
             "Eclipse Platform                                             
              User Assistance                                              
                 component                                                 
             developers list."                                             
             <platform-ua-dev@                                             
               eclipse.org>                                                
                                                                           
                                                                           




Can anyone point me to an in depth discussion and/or book on how css [for
the help files] works in eclispe? I don't mean the css technology, I mean
how the style sheets are packaged and why there is so much indirection. I
still haven't been able to locate the actual css file that comes with the
help plugin. I see a book.css stylesheet but when I open it, there is one
line: @import "../PRODUCT_PLUGIN/book.css"; and since there is no
"product_plugin" directory...(or any comment for that matter explaining how
this line is resolved) I have to assume this is a pointer to some other
directory-- but how is it resolved and where do I find the css for each
platform and more to the point, how can I change it? Clearly it's getting
the styles from somewhere.

When I did a search on my eclispse installation, I noticed a number of css
files (some zipped, others not; a narrow-book.css, etc.) In any event, it
would be enormously helpful to know how the eclipse helpdoc backend works.

I know about setting up the toc.xml and the html files, etc. What I'm
having the most trouble with is understanding how the CSS is resolved for
all the platforms.

Thanks! _______________________________________________
platform-ua-dev mailing list
platform-ua-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/platform-ua-dev