Reorganizing Topics in the Content Explorer

This forum is for all Flare related Tips and Tricks.
Have a tip or trick you use while working in Flare? Share it here.
Post Reply
Jbouvier
Jr. Propeller Head
Posts: 8
Joined: Wed Feb 25, 2015 2:43 pm

Reorganizing Topics in the Content Explorer

Post by Jbouvier »

Hello,

I am trying to figure out how to reorganize my Topics within the Content Explorer, as I do not want them in alphabetical order. I tried to click and drag, but it's causing my folder to become a subfolder of another. I have been unable to locate any guidance in the user manual or online. Any help would be greatly appreciated.

Thanks,

First time user :D :capture:
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Reorganizing Topics in the Content Explorer

Post by Nita Beck »

Welcome to the forums! You are in friendly territory here.

The Content Explorer is always going to show the files within folders in alphanumeric order. There isn't a way to rearrange their order in the Content Explorer.

But what you might want to (and in my opinion, should) do is to organize your topics into subfolders. For example, in the Content\Topics folder, you might have subfolders based on topic types, so you might have folders for Tasks, Concepts, Reference, FAQs, and so forth. Or you might have subfolders based on product features, so you'd have folders such as FileMgnt, Addressing, Signaling, Reports, etc. (just making names up, here). Or you might have a different logical categorization of topics, such as FrontMtr, Preface, Ch01, Ch02, Ch03, ApxA, ApxB. Within each of these subfolders, the topic files will be arranged alphanumerically.

There is no one right folder structure for your topics. Just pick a scheme that makes sense and that will make it easy for you (and for the author who follows you someday) to find topics.
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
ChoccieMuffin
Senior Propellus Maximus
Posts: 2630
Joined: Wed Apr 14, 2010 8:01 am
Location: Surrey, UK

Re: Reorganizing Topics in the Content Explorer

Post by ChoccieMuffin »

I completely agree with Nita's post, and that's what I do too, though I asked exactly the same question when I first started with Flare.

Your original post makes me wonder why you want to rearrange the topics non-alphabetically. You can think of the Content Explorer as just a container for your topics - until you generate an output, they're just in a big pot. If you want to put topics in some kind of order you need a TOC, which puts the topics in the order in which they will appear when you generate your output.

In my projects I try to use the same TOC for help and PDF, but I use conditions to mark topics that are only needed in online help, so when the TOC is used with a PDF target, the help-only topics are not included. (You don't HAVE to include a help-only topic in a TOC if you don't want to, but I find it useful to do so as I use breadcrumbs in my help, and if the topic isn't in a TOC then it doesn't have a breadcrumb trail.)
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
Haz
Propeller Head
Posts: 16
Joined: Thu Nov 20, 2014 3:01 am

Re: Reorganizing Topics in the Content Explorer

Post by Haz »

Actually I completely understand JBouvier's request. I've gone over to using numbers at the start of my file names to get them in what I consider to be a logical order. I guess you get used to alphabetized ordering if that's all you have, but when your TOC entry has a different title to your Content filename it's non-intuitive. The problem for me is that I want my topics in a certain order in the TOC but I then have to remember what I called them. I do use folders to break up larger projects, but if you're reusing efficiently each topic can be quite small. Not sure why Madcap want to force us into alphabet order as I'd be the first one to reorder logically if I could.
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Reorganizing Topics in the Content Explorer

Post by Nita Beck »

@Haz, you raise some good points, but let me elaborate:

It is definitely a good objective for there to be a correlation between the human-readable heading of a topic and the topic's filename. For example, if I have a topic whose heading is "Managing Accounts," I'll name the filename something like "managing_accounts.htm" or "tsk_managing_accounts.htm" (where "tsk_ is a prefix announcing that the topic is a task/procedural topic). And of course, the TOC entry for said topic should correlate too; it should be something like "Managing Accounts" or "How to: Manage Accounts". For ease of authoring and maintenance, these different things should most definitely match.

But I don't think it's a good idea -- in the long term -- to have topics in the Content Explorer match their order in a TOC. What happens when you add a new target with a new TOC that arranges topics in a different way? If you've jimmied the filenames so that topics in the Content Explorer mimic their arrangement on the original TOC, you've now hampered yourself to be able to extend the Flare project to produce other targets with topics in alternative arrangements.

BTW, it's quite easy, from a TOC, to locate a topic in the Content Explorer. Right-click the TOC entry and select Locate in Explorer.

The original poster needs to understand that the Content Explorer is just that -- an explorer -- akin to the Windows Explorer. It is not a construct by which to arrange content into the order that the content will appear in a generated output. That's what a TOC does.
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
Haz
Propeller Head
Posts: 16
Joined: Thu Nov 20, 2014 3:01 am

Re: Reorganizing Topics in the Content Explorer

Post by Haz »

Thanks Nita. I see your point(s). I guess it's a newbie thing where we want to create our document structure in the Content Explorer rather than at the planning stage before project kickoff. I'll be a good document wrangler in future and use TOCs properly. :wink:
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Reorganizing Topics in the Content Explorer

Post by Nita Beck »

@Haz. Wear your newbie moniker proudly! Every single one of us here was at some point a Flare newbie. Your expertise will accumulate gradually. Keep asking questions and keep reading the forums! (BTW, sorry that I haven't had time to address your question about using variables in output file names. Hopefully someone else will answer soon...)
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
ChoccieMuffin
Senior Propellus Maximus
Posts: 2630
Joined: Wed Apr 14, 2010 8:01 am
Location: Surrey, UK

Re: Reorganizing Topics in the Content Explorer

Post by ChoccieMuffin »

@Haz, I also had that same desire but quickly got used to using folders to put things into some kind of order (one of my projects has nearly 2000 topics in it so folders are essential!) and keeping the names pretty similar. I did go through a stage of prefixing with numbers when doing a tutorial so all topics from Lesson 1 had 1_ in front but I quickly changed that when someone decided to add another lesson between 1 and 2, so I was stuffed, and just removed the numerical prefixes.

As for opening topics, I just double-click the topic in the TOC and there it is, open. If I don't want to actually open it, I hover the cursor over it and I get the path. Similarly if a topic is open and I want to know where it is, hover over the tab of the topic in the main work area and it shows the full path. You can also hover over a x-ref or hyperlink (either in the body of a topic or in the structure bar at the top) to see what topic is being referenced. So now I don't use the Content Explorer nearly as often as I used to.

And yes, keep asking questions. I wouldn't begin to say I'm an expert but I have learned so much from these forums, and nobody has ever told me I've asked a stupid question.
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
wclass
Propellus Maximus
Posts: 1238
Joined: Mon Feb 27, 2006 5:56 am
Location: Melbourne, Australia

Re: Reorganizing Topics in the Content Explorer

Post by wclass »

I'll add to Nita's and Choccie's comments by saying as well as the TOCs, the File List (View tab > File List) is also very handy to manage files. It even lets you change the sort order by clicking the column heading - I often switch from file name order, to date modified order, to folder/path order, and so on.
Margaret Hassall - Melbourne
ChoccieMuffin
Senior Propellus Maximus
Posts: 2630
Joined: Wed Apr 14, 2010 8:01 am
Location: Surrey, UK

Re: Reorganizing Topics in the Content Explorer

Post by ChoccieMuffin »

wclass wrote:I'll add to Nita's and Choccie's comments by saying as well as the TOCs, the File List (View tab > File List) is also very handy to manage files. It even lets you change the sort order by clicking the column heading - I often switch from file name order, to date modified order, to folder/path order, and so on.
I never realised that! Thanks, Margaret!
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
Jbouvier
Jr. Propeller Head
Posts: 8
Joined: Wed Feb 25, 2015 2:43 pm

Re: Reorganizing Topics in the Content Explorer

Post by Jbouvier »

Hi guys,

Sorry for the delayed response, but thanks so much for all the posts. I had recently been working in RoboHelp recreating an online user manual (which had originally been created in RoboHelp, but I don't have access to the original file - but I do have access to the last version of the output). I am new to using these types of programs, so I was trying to stick to the same organization logic for the online manual. In RoboHelp, the folders located in Project Manager (which is similar to MapCaps Content Explorer) were in logical order for a user manual (Welcome, Introduction, Before You Begin, etc.). Then within each of these folders were pages which reflected the actual content for each section. I was just puzzled when I wasn't able to do the same thing in MapCaps. Any suggestions/ideas? :?

Thanks again!

JB :mrgreen:
Nita Beck
Senior Propellus Maximus
Posts: 3667
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Reorganizing Topics in the Content Explorer

Post by Nita Beck »

There is nothing about Flare stopping you from arranging your topics into folders that you name however you want. So in the Topics folder, you can most certainly have folders named Welcome, Introduction, Before_Your_Begin (please note that, for folder names, I recommend that you NOT have spaces) into which you can drag the topics. Be sure to do this all within Flare, not in Windows Explorer, so that Flare will prompt you, with each move, to update links that might be present in other topics TO the topic you're moving. Otherwise, if you moved files around outside of Flare, in Windows Explorer, you will end up with lots of broken links.

If you want to move many topics at the same time, you can use the Show FIles button on the toolbar of the Content Explorer to split the explorer into two panes. In the right pane, you can then select multiple topics at the same time to move into a folder.

Please note, however, that within any folder of topics in the Content Explorer, those topics will be alphanumerically listed. As someone pointed out above, you should get familiar with the FIle List too, which you can sort however you like.
Nita
Image
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
Jbouvier
Jr. Propeller Head
Posts: 8
Joined: Wed Feb 25, 2015 2:43 pm

Re: Reorganizing Topics in the Content Explorer

Post by Jbouvier »

Great, thanks! :D
KCinColorado
Propeller Head
Posts: 40
Joined: Tue Mar 20, 2012 11:00 am

Re: Reorganizing Topics in the Content Explorer

Post by KCinColorado »

In Flare 12, there seems to be a way to affect the order of entries in the Content Explorer because I keep doing it by accident (!) and can't figure out how to restore the A-Z order afterwards! For example, today I was renaming a topic file in the Content Explorer. I clicked on it a couple times to edit, then I think I tried to RE-edit the name and all of a sudden, the order of the entire pane changed. So it's something to do with mouse clicks but I have no idea what I did.(I have a very sensitive Evoluent mouse.)

My files are named like this:

Project_archive.htm
Project_backup.htm
and so on...

Then I have a series of window-level topics in the same folder, named like this:
ProjectGUI_archive.htm
ProjectGUI_backup.htm

When they get "spontaneously" rearranged, all the ProjectGUI files precede the Project_ files and show up at the top (still in ascending, alphabetical order); all the Project_ topics follow. By default, the Project_ files precede the ProjectGUI_ files.

Any ideas on how this happens and how to restore the standard, alphabetical order? If I exit the project and reopen it, the original (default) sort order is restored.
SteveS
Senior Propellus Maximus
Posts: 2087
Joined: Tue Mar 07, 2006 5:06 pm
Location: Adelaide, far side of the world ( 34°56'0.78\"S 138°46'44.28\"E).
Contact:

Re: Reorganizing Topics in the Content Explorer

Post by SteveS »

Have you changed the way files are ordered in Window's file explorer? I think Flare uses this by default...
Image
Steve
Life's too short for bad coffee, bad chocolate, and bad red wine.
ajpeck123
Propeller Head
Posts: 37
Joined: Tue Mar 07, 2017 6:01 am

Re: Reorganizing Topics in the Content Explorer

Post by ajpeck123 »

Content Explorer has (several times now) started to display files in an unknown order.
TopicOrder.png
I don't know why it's doing it... but it's driving me mad.
I tend to use the ToC to find the file I want to edit (it's easier... especially when working backwards from a PDF where someone has marked up a change) but SOMETIMES I know I also need to edit another file in the same area (for example, I have several 'home' pages that are all different ... and need to be separate files for technical reasons) so making a change to one means I need to make a change to another... and I'm having to open lots of TOC files to find them as they could be anywhere in the list rather than all following (home-a.htm, home-b.htm, home-c.htm).

Anyone else come across this? How can I get alphabetic order back?

Thanks in advance,

Alison
You do not have the required permissions to view the files attached to this post.
Alison
Lone technical author - Flare user since March 2017
Currently using Flare 2020
Post Reply