]> git.lyx.org Git - lyx.git/blobdiff - development/HTML/HTML.notes
scons too
[lyx.git] / development / HTML / HTML.notes
index 076bf058fdb1e8ef2e155ec1f1b1671c326a9ee7..2bc429a07945edc1654df97d08ace85bd0891e7d 100644 (file)
@@ -5,27 +5,36 @@ Known issues:
        <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.
+* 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, Collapsable, Footnote, Hyperlink, Label, Line, Note, 
-       Newline, Newpage, Quotes, Space, SpecialChar
+       Bibitem, Branch, Caption, Collapsable, Footnote, Hyperlink, Include, 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.
-               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.
+       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.
+               - 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
@@ -37,34 +46,24 @@ These insets work but still need work:
                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.
-
-These insets do not work but should be completely straightforward:
-       Caption
+       InsetFloat: This seems to work OK, but it will need testing and tweaking.
 
 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 
+               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:
-       InsetExternal: I don't understand these so am not sure what to do.
-       InsetFloat: This will need some work, again because I do not really understand
-               what these are meant to do. Presumably, we'll just use a div or something, but
-               it's not clear what subfloat means, etc.
        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.
-       InsetInfo: Probably skip it.
-       InsetListings: Probably just output it as <pre>.
-       InsetMarginal: Fine, but will need CSS.
-       InsetNomencl and InsetPrintNomencl: Also "advanced".
        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.
@@ -72,8 +71,6 @@ These do not yet work and need some attention:
        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.
-       InsetWrap: This should be simple enough, probably a div and some CSS, but I'm not sure
-               precisely what this is supposed to do.
 
 MATH
        Regarding math, the view seems to be that we should in the first instance just use what