Package eu.bandm.tools.lablog.base

Class ToHtml

java.lang.Object
eu.bandm.tools.tdom.runtime.BaseVisitor
eu.bandm.tools.lablog.xml.Visitor
eu.bandm.tools.lablog.base.ToHtml
All Implemented Interfaces:
PCDataVisitor
public class ToHtml extends Visitor
Generate from a collection of lablog entries an interactive HTML representation. Visit the lablog tdom model and create an xhtml tdom model.

The text structure of lablog is imported from d2d_gp.basic. One central issue is the difference in content models for the xhtml containers Element_p, Element_li, Element_td, etc., and the compositional modifiers Element_em, Element_span, etc. E.g. a visited PCData on the input side will be translated into very different of these target contexts, and thus wrapped into different TypedContent classes. For this the ToHtml.DeliveryContext is introduced.

A special problem is the "hierarchy rotation" between "p" on one side and "list" and "table" on the other. In d2d_gp.basic the "p" element is the central means for organizing text (e.g. the attributes "language", "style", "accessRights"), and all other elements containing text (even images) are subordinated. In xhtml its different and not so consistent: 

          d2d_gp.basic:             xhtml:

          |                        |---------+--------+
          p                        p       list       p
          |--------+-----+         |                  |
          PCData  list PCData      PCData          PCData
The xhtml Tdom defines some abstract classes which make this sorting easier: 
     Element_body      Element_p      Element_li         E_span    Element_div
     Element_td                                          E_em etc. _inline
  contains..
     E_block_content   E_p.Content    E_li.Content       E_span.Content  
                     wraps..
                       E_misc_inline  E_block_content    E_misc_inline        
                           | E_inline         | E_inline        | E_inline
                     which are..
                                    |_a|_phrase  |_fonstyle
                                       |_em|_kbd |_b|_big|_i|_tt
  which are..                                          
     E_form | E_form_content
              E_block      | E_misc
                           | E_misc_inline|_noscript 
                           | _del|_ins|_script
              E_div|_p|E_table
              E_heading|E_blocktext
              _h1|_h2..|hr pre address
Element_misc_inline (del, ins, script, noscript) is not in a full compositional way.

  • Field Details

    • path_to_stylesheet

      public static final String path_to_stylesheet
      Value which will be encoded in the generated html to address the stylesheet.
      See Also:

    • path_to_javascript

      public static final String path_to_javascript
      Value which will be encoded in the generated html to address the stylesheet.
      See Also:

    • ISSUE_SEPARATOR

      public static final String ISSUE_SEPARATOR
      Separator between the names of package and issue. This must be a valid XML NMTOKEN character but NOT part of a java package name
      See Also:

    • href_bandm_online_docu

      public static final String href_bandm_online_docu
      Put into the footer.
      See Also:

    • CL_topHeadline

      public static final String CL_topHeadline
      Class name for the css style definitions.
      See Also:

    • CL_survey_tab

      public static final String CL_survey_tab
      Class name for the css style definitions.
      See Also:

    • CL_survey_tab_ACTIVE

      public static final String CL_survey_tab_ACTIVE
      Class name for the css style definitions.
      See Also:

    • CL_package_header

      public static final String CL_package_header
      Class name for the css style definitions.
      See Also:

    • CL_issue_header

      public static final String CL_issue_header
      Class name for the css style definitions.
      See Also:

    • CL_issue_prefix

      public static final String CL_issue_prefix
      Class name for the css style definitions.
      See Also:

    • CL_td_nodecor

      public static final String CL_td_nodecor
      Class name for the css style definitions.
      See Also:

    • CL_prior_N

      public static final String CL_prior_N
      Class name for the css style definitions.
      See Also:

    • CL_costs_N

      public static final String CL_costs_N
      Class name for the css style definitions.
      See Also:

    • CL_issueDate

      public static final String CL_issueDate
      Class name for the css style definitions.
      See Also:

    • CL_status_N

      public static final String CL_status_N
      Class name for the css style definitions.
      See Also:

    • CL_authors

      public static final String CL_authors
      Class name for the css style definitions.
      See Also:

    • CL_noteHeader

      public static final String CL_noteHeader
      Class name for the css style definitions.
      See Also:

    • CL_docmatHeader

      public static final String CL_docmatHeader
      Class name for the css style definitions.
      See Also:

    • EL_BR

      public static final Element_br EL_BR

    • EL_HH

      public static final Element_span EL_HH

    • EL_HR

      public static final Element_hr EL_HR

    • msg

      protected MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg

    • elements2file

      protected Map<Element,File> elements2file
      Input parameter, passed in from the file visitor in Main, which collected the lablog tdom elements.

    • allNames

      protected Map<String,Element> allNames
      Control for duplicate entries.

  • Method Details

    • visit

      public void visit(TypedPCData data)
      Description copied from class: BaseVisitor
      To be overridden. This default implementation does nothing.
      Specified by:
      visit in interface PCDataVisitor
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_list el)
      Construct an xhtml list from a d2d list. For this, a currently growing xhtml paragraph must be closed and re-opened afterwards. ATTENTION: corresponding to d2d_gp toXhtml, a list without "symbol" entry is rendered by arabic numbers.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_listitem el)
      Description copied from class: Visitor
      Can be overridden by the user to define particular semantic operations. Will be called whenever the default model instance traversal (as implemented by the methods in this class) reaches such an element.
      This default implementation descends into the element by calling visit(..) in turn for all PCData and all Elements in its contents.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_table el)
      Construct an xhtml table from a d2d table. For this, a currently growing xhtml paragraph must be closed and re-opened afterwards.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_tr el)
      Construct an xhtml tr from a d2d tr.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_td el)
      Construct an xhtml td from a d2d td.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_p el)
      Construct an xhtml p from a d2d p.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_SRC el)
      Construct an xhtml PRE from a d2d SRC. Flush an open p iff we are the first in a "desc"
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_nl el)
      Construct an xhtml br from a d2d nl.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_hh el)
      Insert character data hashmark.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_src el)
      Construct an xhtml tt from a d2d src. Can only contain "#hh".
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_link el)
      Construct an xhtml link from a d2d link.
      ATTENTION renders from the "text" input only un-decorated text. Starting "0" is replaced by "http:/" and "1" by "https:/", for ease of writing.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_emph el)
      Construct an xhtml em from a d2d emph. FIXME CHECK d2d emph NUR CHARACTER DATA wird genommen ?!?!
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_a_xemph el)
      Construct an xhtml b from a d2d xemph. FIXME CHECK d2d emph NUR CHARACTER DATA wird genommen ?!?!
      Overrides:
      visit in class Visitor

    • extractAuthors

      protected String extractAuthors(Element el)
      Visit an subtree of the d2d input and extract a list of author names.

    • visit

      public void visit(Element_note el)
      Make the xhtml rendering of a note = a text aappended to an Issue.
      Overrides:
      visit in class Visitor

    • visit

      public void visit(Element_desc el)
      Make the xhtml rendering of a d2d "desc" element, which occurs is the main sub-element of an issue. Open a paragraph context in case that the "@p" alternative of its content model is chosen, and flushP() it on return, if necessary. If the "p*" alternative is chosen, this first (empty) paragraph will be flushed and the explicit/contained paragraph will also be flushed by its visitor code (thus inP==false).
      Overrides:
      visit in class Visitor

    • renderDocmat

      protected void renderDocmat(String packageName, String issueName, Element_docmat data)
      Make the xhtml rendering of a d2d "docMat" element, which appears independent from an issue.

    • renderIssue

      protected void renderIssue(String packageName, String issueName, Element_issue data)
      Make the xhtml rendering of a d2d "issue" element.
      Parameters:
      packageName - "noPackage" is encoded as ""

    • renderPackage

      protected void renderPackage(String packagename, @Opt @Opt List<Element_issue> issues, @Opt @Opt List<Element_docmat> docmats)
      Make the xhtml rendering of a package header, i.e. a package name for which issues or docmats or both have been collected.

    • makeHtml

      public Element_html makeHtml(SortedMap<String,List<Element_issue>> issuesByPackage, SortedMap<String,List<Element_docmat>> docmatsByPackage, Map<Element,File> elements2file, Map<File,@Opt MessageStore<SimpleMessage<XMLDocumentIdentifier>>> files2error)
      Make the complete html rendering.