]> git.lyx.org Git - lyx.git/blobdiff - development/HTML/HTML.notes
CSS for InsetInfo.
[lyx.git] / development / HTML / HTML.notes
index d44a5941fca39cd297faf66287f47790e4ebc7f7..e9427d5cfca87aa07508eb3c0a7b32c7f6ab6d36 100644 (file)
@@ -1,38 +1,56 @@
 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:
-       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
 
 These insets do nothing for XHTML:
        ERT, OptArg, Phantom
 
 These insets work but still need work:
-       InsetBox: We need a Length::asHTML() method and the like, but it basically works.
-               though the CSS isn't there yet.
+       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.
+       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.
 
 These insets do not work but should be completely straightforward:
-       Caption, Flex (uses collapsable)
+       Caption
+
+These insets do not work and are not yet scheduled to work:
+       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:
-       InsetBibitem: Should be fairly straightforward, in itself, actually.
-       InsetBibtex: We should be able to collect the keys of references in
-               validate() and then use our parsed information to output some sort of
-               bibliography. Formatting is another question, but here again we could
-               try parsing the bbl file.
-       InsetCitation: I think we'll want to do something here involving reference keys.
-               Maybe for the beginning, we should just do everything numerically, but even
-               that will need a bit of work. Validation is our friend, presumably.
-       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
@@ -44,20 +62,14 @@ 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: Not clear whether to do anything with this or not. Certainly it's an 
-               "advanced" case.
-       InsetInfo: Probably skip it.
        InsetListings: Probably just output it as <pre>.
-       InsetMarginal: Fine, but will need CSS.
-       InsetNomencl: 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.
        InsetTabular: This shouldn't be too hard, but will need doing.
-       InsetTOC: Here again, validation might do the trick, but I'm not sure. Or perhaps some
-               kind of post-processing? Another option, maybe the best option, would be just to use
-               the information we already have in the TOC.
-       InsetVSpace: This will be easy, once we have the Length::asHTML() method.
+       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.