This feature baffled me for a brief time when I first started doing printed output (specifically to PDF) with MadCap Flare. I didn’t get it..and that annoyed me. But, eventually, I figured it out and it’s been a wonderful feature ever since. Let me show you how it works.
When building a help project, specifically adding a new topic, each new topic always starts with an H1. When you need to, you add H2s or H3s to each topic. In the end, each topic (or webpage) has a nice, neat information hierarchy established. This is because when reading help, the user generally doesn’t go through it linearly. They go straight to the pages they need. So it makes sense to start each page with an H1.
But printed output doesn’t really work that way, does it? Users tend to read printed documentation more linearly. The subject you’re looking for may be part of another section and we all know that not every topic starts on a new page.
So, a topic that starts with an H1 in webhelp may actually need to start with an H2 (or even H3 or H4) in printed. That’s where the TOC Depth for Heading Levels comes in.
That check box essentially lets you to start all topics with an H1 but allows those H1s to be different heading numbers for print. Strange concept, I know.
Here’s a TOC without the Using TOC Depth for Heading Levels check box selected. It’s not ideal and I can see a number of issues that need to be addressed – but let’s focus on the TOC headings only. Everything is on the same level and it’s hard to tell where certain topics fall in the information hierarchy. It’s jumbled, discombobulated.
Here’s how things look in the Flare TOC. While a hierarchy has been built in, each topic starts with an H1 so they will all be on the same level. This is not how we want things to look.
Here’s how we want things to look:
And when you select the Use TOC Depth for Heading Levels check box – that is what you will get. Meaning….the H1s for Features, New Features, and Uninstalling will actually be changed to H2s (and will look however you styled the H2s in your CSS).
And the H1s for Downloading, WS-FTP Pro, and Contacting will appear as H3s. And they will look however you styled the H3s in your CSS.
So, what happens exactly when you select Use TOC Depth for Heading Levels? Check it out. Here’s a screenshot of the same project, same TOC – all I did was select Use TOC Depth for Heading Levels.
Ahhhh…..I feel sooo much better now. I’ve gone to my happy place! What a wonderful hierarchy of information – and not just a jumble of topics on the page. The TOC in the PDF doc now looks like how it was built in Flare.
Try it – and let me know what you think about your results.
Special thanks to Ipswitch via MadCap Software for the sample project.
My Recent Projects list can get pretty messy when I’m creating projects, renaming, adding them to SVN, changing their paths. Whatever the reason, the list gets ugly and I just have to clean it up. And it’s not because I’m a neat freak…oh no, it’s because I’m concerned I’ll open up the wrong project and spend hours on it. That would be soooo me….and I prefer to avoid that possibility. This is what I’m referring to:
Cleaning your recent projects list (and recent files) is easy. So easy that the way to get there is in the screenshot above:
Click Manage Recent Projects and let’s get that Start Page tidied up a bit.
The projects in red are those that I’ve moved or deleted. Time to tidy!
Click on the projects you want to remove and then click Remove. You can select multiple at a time.
The results of The Purge:
And my lovely, tidy Start Page:
The same goes for Recent Files. Go back to File > Manage Recent Files. You’ll see this:
Here the only ones I want to remove are those that I’ve deleted (the ones in red). The result:
Keeping the Start Page and the Recent Files and Recent Projects tidy is crucial. If I let it get out of control, I really run the risk of working in the wrong project…and that would be bad.