Bernd Kuemmerlen wrote:
> 
> Hello there,
> 
> for linking between different documents, the best way is to use empty
> <olink> elements which are later resolved by the xsl processing. The
> current styled view of <olink>s is not very suitable for this, because
> an empty olink just displays an empty #text element.
> 
> I would like to have somthing similar to the <xref> rendering for olinks
> as well. I added the following in docbook.incl:
> 
> olink:after {
>      content: " <" icon(right-link) attr(targetdoc) ":" attr(targetptr)
> "> ";
>      vertical-align: text-top;
>      color: navy;
> }
> 
> I think I'll have to live with the empty #text element, because after
> all the user might want to provide an own link text, but still you can
> see where this olink points to.
> 
> I would love to see this change in the next release.

May be a customization section should be added to the Power User's
Guide...

XXE allows to customize the bundled configurations by doing something
like this (DocBook example. You'll have to change
/home/hussein/src/xxe/distrib to the location of your XXE distribution
directory):

[1] Create the following configuration in the config/ subdirectory of
your XXE preferences directory (~/.xxe2/config/ on Unix).

mydocbook.xxe
-------------------------------------------------
<?xml version='1.0' encoding='ISO-8859-1'?>
<configuration name="DocBook"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
  xmlns="http://www.xmlmind.com/xmleditor/schema/configuration";
  xmlns:cfg="http://www.xmlmind.com/xmleditor/schema/configuration";>

  <include
location="file:///home/hussein/src/xxe/distrib/config/docbook/docbook.xxe"
/>

  <css name="DocBook (collapsible sections)" location="mydocbook.css" />

</configuration>
-------------------------------------------------

Note that the name of the configuration is "DocBook" in order to
override the bundled configuration also named "DocBook".

Note that the name of the CSS style sheet is "DocBook (collapsible
sections)" in order to override the bundled CSS style sheet also named
"DocBook (collapsible sections)".

[2] Create the following customized style sheet in the same directory.

mydocbook.css
---------------------------------------------
@import
"file:///home/hussein/src/xxe/distrib/config/docbook/css/docbook-collapsible.css";

/* WHATEVER YOU WANT HERE */

* {
    color: red;
}
---------------------------------------------

[3] Restart XXE.

If, in the future, you upgrade XXE and install newer versions in the
same location, you do not have to change your customized DocBook
configuration file.

In summary, customizing XXE bundled configurations takes 5 minutes and
the customization is insensitive to version changes.



> I forgot: This applies to DocBook 4.2 only.

XXE V2.2 (available next month) will support DocBook 4.2.

We intend to ``rehash'' the whole family of DocBook CSS style sheets:
[1] to enhance maintenability (this will slowdown style sheet loading a
little bit).
[2] to fully support DocBook 4.2.

Because this is a major effort (anything related to DocBook is a major
effort!), may be DocBook 4.2 support will be minimal in XXE V2.2 and
will be really available in V2.2p1 or V2.2p2.
-------------- next part --------------
<?xml version='1.0' encoding='ISO-8859-1'?>
<configuration name="DocBook"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
  xmlns="http://www.xmlmind.com/xmleditor/schema/configuration";
  xmlns:cfg="http://www.xmlmind.com/xmleditor/schema/configuration";>

  <include 
location="file:///home/hussein/src/xxe/distrib/config/docbook/docbook.xxe" />

  <css name="DocBook (collapsible sections)" location="mydocbook.css" />

</configuration>
-------------- next part --------------
@import 
"file:///home/hussein/src/xxe/distrib/config/docbook/css/docbook-collapsible.css";

/* WHATEVER YOU WANT HERE */

* {
    color: red;
}

Reply via email to