development/HTML/HTML.notes

   1 TODO:
   2 1. CSS needs work in several places, mostly floats. Maybe check elyxer on that.
   3 2. MathML
   4
   5
   6 These insets work but still need work:
   7         InsetBibtex: There are a few issues here.
   8                 - One is that the output is not very nice. This will be solved, though, by
   9                         a patch of mine I seem to have forgotten to finish.
  10                 - Another issue concerns cross-references. At the moment, we simply use the
  11                         xref information for every entry, rather than listing the xref separately and
  12                         then referencing it. That should not be terribly hard, but it would take a bit
  13                         of work.
  14         InsetBox: The CSS isn't there yet.
  15         InsetFlex: I think this one is OK, but it needs some testing.
  16         InsetFloat: This seems to work OK, but it will need testing and tweaking. There is
  17                 also no CSS yet for these.
  18         InsetFloatList: Seems to work well, but may need testing.
  19         InsetGraphics: This works in a pretty primitive way, in that it outputs the graphic
  20           and appropriate img tag. But we don't yet do any sort of scaling, rotating, and
  21                 so forth. That won't be hard, since we can just call ImageMagick to do this for
  22                 us, but appropriate routines will need to be written.
  23         InsetIndex and InsetPrintIndex: These work with limitations, as noted in the
  24                 Additional Features manual.
  25         InsetNomencl and InsetPrintNomencl: Do not work at all yet, but would be easy to do.
  26                 First, Nomencl would need to go to the TOC, which it should do anyway. Then just
  27                 do as for TOC and Index, more or less.
  28         InsetTabular: Works reasonably well, but we don't do anything with any of the
  29                 arguments provided for longtable. There are probably other limitations, too,
  30                 since I'm very much not an expert with tables.
  31
  32
  33 Math
  34   We have a fair bit of math now working via MathML output, but there are still some
  35   isues, and not all the insets work. Here are the ones I know still need work:
  36         - Array: Should be able to use alignment information via appropriate attributes, for
  37                 mtable, mrow, and mtd.
  38         - Box: There is a general issue here with text mode nesting. See the FIXME attached
  39                 to the SetMode class.
  40         - Lefteqn: For this, and numbering in general, probably need mlabeledtr, which may
  41                 mean we always need to output <mtable>.
  42         - Par?
  43         - Phantom: There is some support for this in MathML....
  44         - Ref: Needs to be deferred.
  45         - Size: Unclear if we want to do anything here, though we could. See
  46                 lib/symbols for the commands supported, of course. At least, we have to output
  47                 the cell.
  48         - Space: Needs checking.
  49         - SpecialChar: Needs checking.
  50         - Split: There are some alignment issues here, but it basically works.
  51         - Substack: This is a stack of however many cells, all in a smaller style.
  52                 Probably do something with <mover>, again.
  53         - Tabular: This is more or less a text-like table in math. Probably output it
  54                 as a table, but set the font.
  55
  56 Other math notes:
  57         - Hull:
  58                 -       Need to handle the equation hull type by outputting a counter. But that will
  59                         have to wait for the counter patch. The counter probably goes with mlabeledtr,
  60                         which may mean we always need to output <mtable>.
  61                 - Similar issues about eqnarray.
  62                 - It's not clear if we need to do much about the other hull types.
  63         - XYMatrix: So far as I can tell, using this in LyX effectively involves using a
  64                 lot of ERT, within the matrix, to get the arrow effects. At present, it just prints
  65                 as an InsetMathGrid, from which it inherits, and so as a simple table. I don't know
  66                 how much more we can do.
  67
  68
  69 These insets do not work and are not yet scheduled to work:
  70         InsetExternal: It may be that this won't be too hard, but I don't understand
  71                 these so am not sure what to do. For now, it is disabled.