How do I create a cross-reference to a numbered step?

This forum is for all Flare related Tips and Tricks.
Have a tip or trick you use while working in Flare? Share it here.

Re: How do I create a cross-reference to a numbered step?

Postby Nita Beck on Sat Jul 23, 2022 3:48 pm

I've continued to think about this idea of xref-ing to a numbered step and, WOAH, I offered a solution back at MadWorld 2019 in my Listapalooza session, which I also did as a webinar! Gosh, I had completely forgotten.

Here is the CSS solution I invented:
Code: Select all
/* Example of using OLs but suppressing the list style and using Flare autonumbers instead so we can xref to list items */

ol.StepNum
{
}

ol.StepNum > li
{
   list-style-type: none;
   mc-auto-number-format: 'X:Step {n+}. ';
   mc-auto-number-position: outside-head;
   mc-auto-number-offset: 60px;
   mc-auto-number-class: StepNum;
}

ol.StepNum > li:first-child
{
   mc-auto-number-format: 'X:Step {n=1}. ';
}

span.StepNum
{
   color: red;
   font-weight: bold;
}

MadCap|xref.Step
{
   mc-format: '{paranumonly}';
}


And here's how the topic looks in the XML Editor where I have an xref to the list item. I had to put a bookmark in the list item so I could point the xref to the bookmark, rather than to the step itself.

I hope this can be an inspiration. You know, I had TOTALLY forgotten that I had solved this, and I'm going to use it in one of my own projects this coming week!

Cheers.

p.s. I have not tested the output with a screenreader, so I don't know if the screenreader would announce the step numbers. I also tested this only in HTML5 output, not PDF, but I'd think it should work for PDF, too.
You do not have the required permissions to view the files attached to this post.
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3531
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: How do I create a cross-reference to a numbered step?

Postby autocart on Sat Jul 23, 2022 4:06 pm

If I may cooperate with you: The link to the webinar and accompanying material is
https://www.madcapsoftware.com/webinars ... s-in-flare

I think the mentioned trick is covered in point no. 6 inside the accompanying PDF (and of course must be in the video as well, I assume).
But there are a lot more tricks presented there. Quite interesting. Thank you, Nita!
autocart
Propeller Head
 
Posts: 32
Joined: Mon Oct 16, 2017 9:14 am

Re: How do I create a cross-reference to a numbered step?

Postby Nita Beck on Sat Jul 23, 2022 5:15 pm

My only reservation about my Listapalooza ideas now three years later is that not all of my ideas might be accessibility compliant. I definitely no longer recommend using paragraphs with auto-numbers in lieu of true <ol>s, as I said earlier in this thread.
Nita
Image
Content Strategist / Information Architect / Flare Consultant: http://beck-communications.com
Manager, Rochester Flare User Group: http://www.facebook.com/RochesterFlareUserGroup
Nita Beck
Senior Propellus Maximus
 
Posts: 3531
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Previous

Return to Tips and Tricks

Who is online

Users browsing this forum: No registered users and 1 guest