Mysterious underlining of autonumbered chapter
Mysterious underlining of autonumbered chapter
I'm using autonumbering for sections and chapters. The Auto-number format for the section heading style looks like "Part {secnum}: " For the chapter style it's "Chapter {chapnum}: "
When I output to Word, my section headings are fine, but in the chapter headings, the word "Chapter", the number, colon and trailing space are underlined. The rest of the heading is not. Nothing in the style definition for the chapter style says anything about underlining. (I opened the stylesheet in a text editor to check if anything funky was hidden there.)
Here's a section heading:
And here's a chapter heading, with the mysterious underline:
Using Flare 4, output target is Word.
The project was created in an earlier version of Flare, but this behavior didn't happen in version 3, when I first implemented autonumbering for sections and chapters.
When I output to Word, my section headings are fine, but in the chapter headings, the word "Chapter", the number, colon and trailing space are underlined. The rest of the heading is not. Nothing in the style definition for the chapter style says anything about underlining. (I opened the stylesheet in a text editor to check if anything funky was hidden there.)
Here's a section heading:
And here's a chapter heading, with the mysterious underline:
Using Flare 4, output target is Word.
The project was created in an earlier version of Flare, but this behavior didn't happen in version 3, when I first implemented autonumbering for sections and chapters.
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Re: Mysterious underlining of autonumbered chapter
Figured it out. I have a bookmark and my index entries at the top of each topic, at the beginning of the heading line. For reasons lost in the mists of history, I had put the bookmark first, followed by the index entries, at the beginning of the chapter topics. However, for the part topics (the sections), the index entries were first, and then the bookmark.
So there are two possible solutions:
1. Moving the index entry to the front of the bookmark.
2. Removing the underline attribute for the a element in the css (for printed targets).
It appears that something about the bookmark tag causes the autonumber entry in the printed output to be underlined. Why it does this now in version 4, when it worked fine in v3 is something for the dev team at MadCap to figure out; probably something to do with the fact that the bookmark is an anchor (<a>) tag. Anyway, I'm logging this as a bug. You should be able to put a bookmark at the top of a topic without having to worry about what it does to your autonumbered chapters and sections.
So there are two possible solutions:
1. Moving the index entry to the front of the bookmark.
2. Removing the underline attribute for the a element in the css (for printed targets).
It appears that something about the bookmark tag causes the autonumber entry in the printed output to be underlined. Why it does this now in version 4, when it worked fine in v3 is something for the dev team at MadCap to figure out; probably something to do with the fact that the bookmark is an anchor (<a>) tag. Anyway, I'm logging this as a bug. You should be able to put a bookmark at the top of a topic without having to worry about what it does to your autonumbered chapters and sections.
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
-
- Propellus Maximus
- Posts: 1985
- Joined: Tue Jan 23, 2007 8:18 am
- Location: Darn, I knew I was around here somewhere...
Re: Mysterious underlining of autonumbered chapter
Does the anchor tag contain any content? If it does, that content will take on the style info from the anchor tag. What someone (I believe it was Lisa) suggested last week was to instead have the anchor not contain any content. Something like this:
<a name="Chapter1"></a><h1>System Setup</h1>
<a name="Chapter1"></a><h1>System Setup</h1>
Until next time....
Kevin Amery
Certified MAD for Flare
Kevin Amery
Certified MAD for Flare
Re: Mysterious underlining of autonumbered chapter
I don't select any text when creating the bookmark; I just put the insertion point at the front of the heading and press Ctrl+Shift+K (or click Insert >> Bookmark).
Here's what a bookmark looks like in the raw text of a sample topic I created to test this:
When you view the topic in the XML Editor, with the non-print medium showing, it looks like this:
With the print medium view, it's like this:
Here's what a bookmark looks like in the raw text of a sample topic I created to test this:
The "<a name="ChapterTopic"></a>" is the bookmark.<h2 class="Heading2"><a name="ChapterTopic"></a>Chapter Topic</h2>
When you view the topic in the XML Editor, with the non-print medium showing, it looks like this:
With the print medium view, it's like this:
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
-
- Propellus Maximus
- Posts: 1985
- Joined: Tue Jan 23, 2007 8:18 am
- Location: Darn, I knew I was around here somewhere...
Re: Mysterious underlining of autonumbered chapter
That will happen in the XML editor because it shows you where the bookmarks are. You can turn that off in the view settings if you want, although I don't recommend it (I prefer to see where anchors are). They won't get displayed in the output, though.
Does the sample topic have the same incorrect underlining when you actually build the output? Or does it work correctly? Also, is this the same code setup as you have in your "real" topics, or is it different?
Does the sample topic have the same incorrect underlining when you actually build the output? Or does it work correctly? Also, is this the same code setup as you have in your "real" topics, or is it different?
Until next time....
Kevin Amery
Certified MAD for Flare
Kevin Amery
Certified MAD for Flare
Re: Mysterious underlining of autonumbered chapter
The sample output has the same incorrect underlining.
This test project uses the same CSS as my main projects.
If I leave the bookmark out, there's no underline. If I insert something in front of the bookmark, like an index entry, there's no underline.
This test project uses the same CSS as my main projects.
If I leave the bookmark out, there's no underline. If I insert something in front of the bookmark, like an index entry, there's no underline.
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
-
- Propellus Maximus
- Posts: 1979
- Joined: Tue Nov 28, 2006 11:18 am
- Location: Crossroads of the West
- Contact:
Re: Mysterious underlining of autonumbered chapter
I turn off underlining for all <a> elements in my print styles. My printed targets aren't web pages, so they shouldn't look like web pages, in my opinion.
Re: Mysterious underlining of autonumbered chapter
If that works for you, great.doc_guy wrote:I turn off underlining for all <a> elements in my print styles. My printed targets aren't web pages, so they shouldn't look like web pages, in my opinion.
On the other hand, even a "print" target can be viewed online, and can have links (e.g. PDFs). In that case, I can see that someone might want a link that looks like a link.
In the present case, the formatting looks like a link, but it doesn't act like it, which is even worse than a link that doesn't look like one.
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Re: Mysterious underlining of autonumbered chapter
Just out of curiosity, if you change the code order to the following, does it help?royj wrote:<h2 class="Heading2"><a name="ChapterTopic"></a>Chapter Topic</h2>
Code: Select all
<a name="ChapterTopic"></a><h2 class="Heading2">Chapter Topic</h2>
Lisa
Eagles may soar, but weasels aren't sucked into jet engines.
Warning! Loose nut behind the keyboard.
-
- Propellus Maximus
- Posts: 1979
- Joined: Tue Nov 28, 2006 11:18 am
- Location: Crossroads of the West
- Contact:
Re: Mysterious underlining of autonumbered chapter
Good point. I find myself sometimes still thinking in Flare 3.1 mode, with Word output that I then made PDF; There were too many ways my cross links could go wrong, so my PDFs didn't have any links users could click. But I can see that with direct-to-PDF from flare that things like Cross References and links could actually be useful now, so you need a way for users to tell that the link is there.royj wrote:On the other hand, even a "print" target can be viewed online, and can have links (e.g. PDFs). In that case, I can see that someone might want a link that looks like a link.
Hope Lisa's suggestion works for that.
Re: Mysterious underlining of autonumbered chapter
Haven't tried it, and I'm not sure I will. For my project, where I have both bookmarks and index entries in all of the affected topics, it's just simpler to put the index entries in front of the bookmark.LTinker68 wrote:Just out of curiosity, if you change the code order to the following, does it help?Code: Select all
<a name="ChapterTopic"></a><h2 class="Heading2">Chapter Topic</h2>
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
-
- Propellus Maximus
- Posts: 1979
- Joined: Tue Nov 28, 2006 11:18 am
- Location: Crossroads of the West
- Contact:
Re: Mysterious underlining of autonumbered chapter
what about a custom selector:
This just removes underlines for anchor elements that are child elements in an <h2> element.
So it matches:
But doesn't match
To me this sounds easier than changing the structure of all the topics that are already written.
Code: Select all
h2 a {
text-decoration:none;
}
So it matches:
Code: Select all
<h2><a name="whatever">Title of H2</a></h2>
Code: Select all
<p><a href="http://example.com">My link</a></p>
Re: Mysterious underlining of autonumbered chapter
Paul,
That might have worked, but I already made the necessary changes. (It wasn't that many topics.)
That might have worked, but I already made the necessary changes. (It wasn't that many topics.)
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
-
- Propellus Maximus
- Posts: 1979
- Joined: Tue Nov 28, 2006 11:18 am
- Location: Crossroads of the West
- Contact:
Re: Mysterious underlining of autonumbered chapter
Just a thought: what will happen going forward? Are you the only editor, or are there others who will have to do this? Did you have to open the text editor, or could you do this in the XML editor?
If you are going to have to "fix" this each time in the future, it might be worth fixing it permanently in the style sheet so you never have to worry about it again.
Hope this helps. Glad you got it working in any case.
If you are going to have to "fix" this each time in the future, it might be worth fixing it permanently in the style sheet so you never have to worry about it again.
Hope this helps. Glad you got it working in any case.
Re: Mysterious underlining of autonumbered chapter
I'm the sole writer/editor here, so someone else hosing this up isn't a worry. But your point is taken. I've added your suggestion to my notebook and I'll be evaluating what I need to do to my CSS.
Bottom line on this episode: I don't think this is something I should have to worry about at all. This behavior is a bug; I submitted a bug report, so I hope that a future release will take care of it.
Bottom line on this episode: I don't think this is something I should have to worry about at all. This behavior is a bug; I submitted a bug report, so I hope that a future release will take care of it.
Roy Jacobsen
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com
Writing, Clear and Simple
Fargo, ND
royj@writingclearandsimple.com
http://rmjacobsen.squarespace.com