HTML5: Search results - abstracts not appearing

This forum is for all Flare issues related to the HTML5, WebHelp, WebHelp Plus, and Adobe Air Targets
Post Reply
FrankyT
Propeller Head
Posts: 56
Joined: Wed Apr 04, 2012 3:45 am
Location: United Kingdom

HTML5: Search results - abstracts not appearing

Post by FrankyT »

When I run a search on a test help file, the results appear with links and paths, but no abstracts. From the Flare Help, it looks as though abstracts are derived from the start of the topic text if there is no metadata present in the topic. However, I'm getting no abstracts at all. I assume you can "switch them on" somewhere, but I can't find where, and the help doesn't seem to explain.

Am I just doing something wrong?
crdmerge
Sr. Propeller Head
Posts: 248
Joined: Tue Dec 16, 2008 5:37 am

Re: HTML5: Search results - abstracts not appearing

Post by crdmerge »

No, you're not; Madcap is.

Add your own bug report to the (I believe) many others; it's even worse in a merged project: an abstract appears only once every dozen or so results, sometimes as large as 8-10 lines worth. They're aware of it, they're working on it, you'll get email when they fix it, yada, yada, yada.


Good luck,
Leon
FrankyT
Propeller Head
Posts: 56
Joined: Wed Apr 04, 2012 3:45 am
Location: United Kingdom

Re: HTML5: Search results - abstracts not appearing

Post by FrankyT »

Thanks Leon. Glad it's not just me, but disappointed that there isn't a solution.
FrankyT
Propeller Head
Posts: 56
Joined: Wed Apr 04, 2012 3:45 am
Location: United Kingdom

Re: HTML5: Search results - abstracts not appearing

Post by FrankyT »

PS Where do I file bug reports for Flare?
crdmerge
Sr. Propeller Head
Posts: 248
Joined: Tue Dec 16, 2008 5:37 am

Re: HTML5: Search results - abstracts not appearing

Post by crdmerge »

wclass
Propellus Maximus
Posts: 1238
Joined: Mon Feb 27, 2006 5:56 am
Location: Melbourne, Australia

Re: HTML5: Search results - abstracts not appearing

Post by wclass »

FrankyT wrote:PS Where do I file bug reports for Flare?
As well as the URL given, you can find a direct link from Flare, on the Help tab of the ribbon, right at the end.
Margaret Hassall - Melbourne
kevin_c
Jr. Propeller Head
Posts: 4
Joined: Mon Oct 03, 2011 10:02 am

Re: HTML5: Search results - abstracts not appearing

Post by kevin_c »

Just wanted to pass along a fix from MadCap so others can find it when they search:
The cause of this issue is the extra schema located at the top of each of these topics.
The offending code is:
xmlns="http://www.w3.org/1999/xhtml"

I would suggest that you test one of these topics by manually deleting the xmlns="http://www.w3.org/1999/xhtml" from the source code of that topic. Then perform a test build to confirm the fix. If this works for you, then the best way to remove this this code from other topics is to do a Find & Replace in the code of all the topics and remove it.

You will want to remove the space just before it also so the MadCap Schema replaces it correctly. Notice in the instructions below, we added a space before the code in the find field.

- Open a single topic in Flare
- CTRL + F to open Find & Replace window
- Fine what field = " xmlns="http://www.w3.org/1999/xhtml""
- Replace it with nothing
- Select "Find in" (Whole project)
- Click "Match Case" and "Find in Source Code"
- Click "Find Next", you will be prompted to open the topic in as text, click Yes.
- Click Replace ALL.
- Click Start button (middle of dialog)
- Click Replace in All files
- Choose No when asked if you want to leave all files open.

Flare will go through and remove all those code references. After it is done, build and test. The abstract text will now show up.
crdmerge
Sr. Propeller Head
Posts: 248
Joined: Tue Dec 16, 2008 5:37 am

Re: HTML5: Search results - abstracts not appearing

Post by crdmerge »

I got the same response from Madcap support yesterday, and I responded with:
What about the other 30K instances of that schema, which Madcap inserted throughout the 42 topics during the conversion from RoboHelp? Can I safely remove them all? They're everywhere (table, li, ims src, a href, h1, etc.).
Their response to that was completely tone deaf (and just a little bit patronizing?):
As mentioned in the previous email, you will want to perform a global find and replace. It is a manual process because you will have first test a few topics with it to ensure that the steps I give you below are executed perfectly. So in step 5 below, first test with "current document" instead of "whole project".

Once you feel comfortable, then Replace All should be helpful. I would first recommend to make a backup of the project before proceeding with this process just in case. You can choose the Zip Project option in the Project Ribbon to make a zip copy somewhere safe.
My assumption is that this replacement only needs to be done to the <html line,

Code: Select all

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd"

since Madcap didn't replace that xmlns="http://www.w3.org/1999/xhtml" schema when converting our RoboHelp projects, but only added their own.

Sigh...



Leon
FrankyT
Propeller Head
Posts: 56
Joined: Wed Apr 04, 2012 3:45 am
Location: United Kingdom

Re: HTML5: Search results - abstracts not appearing

Post by FrankyT »

Madcap got back to me with the same response detailed by the previous posters. Well, at least now we know what the problem is and what the workaround is...

Leon - you are correct: you only need to remove the xmlns="http://www.w3.org/1999/xhtml" in the <html> tag.
Post Reply