[Laszlo-dev] For Review: Change 20080627-dda-j Summary: extend syntax for internal <a> links that are navigated without opening frame.

[Donald Anderson]

Change 20080627-dda-j by dda at lester.local on 2008-06-27 13:02:42 EDT
     in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc4
     for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: extend syntax for internal <a> links that are navigated  
without opening frame.

New Features:

Bugs Fixed: html generated from lzx files: target attribute of <a> tag  
not handled correctly by doctools

Technical Reviewer: (pending)
QA Reviewer: (pending)
Doc Reviewer: liorio (pending)

Documentation:

Release Notes:

Details:
    Apparently by design, <a> entries have two forms:
      <a href="url">
    and
      <a href="#id">

    target=.... is ignored in both of these forms (!)
    The first of these forms always opens a new window, the
    second of these forms navigates within the frame.
    This is apparently done this way because the <a> is converted
    to a <ulink> or <link> tag known by docbook, and that does
    not seem to have a target= or equivalent.

    So the answer is to use the second form, but by itself, this
    did not work (href="basetabpane" tries to find a nonexistant ID  
Components.basetabpane).
    I extended the syntax so that if id contains a '.', it is  
considered the complete ID.

    So <a href="#lz.basetabpane> should do it.

Test:
    Changed <basetabsbar> class to use this form (included in this  
change), rebuilt, and tried it out.

Files:
M      docs/src/xsl/js2doc-comment2dbk.xsl
M      lps/components/base/basetabs.lzx

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20080627-dda-j.tar



--

Don Anderson
Java/C/C++, Berkeley DB, systems consultant

voice: 617-547-7881
email: dda at ddanderson.com
www: http://www.ddanderson.com



-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20080627/03971f23/attachment.html