]> git.lyx.org Git - lyx.git/blobdiff - development/HTML/HTML.notes
remove Qt4 path name reference
[lyx.git] / development / HTML / HTML.notes
index 133fe6cafb7c691ae7eb16dd2a7547f88fa71468..e41e617de46731501199e37bf43b79f4f7ba88eb 100644 (file)
@@ -1,80 +1,46 @@
-The main output routines now more or less work.
-
-Known issues:
-* InsetLine normally appears in a standard environment, which puts <hr /> inside
-       <p>, in violation of the DTD. I guess we could close the paragraph and then do
-       the <hr />, but isn't there a better solution? There's actually a LyX bug here, 
-       I think, since a line surely ought not appear in a normal paragraph?
-* The same issue arises with InsetVSpace, unsurprisingly. And also with the inline
-       version of InsetListings. 
-* One option here, actually, would be to use just <div> and never use <p>, setting
-       the spacing and such via CSS.
-* The code that manages the nesting of tags is pretty primitive. It needs a lot
-       of work.
-
-These insets are basically done, though there are probably issues here and there,
-       and there are even some FIXMEs:
-       Bibitem, Branch, Caption, Collapsable, Footnote, Hyperlink, Info, Label, Line, 
-       Listings, Marginal, Note, Newline, Newpage, Quotes, Space, SpecialChar, Wrap
-
-These insets do nothing for XHTML:
-       ERT, OptArg, Phantom
 
 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.
+       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.
                - 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 11 VI 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.
-       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
+               us, but appropriate routines will need to be written.
+       InsetNomencl and InsetPrintNomencl: Do not work at all yet, but would be easy to do.
+               First, Nomencl would need to go to the TOC, which it should do anyway. Then just
+               do as for TOC and Index, more or less.
+       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.
+       - Par?
+       - Phantom: There is some support for this in MathML....
+       - Space: Needs checking.
+       - SpecialChar: Needs checking.
+       - Split: There are some alignment issues here, but it basically works.
+       - 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:
+       - AMSArray: Some of these should be handled via images. I need to investigate which.
+       - Hull:
+               -       Need to check that we handle all the various types correctly.
+
 
 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 
+       InsetExternal: It may be that this won't be too hard, but I don't understand
                these so am not sure what to do. For now, it is disabled.
-       InsetIndex and InsetPrintIndex: An "advanced" case. What really would be cool 
-               would be to collect all of these and then write the index as a series of links 
-               back to the occurrences. But not now.
-       InsetNomencl and InsetPrintNomencl: Also "advanced".
-
-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:
-       InsetGraphics: This should be fairly straightforward, but I'll need to learn a bit
-               about export formats, etc, to get it completely right. We'll also want to make
-               some use of the params, eg, on width and height. I guess there is also some
-               issue about converting the graphics formats?
-       InsetInclude: I think we just want to include it, straightforwardly. Probably will
-               base this more on the latex() routine, then. Another possibility, maybe with a
-               flag of some sort, would be to do it as a separate file, to which we link.
-       InsetRef: Presumably, this is an internal link. But what should the text be, and how
-               should we get it? Probably some validation thing again, where labels tell us where 
-               they are. Alternatively, we could parse the aux file.
-       InsetTabular: This shouldn't be too hard, but will need doing.
-       InsetTOC: We should just be able to use what we have in the TOC. To get links to
-               work, though, we'll need to co-ordinate the writing of anchors in the sections,
-               which won't actually happen until later.
-
-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.