Highlighted

Reference page graphic disappears from published .chm

Explorer ,
Apr 25, 2018

Copy link to clipboard

Copied

Hello, all.

I am using FM 2015 in a Win 10 environment.

Here is a detailed explanation of a table format using a paragraph tag that employs "frames" in a wonky way, icons, and the reference page. The explanation leads to this question: why do certain warning icons disappear from my .chm output?

Our documents contain notes, cautions, and warnings. Each has an associated icon:

NCW Examples.jpg

The Note, Caution, and Warning formats are actually tables:

NoteCautionWarningTables.jpg

Each table is a separate table format.

The Note, Caution, and Warning icons are integral to three paragraph formats: zzNote, ZZCaution, and ZZWarning. Each of these paragraph formats employs an icon graphic that is stored on the Reference page. These icons are treated like "frames," even though they are in fact graphics.

As an example, the Warning table uses the zzWarning paragraph format in the left-hand cell. It supplies the hand graphic as a frame. It is called "Warning" and is named "Warning" on the reference page:

WarningRuleSetup.jpg

On the Reference page, the Warning "frame" is actually this graphic. I typed the word "Warning" underneath the graphic, but the graphic itself is also named "Warning" (if you click on it, you see that name). Here are all three as they appear on the Reference page:

WarningFrameOnRefPage.jpg

So, the table uses the ZZWarning paragraph format in the left-hand column to populate it with the warning icon:

zzWarningTag.jpg

Whenever I insert a Warning table in a .fm file, the exclamation icon appears in the left-hand cell, and the two rules appear in the right cell. (They are attached to a "WarningText" paragraph format that calls those frames from the Reference page.)

Okaaayyyyyy.

So, when I publish a .chm from the .fm file, I get both columns of the Note, Caution, and Warning tables. In the case of the Warning tables, I get the rules above and below the text, which are also stored on the Reference page. They behave as expected. But the icons disappear.

Why do the icons drop out?

All suggestions gratefully received.

--Nancy

Correct answer by Matt S - Tech Comm Tools | Adobe Community Professional

Hi Nancy, check out the CSS Cookbook published by O'Reilly for CSS code snippets to do what you're looking for

Views

316

Likes

Translate

Translate

Report

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

Reference page graphic disappears from published .chm

Explorer ,
Apr 25, 2018

Copy link to clipboard

Copied

Hello, all.

I am using FM 2015 in a Win 10 environment.

Here is a detailed explanation of a table format using a paragraph tag that employs "frames" in a wonky way, icons, and the reference page. The explanation leads to this question: why do certain warning icons disappear from my .chm output?

Our documents contain notes, cautions, and warnings. Each has an associated icon:

NCW Examples.jpg

The Note, Caution, and Warning formats are actually tables:

NoteCautionWarningTables.jpg

Each table is a separate table format.

The Note, Caution, and Warning icons are integral to three paragraph formats: zzNote, ZZCaution, and ZZWarning. Each of these paragraph formats employs an icon graphic that is stored on the Reference page. These icons are treated like "frames," even though they are in fact graphics.

As an example, the Warning table uses the zzWarning paragraph format in the left-hand cell. It supplies the hand graphic as a frame. It is called "Warning" and is named "Warning" on the reference page:

WarningRuleSetup.jpg

On the Reference page, the Warning "frame" is actually this graphic. I typed the word "Warning" underneath the graphic, but the graphic itself is also named "Warning" (if you click on it, you see that name). Here are all three as they appear on the Reference page:

WarningFrameOnRefPage.jpg

So, the table uses the ZZWarning paragraph format in the left-hand column to populate it with the warning icon:

zzWarningTag.jpg

Whenever I insert a Warning table in a .fm file, the exclamation icon appears in the left-hand cell, and the two rules appear in the right cell. (They are attached to a "WarningText" paragraph format that calls those frames from the Reference page.)

Okaaayyyyyy.

So, when I publish a .chm from the .fm file, I get both columns of the Note, Caution, and Warning tables. In the case of the Warning tables, I get the rules above and below the text, which are also stored on the Reference page. They behave as expected. But the icons disappear.

Why do the icons drop out?

All suggestions gratefully received.

--Nancy

Correct answer by Matt S - Tech Comm Tools | Adobe Community Professional

Hi Nancy, check out the CSS Cookbook published by O'Reilly for CSS code snippets to do what you're looking for

Views

317

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Apr 25, 2018 0
Adobe Community Professional ,
Apr 25, 2018

Copy link to clipboard

Copied

Hi Nancy, the icons are dropping out because they're not actually content in your document, but are formatting applied above or below your "content" (quotes applied because your paragraph actually contains no content)

You need to map your zzWarning tag to a style defined in your CSS (perhaps named Warning). Then define the CSS style with a prefix so that the image appears.

-Matt

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 25, 2018 1
Explorer ,
Apr 26, 2018

Copy link to clipboard

Copied

Hi, Matt.

You have hit on something that I haven't been able to figure out: the relationship between a .sts file and a .css file. I have created quite a few conversion settings in the .sts file. I don't have any .css file at all. Where would I get one? Do I have to create it from scratch? I've put a lot of work into the .sts file. Do I have to abandon it?

And, once I understand that, I don't know what you mean about defining a style with a prefix in the css ...

I looked for a Youtube video on this and also poked around in your wonderful book. So far, haven't found a good resource to help me get grounded in these topics. Your suggestions are most welcome.

--Nancy

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 26, 2018 0
Explorer ,
Apr 26, 2018

Copy link to clipboard

Copied

I don't see a way to edit what I just posted less than a minute ago, so I'll add this.

I've used the Style Mapping tab in the Publish settings window. I see that this is somehow related to a .css file, even though when I search my working FM directory, it does not contain a .css. So evidently, by using the Style Mapping tab, I am in fact editing a .css, even though no such .css exists in my directory. I do not understand this. If that is the case, what is the .sts file?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 26, 2018 0
Adobe Community Professional ,
Apr 26, 2018

Copy link to clipboard

Copied

Hi Nancy, the CSS is actually part of what is stored in an STS file.

Here's a post I created that contains video with the process of editing the CSS

http://techcommtools.com/formatting-branding-html5-content-framemaker-2015/

You may also find my free mini course on HTML5 publishing useful as well...

http://techcommtools.com/free-html5-publish-training/

-Matt

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 26, 2018 1
Explorer ,
Apr 26, 2018

Copy link to clipboard

Copied

Hi, Matt! That was very helpful and I've used your technique of putting the font in a plain Body tag.

I also created a Warning tag that showed up in the Output Style drop-down list. Now to understand this prefix of which you speak. Can you point me in the right direction? I need to do something to make that .css entry recognize the graphic file for the icon that appears in the table.

Thanks again.

--Nancy

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 26, 2018 0
Adobe Community Professional ,
Apr 27, 2018

Copy link to clipboard

Copied

Hi Nancy, check out the CSS Cookbook published by O'Reilly for CSS code snippets to do what you're looking for

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 27, 2018 0
Explorer ,
Apr 30, 2018

Copy link to clipboard

Copied

The CSS Cookbook looks like an excellent resource.

Matt, I can't thank you enough for your helpfulness.

--Nancy

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 30, 2018 0
Participant ,
May 15, 2018

Copy link to clipboard

Copied

You could also apply a white font to your paragraph style for the icon and put a full stop in there so it has 'content'. I ended up treating my reference page graphics as actual graphics and pasting them into anchored frames in the body page tables for notes.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
May 15, 2018 0
Adobe Community Professional ,
Apr 26, 2018

Copy link to clipboard

Copied

Workflow issues aside, you might alert your document architect or safety coordinator that those icons may not comply with relevant safety standards (ANSI Z535 and ISO in particular).

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 26, 2018 0
Explorer ,
Apr 26, 2018

Copy link to clipboard

Copied

Thanks for those references, Bob.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Apr 26, 2018 0