]> git.lyx.org Git - lyx.git/blobdiff - development/HTML/HTML.notes
Notes update.
[lyx.git] / development / HTML / HTML.notes
index 3c96a775e6d922027858f8fad49ecd0f66ea1de7..02d08a12d1fbd21451014178ea2cb02ae5da8535 100644 (file)
@@ -1,11 +1,10 @@
 TODO:
-1. InsetTabular
-2. The counter patch, and better output for InsetRef.
-3. Better output for citations, meaning better labels. Numerical, as said below,
+1. The counter patch, and better output for InsetRef.
+2. Better output for citations, meaning better labels. Numerical, as said below,
    should be easy, and author-year oughtn't to be THAT hard. But it'll need a 
         bit of work.
-4. CSS needs work in several places, mostly floats. Maybe check elyxer on that.
-5. MathML
+3. CSS needs work in several places, mostly floats. Maybe check elyxer on that.
+4. MathML
 
 
 These insets work but still need work:
@@ -34,6 +33,7 @@ These insets work but still need work:
                the bbl file, which of course is the only fully general solution.
        InsetFlex: I think this one is OK, but it needs some testing.
        InsetFloat: This seems to work OK, but it will need testing and tweaking.
+       InsetFloatList: Seems to work well, but may need testing.
        InsetGraphics: This works in a pretty primitive way, in that it outputs the graphic
          and appropriate img tag. But we don't yet do any sort of scaling, rotating, and
                so forth. That won't be hard, since we can just call ImageMagick to do this for 
@@ -41,11 +41,45 @@ These insets work but still need work:
        InsetRef: At present, we just use the label name as associated text, and put it 
                into square brackets. It'd be nice to be able to do more, but for that we'd need to
                associate counters with the labels, and we don't have that yet.
-       InsetTOC: This now works pretty well, but only for the table of contents, not for
-               any other TOC-like lists. Getting those to work shouldn't be too bad, as we can
-               do almost exactly the same thing. That said, though, we might want to do things
-               slightly differently, and have the links target actual *insets*, rather than just
-               target paragraphs. That'd mean doing a bit of work on TocBackend, etc.
+       InsetTabular: Works reasonably well, but we don't do anything with any of the 
+               arguments provided for longtable. There are probably other limitations, too,
+               since I'm very much not an expert with tables.
+
+
+Math
+  We have a fair bit of math now working via MathML output, but there are still some 
+  isues, and not all the insets work. Here are the ones I know still need work:
+       - Array: Should be able to use alignment information via appropriate attributes, for
+               mtable, mrow, and mtd.
+       - Box: There is a general issue here with text mode nesting. See the FIXME attached
+               to the SetMode class.
+       - Lefteqn: For this, and numbering in general, probably need mlabeledtr, which may
+               mean we always need to output <mtable>.
+       - Par?
+       - Phantom: There is some support for this in MathML....
+       - Ref: Needs to be deferred.
+       - Size: Unclear if we want to do anything here, though we could. See
+               lib/symbols for the commands supported, of course.
+       - Space: Needs checking.
+       - SpecialChar: Needs checking.
+       - Split: There are some alignment issues here, but it basically works.
+       - Substack: This is a stack of however many cells, all in a smaller style.
+               Probably do something with <mover>, again.
+       - Tabular: This is more or less a text-like table in math. Probably output it
+               as a table, but set the font.
+
+Other math notes:
+       - Hull:
+               -       Need to handle the equation hull type by outputting a counter. But that will 
+                       have to wait for the counter patch. The counter probably goes with mlabeledtr, 
+                       which may mean we always need to output <mtable>.
+               - Similar issues about eqnarray.
+               - It's not clear if we need to do much about the other hull types.
+       - XYMatrix: So far as I can tell, using this in LyX effectively involves using a
+               lot of ERT, within the matrix, to get the arrow effects. At present, it just prints
+               as an InsetMathGrid, from which it inherits, and so as a simple table. I don't know
+               how much more we can do.
+
 
 These insets do not work and are not yet scheduled to work:
        InsetExternal: It may be that this won't be too hard, but I don't understand 
@@ -57,11 +91,3 @@ These insets do not work and are not yet scheduled to work:
 
 May need to make use here of TocWidget::itemInset, which should then be moved
 to TocBackend.
-
-These do not yet work and need some attention:
-       InsetTabular: This shouldn't be too hard, but will need doing.
-
-MATH
-       Regarding math, the view seems to be that we should in the first instance just use what
-       we get from instant preview and copy those over to the output directory, and then try
-       to make MathML work.