]> git.lyx.org Git - lyx.git/blobdiff - development/HTML/HTML.notes
Disable XHTML output for InsetExternal---for the time being.
[lyx.git] / development / HTML / HTML.notes
index 223e1f567cd971bca735977b2d38f20e9b0c2d49..df20bbd977e2d3af3d9ecca28d5adb8e4a2988b0 100644 (file)
@@ -1,17 +1,18 @@
 The main output routines now more or less work.
 
 Known issues:
-- InsetLine normally appears in a standard environment, which puts <hr /> inside
+* 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 code that manages the nesting of tags is pretty primitive. It needs a lot
+* The same issue arises with InsetVSpace, unsurprisingly.
+* 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, Collapsable, Footnote, Hyperlink, Info, Label, Line, 
+       Marginal, Note, Newline, Newpage, Quotes, Space, SpecialChar, Wrap
 
 These insets do nothing for XHTML:
        ERT, OptArg, Phantom
@@ -25,8 +26,7 @@ These insets work but still need work:
                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.
-       InsetBox: We need a Length::asHTML() method and the like, but it basically works.
-               though the CSS isn't there yet.
+       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
@@ -41,12 +41,18 @@ These insets work but still need work:
 These insets do not work but should be completely straightforward:
        Caption
 
+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:
-       InsetCommand: By default does nothing. That may be right?
-       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.
@@ -57,13 +63,7 @@ These do not yet work and need some attention:
        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.
-       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.
-       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.
@@ -71,9 +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.
-       InsetVSpace: This will be easy, once we have the Length::asHTML() method.
-       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