String paragraph tags in cross-ref format

Is there a way to string together Paragraph tags in a cross-reference format?
I have a document with two Paragraph tags: ManualTitle and ManualSubtitle. In another document, I would like to insert a cross-ref to the first document that contains ManualTitle and ManualSubtitle.
This is what I tried to no avail:
See <$paratext[ManualTitle]> <$paratext[ManualSubtitle]> for more information.
Because I have to select a Paragraph format when applying a cross-reference, I am only allowed to select either ManualTitle or ManualSubtitle. So...if I select ManualTitle, it only shows the text applied with ManualTitle (which, incidentally, is a variable). If I select ManualSubtitle, it only shows the text applied with ManualSubtitle (which is also a variable).
Do I have to manually concatenate these two by simply making 1 cross-ref for
See <$paratext[ManualTitle]>
and another for
<$paratext[ManualSubtitle]> for more information. ???
Thanks in advance!
Anne

Anne,
In order to reference multiple paratags, you need to first manually
insert a cross-reference marker (and use the titling as the content
for the marker) in the document that contains the Title and Subtitle
tags. The best location for the marker would be at the end of the
sub-title, keeping in mind FM's behaviour of searching backwards from
a specified location to find matches.
Then, in the document that you wish to insert the cross-reference,
make sure that you have the Cross-Reference "Source Type:" set to be
"Cross-Reference Markers". Once you point it to the file with the
titles, the cross-ref dialogue should show you the appropriate marker
target(s). Select that target.
Now you can edit the cross-ref format to include the paragraphs as you
initially tried. FM will now search backwards from the marker location
in the target document to satisfy the criteria of your format request
and find both the ManualSubTitle and ManualTitle paragraphs.

Similar Messages

Reloading DITA file with xref gives UNDEFINED CROSS-REF FORMAT! in FM8

Hi,
I'm using structured FrameMaker to author DITA files that are to be converted into .chm and pdf. I'm using fm-xref for hyperlinks to preserve the linking in the pdf output. However, I don't want to use the pre-defined cross reference formats (e.g. Figure, See_Title_and_Page) and so I defined my own (simply using the <paratext> building block).
However, when I reload the document, my new format is lost and it results in an UNDEFINED CROSS-REF FORMAT! message in place of my cross-reference. I've also tried changing an existing format but it reverts back to the original when I reload the document.
Is there somewhere that I can change the default cross-reference formats permanently?
Grateful for help.
Thanks,
Ian

Hi Ian...
You need to add the new cross-ref formats into the template(s) in order for them to be available in your documents.
...scott

Removing some chapters and cross-reference formats in the conversion

Hi everyone!
I am using Frame and RH to single source creating PDFs and online help. I create the PDFs from FrameMaker, and Webhelp from RH. I use the RH linking functionality.
Is there any way to exclude some FM chapters from being converted, without using the Exclude option in FM, and instead using an option available in RH?
Also, is there a way to exclude certain cross-reference formats from being converted at all? I don't want to convert them to Paratext, I just want them to not appear in online help output at all (things like "procedure 1-1").
Thanks.
Sue

I think the only ways to exclude stuff would be to use the Exclude option in FM (as you mention - I've never tried it with RH) or to create a different book that only has the chapters you want to bring over to RH. I do something like that when I do my printed PDFs - I create a "Print-Only" book in which I go through and set the page numbering and conditional text expressions.
To exclude the cross-ref format, I've seen a hint that says to just put a space overtop of the style in the Conversion Settings. It still comes over, but just as a blank space.

Cross-refs don't convert when using DropDownCaption/DropDownBody

Using TCS 2.5 (RoboHelp 8.0.2.208 / Frame 9). I am current with all updates for this version.
I'm still in the process of setting up our templates for converting our books from Frame to RoboHelp using the "linking" ability in RH. I have run into a problem where cross references in some topics fail to convert when generating the HTML in RoboHelp. The HTML for these xrefs turns out something like this:
<p class="FM_Body">This will be an x-ref to the second topic: <a>“This is the Second Topic” on page 1</a>.</p>
The href portion is missing so of course the link does not work.
After much troubleshooting and experimenting, it appears this problem is only occuring in topics where I used the DropDownCaption and DropDownBody formats in Frame to create DHTML effects. In other words, something about the code that creates the drop-down text effect prevents RH from properly creating OTHER xrefs in the topic.
If I go back to Frame and eliminate the DropDownCaption/DropDownBody paragraphs (either deleting them or changing the text to use a different paragraph tag) and regenerate, the bad cross-references start working again.
Has anyone else encountered this? Are there any work-arounds OTHER than just not using the DropDown tags in Frame?
Since going through our very large projects in RH with every update and editing to add the drop-down effect effect in would be ridiculously time consuming (and defeats the point of single sourcing), we basically won't be able to have normal drop-down text in our help system at all. Not a very good work-around. But it is all I can think of at the moment.
I did submit this using the bug submission form on the Adobe site, but I was hoping someone else who has encountered this might have found a better work around.
Thanks!
Sara

Following are the solutions/workarounds available for this issue.
1. In RoboHelp 8(TCS 2), you can try importing(File->Import->FrameMaker Document) a FM document(in place of linking) for documents having such an issue. The document is converted fine while importing.
2. In RoboHelp 9(TCS 3), the issue has been fixed and works fine for both Import and Link functionalities. You may download a trial version of RoboHelp 9 and explore the functionality.

Colour confusion in cross-reference format -- help!?

(FrameMaker version 8.0p277)
We recently applied revised templates to our documents and I am not having problems with my cross-reference formats.
When setting an xref to a heading/table/figure on another page, I want it to say (for example) "Figure 2-3 on page 17", where "Figure 2-1" is blue, and "on page 17" is the default text colour (for these docs, that would be black).
When I insert an xref and choose a display format as described above, the text appears properly (blue, then black).
However, when I update the book, many of the xrefs (but not all) change to all blue text. (For example, Figure 2-1, 2-2, 2-5 are okay, but 2-3 and 2-4 appear all in blue.)
Here is the xref format definition for figures:
<bluetext>Figure\ <$paranumonly><Default ¶ Font> on page\ <$pagenum>
where <bluetext> is a character format (all 'as-is', except Color is set to Blue).
So far, I am the only one who has had this problem (three other writers using Frame 8 as well), but I'm the only one working on this particular set of documents.
Anybody have any hints as to how to resolve this? I have found limited success with copying/pasting the encompassing content (for example, if xrefing to a heading in a cell of a given table row, copy and paste the entire row, then delete the original row fixes the problem. *Sometimes*. Same for table xref (replace entire table), figure xref (replace figure and caption and some surrounding body text), heading (replace heading plus some surrounding body text).
I'm at a loss.
Thanks

And... I think I have it (sorry to have dragged you all along for the ride :-)
With the Character Designer displayed, moved cursor through text. Found that the Character Tag field changed to <Blue> after the last character of the offending x-refs. <Blue> was an old tag used in the previous template. It does *not* appear in the character font catalog (and does not appear in the drop-down character tag list either).
Solution (it seems):Select the text section and apply the DefaultFont format (everything goes black). Then update the book. Most of the xrefs display correctly. Some, however, remain all black. Double-click the xref and then click Replace, and it now has the proper format.
Will go through doc and do updates -- if more problems arise, will let you know!
(As an aside... if somebody can explain what is actually happening in a clear way, that would be great :-)
Thanks again.

How do I exclude one cross reference format?

Version: TCS2: Framemaker 9, Robohelp 8, both fully patched.
I have a gazillion cross-references to figures (images) in my Framemaker manual. Due to executive decision, these images are not being ported over to Robohelp-- I set their paragraph style to not import at all.
However, I cannot figure out for the life of me how to get Robohelp to IGNORE the cross-references of the type called "Figure." For that matter, I can't get Robohelp to give those a style, like "Hidden" that I could then use CSS to hide.
How do I get Robohelp to excluse/not import all cross-references of a specific format?

An alternate approach might be to create a new FM template that has those cross-references re-defined to nothing (i.e. no content except for a thin-space character - FM needs something there, but a thin space shouldn't be hardly noticeable). Then have this template applied when importing the FM content into RH. This would effectively not show those cross-refs.

Creating a list of cross-reference formats

Is it possible to create a list of used/unused cross-reference formats?
I've been able to create a list of paragraph tags used in a book file, which was very helpful in my current project. I was hoping there would be something similar for the user-defined cross-reference formats. I've also created a list of the cross-references, but I'm looking for a list of the actual formats.
Using FM10, unstructured

PamelaAnnG wrote:
Is it possible to create a list of used/unused cross-reference formats?
I've been able to create a list of paragraph tags used in a book file, which was very helpful in my current project. I was hoping there would be something similar for the user-defined cross-reference formats. I've also created a list of the cross-references, but I'm looking for a list of the actual formats.
Using FM10, unstructured
Hi, Pamela:
Search Google for "squidds AND FrameMaker" with quotes and capital AND to find their commercial Toolbox tool that seems to claim it can do this. It's not cheap, however.
The free way is to:
* Save a FrameMaker file with FIle > Save As > MIF.
* Search Google for terms like "FrameMaker MIF manual online pdf" without quotes, and search within it for "cross-reference formats" without quotes to see how the formats are encoded.
* Search Google for "mifbrowse.zip" to find a tool that can help you find the term in a FrameMaker file you save as MIF. Open mifbrowse and use File > Open to locate the MIF file, or drag the MIF file from a Windows Explorer window into mifbrowse's left pane. Click Search and type in the term you've found in the MIF manual, that identifies the beginning of the collected formats.
* Copy and paste the format definitions. You may need to translate some of the notations in the formats. I can't remember where to look for them, but if you have trouble, start a new thread with some of the puzzling notations and ask where to find translations.
HTH
Regards,
Peter
Peter Gold
KnowHow ProServices

Cross-reference formatting

Hello:
In one of my documents, I've increased the font size of the body tag but now my cross references look smaller than the surrounding text. They appear to be wrapped in a body tag but the font and point size pull-downs in the toolbar appear blank when you click on a cross reference. I'm sure that it must be something easy but I can't seem to figure out why this occurs. Can someone enlighten me AND give me a fix? I'm using v8.0p277.
Thanks for your assistance!
Kimberly

Assuming that you have a character tag around the cross-refs, e.g. one named "SpecialLinkColor" that turns text to Magenta:
In MIFBrowser, or in a text editor, you'd be looking first for the section called "FontCatalog", which is the MIF-speak term for the Character tags catalog.
Then look at the properties that are listed within the FontCatalog for the "Font" that has the FTag name of "SpecialLinkColor".
So for example if SpecialLinkColor chartag is only supposed to change the color of the text it's applied to, the only property of the tag should be "FColor = 'Magenta" [along with the default properties of the FLocked= and FSeparation=]
There should be nothing else like FFamily=xx or FSize=xx.
If there are other properties like FSize, then that means that the character tag is applying all of those properties to the text.
If this is the case then would need to change the character tag to only apply the color (or whatever) property.
Changing a character tag takes a little more finesse, so let's start with just determining if there are character tags applied to the text and then what the character tag properties are, then we'll address how to globally change it to apply only the one property rather than the font size etc etc.
BIG reminder, please be sure to make a good backup of your files before creating the MIF or looking at it in a text editor, so that "inevitable things" don't go bump.

Make new paragraph tag available in all documents in a book

I'm very new to FM10, so please excuse my ignorance.
All I want to do is make a custom paragraph available in all the chapters
of my book. I created a variation of Heading2 (and gave it the paragraph tag
of H2), in one chapter and use it extensively there.
I checked the "add to catalog" box when I created it, but when I'm working on
the other documents (chapters) in the book, H2 doesn't show up in the
paragraph catalog .
After failing to make "import format" work, I even tried to re-create the same H2
paragraph from scratch in one of the the other chapters.
But to add insult to injury, after typing in all the custom H2 characteristics in that
other chapter, and attempting to put in the catalog (which was not showing
an H2 in that chapter), FM told me that it couldn't do it because there was already
a paragraph tag of that name in the catalog.
At that point I decided to throw myself on the mercy of the forum.
Cheers,
JP

JP,
Open the file in which you created the H2 tag. In the book file, select all. Then with the book file selected, select File > Import > Formats. In the dialog, deselect all and then select paragraph formats. From the dropdown at the top, select the open file. Click OK, or whatever. This copies all the paragraph formats from the open file into all the selected files of the book. IF an H2 tag already exists in any of the files in the book, it is overwritten. No tags NOT in the open file are deleted.
After failing to make "import format" work, I even tried to re-create the same H2
paragraph from scratch in one of the the other chapters.
But to add insult to injury, after typing in all the custom H2 characteristics in that
other chapter, and attempting to put in the catalog (which was not showing
an H2 in that chapter), FM told me that it couldn't do it because there was already
a paragraph tag of that name in the catalog.
The second paragraph implies that the import format DID work. What do you mean by failing to make import format work?
Van

Unwanted paragraph tag after text inset

9.0p255 on XP ... Just searched the forum for a reminder, as it's not every day I need to work with insets. A couple of posts towards the top of a long thread gave the tip of leaving a special space between the anchor for the inset and the end-of-paragraph marker; "ah, that sounds familiar!" I thought, and tried it. Well, it may sound familiar ... but it doesn't work. Yes, I've already tried a special paragraph style with space above and below set to -2; no luck there either. All the more annoying since I'm fairly sure I did manage to do it in another file-set/on another PC last year. Thanks in advance for any tips!

Niels -
I am stuck in Frame 7.0p577 on Mac (having not yet invested in emulators etc.), so what I say here may not apply to Frame 9 on Windows – but it probably does. I am very familiar with the iceberg of an issue whose tip you have encountered. As I see it, here's what's up:
When Frame imports a text inset, it takes the end-of-flow and turns it into an end-of-paragraph (displayed with ¶ at its end, assuming you have Display Text Symbols turned on in View Options). Provided that the inset is followed by another paragraph, then all is well. However, the creation of this extra paragraph is insidious in cases where the inset lies at the end of a flow.
First, if the inset ends a document, an extra line results; that extra line is troublesome if it pushes over a page boundary. The workaround is to increase the height of the page frame, to make room for the line without spilling onto a new page, but that's messy because the manual height adjustment needs to be adjusted again if subsequent editing changes the placement of the extra line.
Second, it seems that the extra paragraph takes the paragraph tag – and therefore, the paragraph formatting – of the FIRST paragraph in the inset. If the first paragraph of the inset's source flow has an autonumber, then the stray paragraph after the inset will appear with ANOTHER autonumber of that style.
Third, if an inset is placed in a table cell, the extra line causes the height of that cell to increase. In the common case that the cell then exceeds the height of other cells in the row, the height of the entire row will increase, leaving undesired space. Workarounds such as manually limiting row height are a pain.
Fourth, if the inset is placed in a footnote, the extra line causes the footnote height of that cell to increase, leaving unwanted space between footnotes of at the bottom of the page.
Over the years I have adopted the following technique: At the front of flows liable to be used as inset sources, I have an empty paragraph tagged BOF. I set the BOF format in both the source document and the host document to Run-In. Any autonumbering in the first functional paragraph of the source will then be prevented from being carried into the referring document. You might think that a comparable paragraph at the end of the inset source – EOF, maybe – would defeat the insidious behaviour that I describe, but too much of this and things start to fail.
I have one or two additional ideas in case anyone who made it this far wishes to contact me directly. In fact I'd be delighted for anyone who understands any of the above to contact me!
I would be delighted if someone at Adobe would follow-up on this, but honestly don’t expect too much.
- Charles,
www dot Poynton dot com

Keyboard shortcut to apply paragraph tag

I'm experienced with FrameMaker 8, but just starting to get used to FrameMaker 9. A keyboard shortcut I use constantly in FrameMaker 8 is Ctrl-9, type the first letter of the paragraph tag and hit Enter. If there is more than one tag starting with the same letter, I just keep hitting that letter until the tag I want appears. For example if there's a Heading1 and a Heading2, I type 'h' two times to get Heading2. With FrameMaker 9, it seems that I have to type the whole word 'Heading2' before hitting Enter.
Frustrating when favorite shortcuts are messed up. Is there any way to get my old shortcut back? Is there a fast way to apply paragraph tags in FrameMaker 9?

jay fresno wrote:
I'm experienced with FrameMaker 8, but just starting to get used to FrameMaker 9. A keyboard shortcut I use constantly in FrameMaker 8 is Ctrl-9, type the first letter of the paragraph tag and hit Enter. If there is more than one tag starting with the same letter, I just keep hitting that letter until the tag I want appears. For example if there's a Heading1 and a Heading2, I type 'h' two times to get Heading2. With FrameMaker 9, it seems that I have to type the whole word 'Heading2' before hitting Enter.
Frustrating when favorite shortcuts are messed up. Is there any way to get my old shortcut back? Is there a fast way to apply paragraph tags in FrameMaker 9?
Type Down Arrow after selecting the first of similar format names. For example, Ctrl+9 H DnArrow moves to Heading2, or whatever is the second format that begins with "H".
Consider using format names that have fewer identical leading characters. For example:
1H Heading1
2H Heading2
1N Numbered1
N Numbered
Typing 1 brings up 1H Heading1; DnArrow moves to 1N Numbered1.
Some folks separate the abbreviation from the full name with an underscore instead of a space; i. e., 1H_Heading1, instead of 1H Heading1.
HTH
Regards,
Peter
Peter Gold
KnowHow ProServices

Upgrade problem w/Wingding symbols in paragraph tags

We just were upgraded from 7.2 to 8. One manual created under 7.2 has a paragraph tag formated with a wingding symbols of a large black circle. In 7.2, this symbols was copied in from the character map in Windows XP.
In 8, the large black circle symbol translates as a hand. We tried other circle symbols and none work as circle symbols - they appear as other symbols in the character map. The original circle symbols was part of the Character map WingDing 2, but I've tried it using Wingdings, WingDing 2, and Webdings.
Has anyone else had this problem - Is it a known bug with a patch available? Does anyone have a fix?
Upgrading to Windows 7 or Frame 9 or 10 is not an option.

The difference you're seeing is almost certainly because of the change in FM8 to use Unicode font encoding. I seem to recall that a few popular Wingding characters are actually are actually "unavailable" in FM after the switch, and folks have had to either change the symbol they use, or change to a different Wingding version (usually a purchased one) in order to get the desired character.
First, though, be absolutely certain that you're using the latest update available for FM8, as shown in Help > About, and listed here:
http://www.adobe.com/support/downloads/product.jsp?product=22&platform=Windows
as I believe there were some character location changes in the patches.
Also, using the tool to search FM forums on the upper right of the main FM page,
you should find quite a lot of info about the character change searching for "Unicode"

Feature request: Heading Tags and Paragraph Tags for Text element

Sugestion: Would like to see Reflow be able to format text element with heading tags like <h1> and paragraph tag <p>.

Thanks! Style management and reusable styles are a HUGE feature set coming to Reflow...won't be there immediately but very soon. Thanks for the input.

Global change of paragraph tags

I need to change like a hundred heading2s into heading3s, and heading3s into heading4s. I could do a find for each para tag and manually change it to a different heading tag, but I am hoping there is an easier way. Is there a way to select say 50 pages and globally change paragraph tags?
Bill

Tim1911 wrote:
This works great, but only for a single file.
Is there any way to apply the Global Update Options to every file in a book file (i.e., every chapter in a book)?
Thanks.
* Make a safety backup of all files that you'll work with.
* Change the definitions in a single file, then include that file in a book with all the files that you want to change to the same new definition.
* Save the changed file.
* Use Shift+File > Open All Files in Book; when you do the import below, all open files will be changed as you command, but will not be saved, so you can back out of the changes, if you discover unwanted results, by closing the files without saving.
* Select all the files in the book window.
* Use File > Import > Formats.
* Choose the changed file as the source; turn off all the items except the paragraph formats (and character formats if you want them changed).
* Click Set.
* Inspect the open files for correctness.
* When you're sure all changes are OK, from the book window choose Shift+File > Save All Files In Book.
HTH
Regards,
Peter
Peter Gold
KnowHow ProServices

Reapplying paragraph tags in Frame 9

How do you reapply a paragraph tag that has an override in FrameMaker 9? In FM7, you simply clicked in the paragraph, then selected the tag from the dropdown list. FM let you know the override was successfully removed by removing the asterisk (*) in the lower left corner. Now that no longer seems to work.

Yes, that's correct with FrameMaker 9 you must find a new way to
reapply a paragraph tag:
Locate the paragraph with paragraph format and asterisk (*)
Open the Paragraph Catalog and reselect the paragraph format.
Result: The paragraph with the local override will be reapply from the catalog format.
If want to get a list of all overrides, take TOOLBOX for® FrameMaker, feature: "List a paragraph overrides",
then there are features to solve it: "Apply paragraph property changes in all open books" ...
www.toolboxforme.com
- Georg

String paragraph tags in cross-ref format

Similar Messages

Maybe you are looking for