Exit
  • Global community
    • Language:
      • Deutsch
      • English
      • Español
      • Français
      • Português
  • 日本語コミュニティ
  • 한국 커뮤니티
0

FM2022 HTML5 unstructured output template - Home file questions

New Here ,
Apr 24, 2025 Apr 24, 2025

Hello FM community,

I am creating an output template for FM2022 for HTML5 output from unstructured FM books. I have two

issues with output that I have not been able to resolve.

 

Issue with navigation menu entry for the home page:

We have been using this method in the past (FM2017/FM2019), and I have found that a workaround that was possible in 2017/2019 does not work in 2022.

The entry for the home page in the HTML5 navigation menu is not displaying the correct text for the home page. In past versions of FrameMaker, it was possible to save the FM document for the home page as a MIF file, search for the PDFDocInfo section, edit the Title value, remove a string of nonsensical numbers from PDFDocInfo, and save the MIF back to FM document. After doing so, the correct title would appear in the HTML5 navigation menu.

In FM2022, if I do the same process, the navigation title still does not appear correctly, and additionally, the main title of the entire document disappears completely from the HTML5 output, from the displayed content and from the source HTML pages:

Before:

main_title_before.pngexpand imagediv_title_before.pngexpand image

After:

dfc9a597-06ea-40d8-a3f6-f3ee675743a8.pngexpand image

div_title_after.pngexpand image

It also happens if I edit certain variables in the home page fm file. It appears to be irreversible. Once I edit the file in this way, nothing I do makes the title appear again.

 

Issue with size of the Logo file in the page output:

The size of the company logo always comes out the same--square and very small--regardless of the size and dimensions of the file that I insert in the template. I located the css page where this is controlled, and it is the one that is part of the Azue blue responsive template. I can manually edit the CSS on the output to change the div size that holds this logo, and it displays the way I want it to. However, when I add an override in Options > Override Styles for this Output, it does nothing, even if I make it important (I also tried adding it to the style mapping CSS, but that did not work either). I tried to export and reimport the entire Azure_blue layout, and edit just that stylesheet before reimporting. This ruined the output completely and I could not further edit that sts version. 

 

Does anyone know a workaround for either of these issues? 

 

Thanks,

Robin

TOPICS
Publishing , Responsive HTML5
307
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 24, 2025 Apr 24, 2025

Issue with navigation menu entry for the home page
I'm unsure figuring out just what you're talking about here - maybe some screenshots of what the problem is (without mucking around in MIF files or anything) and why you felt it was necessary to hack them in prior versions?

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 24, 2025 Apr 24, 2025

Hi Jeff, thank you for replying 🙂 

One issue is that the navigation panel does not display the correct text for the first page:

wrong_toc_entry.pngexpand image

Currently it is picking up a line of variables from the file. The information I have about why it was originally hacked with the MIF washing in FM2017/2019 was that it would sometimes display the filename and you could edit it to display "Home" or your chosen text instead. (I did not work here when the original workaround was documented and I could not find FM documentation about how to troubleshoot these things.) I can edit the PDFDocInfo title field by right clicking the file and choosing File Info, but there must have been some reason why the edits did not "stick" unless made in the MIF file.

If I edit the copyright variable definition that appears in this line, the title of the document disappears from generated HTML5 output.

 

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 24, 2025 Apr 24, 2025

Umm, I'm still not quite following - your screenshot is showing the landing page of your output? And if so, the issue is that you don't want that first TOC item to say "323-1851-165 - Standard Issue..." ?

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 24, 2025 Apr 24, 2025

Yes, that is correct. I want the TOC entry for that page to say "Home" or  something other than the list of variables.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 24, 2025 Apr 24, 2025

It seems to be taking the first line it finds. But this is the first line of Flow B, not even Flow A.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 24, 2025 Apr 24, 2025

What's the FM TOC look like?

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 24, 2025 Apr 24, 2025

Hi Jeff,

Here is what the TOC looks like. I also included a view of the book file organization.

book_toc.pngexpand image

 

book_order.pngexpand image

The TOC is second in the order. Among the things I tried was to remove the TOC before generating the HTML output. In this case, the Home file came out named correctly, but a new problem occurred. The new problem was that every chapter came out with a double-nested topic. As in, I had to expand an empty topic to get to the real start topic in each chapter. And when I put the TOC back on, it was no longer identified as a generated topic with the darker icon.

I also tried rearranging the topics before generation, with the TOC first. This did not solve my problem either.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 25, 2025 Apr 25, 2025

Fm needs the TOC to properly configure the HTML, so that behavior when you removed the TOC is expected.

Can you reconfigure your file so that the variables are not the first thing found in the flow?

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025

Hi Matt, I did not see this message earlier. All of the cover text is coming from variables. There are 3 flows: Flow A has product name and book name, Flow B is the publishing variables including the date and copyright, and Flow C is a text inset with a long copyright statement. All the flows are in the output document, but for some reason it switched the order of Flows A and B.
I don't know why there are 3 different flows. I assume A and B probably could have been one flow, but why it was set up this way originally might be lost in the mists of time.

I will try your suggestion below to hide a small title variable in white text in flow B and see if that solves my issue.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 24, 2025 Apr 24, 2025

This all worked in FM2019.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 24, 2025 Apr 24, 2025

And what does the Publish Settings look like?

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 24, 2025 Apr 24, 2025

Hi Jeff, it looks like this:

pub_settings1.pngexpand image

 

pub_settings2.pngexpand image

It is set up the same as it was in FM2019 (but started with a fresh settings file). There were some options in 2019 that do not exist in 2022, but we do not appear to have been using them.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 24, 2025 Apr 24, 2025

Are you adding text in the "File info" section in the FrameMaker documents?  I am not sure that is the fix in this instance, but I have often used it to make the documents name work properly in HTML5 exports.


Bjørn Smalbro - FrameMaker.dk
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025

Hi Bjørn,

Yes, thanks for suggesting this. I expected this to work because it used to work in older FM versions. I tried adding text in this File Info section. I tried both by using the FM interface and I also tried saving it as a MIF and adding the same info to the PDFDocInfo section for Title. It does not seem to work anymore in FM2022, or something else changed that I am missing.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 25, 2025 Apr 25, 2025

You mention that you're setting up a template...are you describing the Use HTML Page Template option shown below?

MattTechCommTools_0-1745594703505.pngexpand image

 

In my experience, when creating/editing an HTML template, any missteps are very difficult to remedy.

You can try resetting your preferences (close Fm, then rename the 17 directory found in your C:\Users\(USERNAME)\AppData\Roaming\Adobe\FrameMaker directory as I did for the 16 directory, and then restart Fm)

I believe that will give you fresh publish settings, including the HTML Template.

If you can't quickly figure out the solution, you can always delete your new 17 directory and rename 17x (or whatever you renamed it to) back to 17 and restart FrameMaker.

MattTechCommTools_1-1745594938682.pngexpand image

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025

Hi Matt,

I did not use this template option. I meant that I am editing these sts settings to create the "template" by which I just meant the sts file with the styles and output options. In case I touched it accidentally, I did what you suggested and reset my user folder by renaming the old one. It did not change anything in the outputs, but at least I have been able to rule this out.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025

I made a change in the source files to add a line of text before the variables that form the first line of the page. I added what I would like as the "Home" text, and it does display what I put there. I'm not sure I'd want this as a permanent solution, because writers would have to change the cover page back and forth between producing PDF or HTML output and I am sure accidental omissions would happen. But it seems to prove that whatever is the first line on this page is getting put as the navigation text, regardless of what I put in the File Info.

 

added_title_text_earlier.pngexpand image

When looking at the whole page though, it is a bit silly because this title also appears further down.

I'm wondering if there is a way to control which flow is coming out first in the HTML5 output. This is Flow B coming out first, but Flow A is first in the source file and in PDF output.

 

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 25, 2025 Apr 25, 2025

"writers would have to change the cover page back and forth between producing PDF or HTML output " - easy solution to that is to have 2 books - one for PDF output & one for online output.

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 25, 2025 Apr 25, 2025

Along with the suggestion from @Jeff_Coatsworth, consider setting the title as conditional text (perhaps a condition labeled HTML bookmark text) and set the visibility as needed when publishing.

 

Regarding the look/feel, if you only need the NBI Fundamentals for the TOC, you could bury it as 2pt white text at the top. 

 

I'm not sure about controlling the order of flow. Do you need a B flow in your doc? From memory, I thought only the main flow exported.

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 25, 2025 Apr 25, 2025

Regarding the logo, I suggest inspecting the published code, and then modifying your CSS (exporting, editing, then reimporting) to address the logo formatting.

However, you may find that switching to a more recent skin gives you more/better options. Azure's a bit long in the tooth.

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025

How does one get new skin options? This FM version includes Azure blue and I did not see other options to select. Do I have to build them myself?

For the logo, I found the CSS that controls the div size for the logo. It's in the CSS file that is generated by the Azure skin. I can edit it in the HTML output and it changes to the desired size. But if I add a CSS file to the "Override Styles for this output" section on the Publish options to make that div larger, it outputs this override CSS file but does not take effect (even if I add importance).

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025

I also did not see anything in the FM documentation about how to change the skin

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Apr 25, 2025 Apr 25, 2025

That's a great question! So, I went and recorded a quick video for you and added it to my FrameMaker Unstructured Authoring course. This should help you understand how to manage your skin choice.

https://youtu.be/wJrKxl2jacE

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant
Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Apr 25, 2025 Apr 25, 2025
LATEST

Hi Matt, thanks for providing this video and for linking your course!

Translate
Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines