development/HTML/HTML.notes

   1 The main output routines now more or less work.
   2
   3 Known issues:
   4 - InsetLine normally appears in a standard environment, which puts <hr /> inside
   5         <p>, in violation of the DTD. I guess we could close the paragraph and then do
   6         the <hr />, but isn't there a better solution? There's actually a LyX bug here,
   7         I think, since a line surely ought not appear in a normal paragraph?
   8 - The code that manages the nesting of tags is pretty primitive. It needs a lot
   9         of work.
  10
  11 These insets are basically done, though there are probably issues here and there,
  12         and there are even some FIXMEs:
  13         Branch, Collapsable, Footnote, Hyperlink, Label, Line, Note,
  14         Newline, Newpage, Quotes, Space, SpecialChar
  15
  16 These insets do nothing for XHTML:
  17         ERT, OptArg, Phantom
  18
  19 These insets work but still need work:
  20         InsetBox: We need a Length::asHTML() method and the like, but it basically works.
  21                 though the CSS isn't there yet.
  22
  23 These insets do not work but should be completely straightforward:
  24         Caption, Flex (uses collapsable)
  25
  26
  27 May need to make use here of TocWidget::itemInset, which should then be moved
  28 to TocBackend.
  29
  30 These do not yet work and need some attention:
  31         InsetBibitem: Should be fairly straightforward, in itself, actually.
  32         InsetBibtex: We should be able to collect the keys of references in
  33                 validate() and then use our parsed information to output some sort of
  34                 bibliography. Formatting is another question, but here again we could
  35                 try parsing the bbl file.
  36         InsetCitation: I think we'll want to do something here involving reference keys.
  37                 Maybe for the beginning, we should just do everything numerically, but even
  38                 that will need a bit of work. Validation is our friend, presumably.
  39         InsetCommand: By default does nothing. That may be right?
  40         InsetExternal: I don't understand these so am not sure what to do.
  41         InsetFloat: This will need some work, again because I do not really understand
  42                 what these are meant to do. Presumably, we'll just use a div or something, but
  43                 it's not clear what subfloat means, etc.
  44         InsetGraphics: This should be fairly straightforward, but I'll need to learn a bit
  45                 about export formats, etc, to get it completely right. We'll also want to make
  46                 some use of the params, eg, on width and height. I guess there is also some
  47                 issue about converting the graphics formats?
  48         InsetInclude: I think we just want to include it, straightforwardly. Probably will
  49                 base this more on the latex() routine, then. Another possibility, maybe with a
  50                 flag of some sort, would be to do it as a separate file, to which we link.
  51         InsetIndex and InsetPrintIndex: An "advanced" case. What really would be cool
  52                 would be to collect all of these and then write the index as a series of links
  53                 back to the occurrences. But not now.
  54         InsetInfo: Probably skip it.
  55         InsetListings: Probably just output it as <pre>.
  56         InsetMarginal: Fine, but will need CSS.
  57         InsetNomencl and InsetPrintNomencl: Also "advanced".
  58         InsetRef: Presumably, this is an internal link. But what should the text be, and how
  59                 should we get it? Probably some validation thing again, where labels tell us where
  60                 they are. Alternatively, we could parse the aux file.
  61         InsetTabular: This shouldn't be too hard, but will need doing.
  62         InsetTOC: Here again, validation might do the trick, but I'm not sure. Or perhaps some
  63                 kind of post-processing? Another option, maybe the best option, would be just to use
  64                 the information we already have in the TOC.
  65         InsetVSpace: This will be easy, once we have the Length::asHTML() method.
  66         InsetWrap: This should be simple enough, probably a div and some CSS, but I'm not sure
  67                 precisely what this is supposed to do.
  68
  69 MATH
  70         Regarding math, the view seems to be that we should in the first instance just use what
  71         we get from instant preview and copy those over to the output directory, and then try
  72         to make MathML work.