Why is 'autonum' there and then again gone?

This forum is for all Flare issues related to styles, stylesheets and XML.
Post Reply
InesF
Jr. Propeller Head
Posts: 3
Joined: Mon Oct 24, 2011 2:18 am

Why is 'autonum' there and then again gone?

Post by InesF »

Hi,

I don't understand a particular behavior of Flare:
We are a team of three people, everyone using the latest version of Flare.
Our Flare projects are hosted in GIT, so everyone uses the same files (including stylesheet).

The behavior I don't understand is: Let's say, we have a topic which initially contains headings with an additional 'MadCap:autonum=1' (h1 MadCap:autonum="1"). Now I work on that topic, not touching the headings or stylesheet. But when I do a diff before checking in the changes, I see, that magically Flare has removed all the autonum texts from the headings (<h1>).
Shortly after that, a colleague checks the file out, changes something and - voilà - when doing a diff, the autonums are back in!

Why is that?

Thanks to anyone who can clarify this.
kwag_myers
Propellus Maximus
Posts: 810
Joined: Wed Jul 25, 2012 11:36 am
Location: Ann Arbor, MI

Re: Why is 'autonum' there and then again gone?

Post by kwag_myers »

I use auto-numbering for notes, tips, and occasionally for headings. I've never used the Show Differences feature, but I have noticed that the XML Editor doesn't always display the auto-number text and I've never been able to figure out what triggers the behavior. If I look at the syntax in the Text Editor, the text is in the tag and always in the output. It's just the XML Editor that seems inconsistent.
"I'm tryin' to think, but nothin' happens!" - Curly Joe Howard
ChoccieMuffin
Senior Propellus Maximus
Posts: 2634
Joined: Wed Apr 14, 2010 8:01 am
Location: Surrey, UK

Re: Why is 'autonum' there and then again gone?

Post by ChoccieMuffin »

I don't use auto-num on headings, but I sometimes notice my numbered bullets do a disappearing act, and then come back again later, usually if I've changed to text editor and back to XML editor. No idea why, just offering my sympathies.
Started as a newbie with Flare 6.1, now using Flare 2023.
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Nita Beck
Senior Propellus Maximus
Posts: 3672
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Why is 'autonum' there and then again gone?

Post by Nita Beck »

A few questions.

Does the project produce different targets and does the stylesheet have mediums? Are the auto-numbers defined in one medium but not another (for example, are the auto-numbers only in the print medium)?

If the answers to these questions are Yes, then it's probably that you and your colleagues have set a different primary target as you work in Flare. If your colleagues' primary target is the target that uses the medium that has the auto-numbers, they will see the auto-numbers as they edit. If your primary target is the target that uses the medium that does not define auto-numbers, then you won't see the auto-numbers as you edit.

This is all a hunch on my part about the root cause of the behavior.
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
InesF
Jr. Propeller Head
Posts: 3
Joined: Mon Oct 24, 2011 2:18 am

Re: Why is 'autonum' there and then again gone?

Post by InesF »

Hi Nita,

thanks, I think your explanation makes sense for us. We all sometimes switch between which target is primary. So if the problem was only what we _see_ during editing, I would not complain. What I really dislike is that the actual file (source code) is being changed. So we end up with changes in files (that may also need to be merged) that are no real changes.
And what makes it even more unnecessary is that the PDF output looks the same regardless if the target was primary or not.

I'm thinking of opening a support ticket for this behavior.
Msquared
Propellus Maximus
Posts: 848
Joined: Mon Aug 06, 2012 10:19 am
Location: Southampton, UK

Re: Why is 'autonum' there and then again gone?

Post by Msquared »

I agree. I don't think Flare should change topic content unless it's a real content change or a real style change. There's MadCap:lastHeight and MadCap:lastWidth in the <html> tag too that get changed on occasions.

This makes it very hard to identify genuine changes that will be replicated in output. It also makes extra work for translators too as the files are flagged as having changed, when they haven't. If Flare really needs to store meta-data about a file, for efficiency, or for some other reason, it should be stored elsewhere (perhaps in one of the temporary files), and not in the .htm file itself.
Marjorie

My goal in life is to be as good a person as my dogs already think I am.
Post Reply