]> git.lyx.org Git - lyx.git/blobdiff - development/HTML/HTML.notes
Update notes.
[lyx.git] / development / HTML / HTML.notes
index 9c80dbae468907cffe7f5bf47bd7b9049344a09f..da9993720e15e573d2bbf11031567381eddaf068 100644 (file)
@@ -10,29 +10,21 @@ TODO:
 These insets work but still need work:
        InsetBibtex: There are a few issues here. 
                - One is that the output is not very nice. This will be solved, though, by 
-                       a patch of mine I seem to have forgotten to finish. To get output that 
-                       accorded with the BibTeX style, of course, we'd have to parse the bbl file. 
-                       I don't know if that's worth it.
+                       a patch of mine I seem to have forgotten to finish. 
                - Another issue concerns cross-references. At the moment, we simply use the
                        xref information for every entry, rather than listing the xref separately and
                        then referencing it. That should not be terribly hard, but it would take a bit
                        of work.
-               - A third issue concerns the labels. At present, we use the BibTeX key as the 
-                       citation label. It would not be too hard, I think, to use numerical labels,
-                       in the way BibTeX does. To do so, we'd need to move the sorting routine out
-                       of InsetBibtex so we could do it before we print the citations. See below.
        InsetBox: The CSS isn't there yet.
        InsetCitation: This has two limitations as of 20 XI 2009. The first is that we
                ignore the citation style and output square brackets, no matter what. The
-               second is that, with BibTeX, we simply use the BibTeX key as the citation
-               string, thus ignoring numerical, author-year, etc. It will not be too hard
-               to make numerical work. To do this, we need to collect information on the
-               used citations, alphabetize them, and then assign numerical labels via the
-               BibTeXInfo::label() method. A similar strategy will work for author-year and
-               the like, but calculating labels will be more complex---unless we just parse
-               the bbl file, which of course is the only fully general solution.
+               second is that we only do numerical citations. It will not be terribly hard 
+               to do author-year citations, but the complexLabel() routine in InsetCitation
+               will need adapting before that is possible.
        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.
+       InsetFloat: This seems to work OK, but it will need testing and tweaking. There is
+               also no CSS yet for these.
+       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 
@@ -43,46 +35,41 @@ These insets work but still need work:
        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.
-       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.
+
 
 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:
-         - AMSArray
-    - Array
-    - Big: Not sure if we can actually do anything here. Probably they should
-      just be treated as delimiters.
-    - BoldSymbol: Should be easy.
-    - Box
-    - Cases
-    - Diff: Code exists, but I do not know if it is right.
-    - Font
-    - Binom (in Frac): None of these tags exist in MathML 2.0. We'll
-      just output a fraction with delimiters.
-    - Lefteqn
-    - MBox: Use <mtext>.
-    - Overset: Use <mover>.
-    - Par?
-    - Phantom: There is some support for this in MathML....
-    - Ref: Probably needs to be deferred somehow, which is a hassle, because it
-      means the whole MathML output business needs a new argument.
-    - 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
-    - Stackrel: Use <mover>, probably.
-    - 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.
-    - Underset: Use <munder>.
-    - XArrow: Contents above and below an arrow. Use...?
-    - XYMatrix: Not sure how this differs from ordinary ones.
+       - 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:
@@ -95,8 +82,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.
-
-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.