Docx vs html output

Aspose.Words Product Family
1

Hi Alexey,

We are currently have 2 issues with exporting to html. Attached are the docx file and html file, the code to save aspose tree to the documents are:

inlineXbrlDoc.Save("c:\\Vob\\GitRepos\\test2.docx");
options.ExportHeadersFootersMode = ExportHeadersFootersMode.FirstPageHeaderFooterPerSection;
options.ExportXhtmlTransitional = true;
options.Encoding = Encoding.UTF8;
options.ExportImagesAsBase64 = true;
options.ImageSavingCallback = new HandleImagesSaving();
options.ExportDocumentProperties = false;
options.ExportRoundtripInformation = false;
options.PrettyFormat = true;
options.ExportListLabels = ExportListLabels.ByHtmlTags;
options.HtmlVersion = HtmlVersion.Xhtml;
inlineXbrlDoc.JoinRunsWithSameFormatting();
inlineXbrlDoc.Save("c:\\Vob\\GitRepos\\test2.html", options);
  1. If you look into the word, all the sections have headers. Two sections starting with AccurriStart_47335 and AccurriStart_47336 don’t. It’s our main issue and the showstopper. If you could let me know what’s the difference between the headers in these 2 sections and others stopping Aspose from converting these headers into HTML, I can try to workaround it (or possibly you can suggest a workaround).
  2. The footers location in html is different from the word (see the attached screenshot)
    Thank you in advance,
    Alex
    2412×1020 275 KB

    GitRepos.zip (189.5 KB)
2

@AlexanderNovickov The problem is that HTML and MS Word documents are very different in concepts. It is hard to meaningfully output headers and footers to HTML because HTML is not paginated. By default Aspose.Words exports only primary headers/footers of the document per section when saving to HTML. You can try changing ExportHeadersFootersMode to configure how headers/footers are exported to HTML, as you already do in your code.

You should note, however, that HTML documents and MS Word documents object models are quite different and it is not always possible to provide 100% fidelity after conversion one format to another.

If the output HTML is for viewing purposes, i.e. it is not supposed to be edited or processed, you can consider using HtmlFixed format. In this case the output should look exactly the same as it looks in MS Word:

Document doc = new Document(@"C:\Temp\in.docx");

HtmlFixedSaveOptions opt = new HtmlFixedSaveOptions();
opt.PrettyFormat = true;
opt.ExportEmbeddedCss = true;
opt.ExportEmbeddedFonts = true;
opt.ExportEmbeddedImages = true;
opt.ExportEmbeddedSvg = true;

doc.Save(@"C:\Temp\out_html_fixed.html", opt);

HtmlFixed format is designed to preserve original document layout for viewing purposes. So if your goal is to display the HTML on page, then this format can be considered as an alternative. But unfortunately, it does not support roundtrip to DOCX at all.

The sections starting with AccurriStart_47335 and AccurriStart_47336 have only primary headers/footers, but in your code you have specified ExportHeadersFootersMode.FirstPageHeaderFooterPerSection. In this mode, the first page header and footer are exported at the beginning and the end of each section.

As mentioned above, HTML content is not paginated, so footer is shown at the end of the section, not at the end of the page.

3

Thank you, Alexey, it was very helpful!

1 Like