Skip to main content
Inspiring
June 16, 2008
Question

Graphics linked from FM reference pages don't display

  • June 16, 2008
  • 4 replies
  • 1725 views
Before I tell my department that they must edit each of the hundreds of caution and warning notes in thousands of pages:

Is it true to say that graphics linked from reference page in FM do not appear in help files?
This is a commonly use style:
Paragraph Designer / Advanced tab / Frame Below Pgf

This topic has been closed for replies.

4 replies

Matt-Tech Comm Tools
Community Expert
Community Expert
September 5, 2008
Actually, I don't see this as a bug at all, but by design. I also hope the engineers were aware of how graphics can be referenced thru the Para Designer! ;^)

The referenced graphics are formatting, and just like Master Page items, are dropped when outputting to online formats.

Your notes can be easily reformatted using the fmstyles.css to include any lines above and below, as well as a custom bullet, which would be your referenced graphic from the Ref Page.

As with much of your formatting, the "devil is in the details" of your CSS formatting. Focus your effort on understanding the mapping to fmstyles.css and the editing of that file (I currently use Dreamweaver to edit CSS, for its more intuitive and direct css editing capabilities)

-Matt
-Matt Sullivan, FrameMaker Course Creator, Author, Trainer, Consultant
Participating Frequently
June 27, 2008
Mary Ann,

Please make sure that all your images are placed in an anchored frame and you will be able to see all those in your output.

Hope this helps!
Regards,
Pooja
Maryann8Author
Inspiring
June 27, 2008
Not much help.

When designing FrameMaker templates, it is a commonly used style to link graphics to a paragraph tag (Paragraph tag designer/ Advanced tab). The graphics are linked to from the reference page, and when these graphics appear on the page (as a result of applying the paragraph tag) they do not use an anchored frame.

I hope you are working on this. It is a serious bug.

To duplicate the problem:
On a reference page, import a few icons and name them.
In Paragraph Designer, design a new paragraph tag, and in the Advanced tab, link to to one of the graphics.
On your body page, use the new paragraph tag.
Notice how the graphic shows up automatically?
FrameMaker users all over the world use this technique to add warning icons to their documents.

Now convert this FrameMaker document to a RoboHelp produced .chm file.
Notice how the graphic does not show up?

Thanks for your concern.
Mary Ann Howell
Adobe Certified Trainer, FrameMaker
Inspiring
September 3, 2008
Hi Maryann8

Thanks for your feedback. We will consider this for the next version.

regards
Vivek Jain (vivekj at adobe dot com)
June 17, 2008
We have a similar issue. Notes and warnings in the FM sources have a small image displayed next to them which is linked from the ref page. No solution yet. We are considering changing all notes in all documents to another format.
Maryann8Author
Inspiring
June 20, 2008
Matthew Ellison- the baggage file idea was a help. Thanks!

Here is the only way I could get the reference page graphic to display in a .chm help project.
And note, this method does not use FrameMaker's graphic, this method re-introduces the same graphic into RoboHelp by including it in as a background image in a css file.

- In Robohelp Project Manager, I must link to the graphic as baggage item
- The FrameMaker para tag must be mapped in RoboHelp (Properties, Style Mappings) to a special css style that includes the graphic as a background image (see example below).
- The graphic must appear in Project Manager list of images for the project file for the framemaker chapter.
- And here's the deal killer, in order for the graphic to appear in the project file for the FM chapter,
I must use the graphic somewhere in the FrameMaker as a discrete graphic. (It's not enough to just include the graphic in the folder using windows explorer.)
So each chapter of FrameMaker must include a page displaying any icons being used in that chapter (can't refer to the reference page, must be linked to outside file)
Weird.

And there goes another day of my time...


css style definition for paragraph tag with linked icon:

P.note_elect_warn {
background-image: url(electric.png);
background-repeat: no-repeat;
background-position: 16px 28px;
height: 100px;
width: 100px;
font-family: Arial, Helvetica, sans-serif;
font-size: 20px;
font-weight: bold;
color: #0033FF;
text-align: center;
}

PS I do all my stylesheet editing in Dreamweaver, and I don't have a problem, as long as I:
- Remember to save the css file before I run RoboHelp.
- Allow Dreamweaver file to accept outside edits to the css file, and reload the css file.

PS 2
In the CSS definition, the background-image must be in the same folder. In other words, this won't work:
background-image: url(icons/electric.png);
only this:
background-image: url(electric.png);

PS3
A FrameMaker paragraph tag that consists only of autonumber text will not be picked up for mapping.
You can force RoboHelp to notice the FrameMaker paragraph tag by typing in a few letters where the tag appears on your FrameMaker page (which you can later remove, and the style will remain).

For example, if you have a paragraph tag with Autonumber text that places the word Thanks!, RoboHelp ignores it unless you add some content to the the paragraph tag on the page, like Thanks! ...for all the fish...
Later, you can remove ...all the fish...
Maryann8Author
Inspiring
June 24, 2008
I have not heard from our friends from Adobe.
So I guess this is something RoboHelp cannot handle.

Since my fix is completely impractical, I will go ahead and rework the hundreds of warning notes linked to reference page icons in all our books. We'll have to link to the icons in an outside folder, rather than using the reference page.
June 16, 2008
Oh boy... don't hit send yet...
Import the image in *one* file adjacent to whatever style you need an image near..
Save that file out to MIF.
In the MIF file, locate exactly how the image is represented and copy that code snippet.
Then...
Save your book(s?) out to MIF, write a little script, or do a search and replace in a text editor to stick the snippet in in, in relation to the desired paragraph styles.
Save all your files and open them in Frame.
Done.

Maryann8Author
Inspiring
June 16, 2008
^^&&^^,
thanks your further ideas.
But I don't consider that a reasonable single source work flow.