X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=development%2FHTML%2FHTML.notes;h=e41e617de46731501199e37bf43b79f4f7ba88eb;hb=04cf47f46c4b99a2e39d76117b327696c791ee72;hp=e9427d5cfca87aa07508eb3c0a7b32c7f6ab6d36;hpb=082ec01eef119aa0379228aff5f134a0378d809c;p=lyx.git
diff --git a/development/HTML/HTML.notes b/development/HTML/HTML.notes
index e9427d5cfc..e41e617de4 100644
--- a/development/HTML/HTML.notes
+++ b/development/HTML/HTML.notes
@@ -1,79 +1,46 @@
-The main output routines now more or less work.
-
-Known issues:
-* InsetLine normally appears in a standard environment, which puts
inside
- , in violation of the DTD. I guess we could close the paragraph and then do
- the
, 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 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, 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:
- 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.
+ 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.
+ 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 but should be completely straightforward:
- 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:
- 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.
- InsetListings: Probably just output it as .
- 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.
- 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
- we get from instant preview and copy those over to the output directory, and then try
- to make MathML 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.