Reorganizing Topics in the Content Explorer
Reorganizing Topics in the Content Explorer
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
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
-
- Senior Propellus Maximus
- Posts: 3671
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Reorganizing Topics in the Content Explorer
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.
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
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
-
- Senior Propellus Maximus
- Posts: 2634
- Joined: Wed Apr 14, 2010 8:01 am
- Location: Surrey, UK
Re: Reorganizing Topics in the Content Explorer
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.)
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
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Re: Reorganizing Topics in the Content Explorer
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.
-
- Senior Propellus Maximus
- Posts: 3671
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Reorganizing Topics in the Content Explorer
@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.
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
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
Re: Reorganizing Topics in the Content Explorer
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.
-
- Senior Propellus Maximus
- Posts: 3671
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Reorganizing Topics in the Content Explorer
@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
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
-
- Senior Propellus Maximus
- Posts: 2634
- Joined: Wed Apr 14, 2010 8:01 am
- Location: Surrey, UK
Re: Reorganizing Topics in the Content Explorer
@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.
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
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
-
- Propellus Maximus
- Posts: 1238
- Joined: Mon Feb 27, 2006 5:56 am
- Location: Melbourne, Australia
Re: Reorganizing Topics in the Content Explorer
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
-
- Senior Propellus Maximus
- Posts: 2634
- Joined: Wed Apr 14, 2010 8:01 am
- Location: Surrey, UK
Re: Reorganizing Topics in the Content Explorer
I never realised that! Thanks, Margaret!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.
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
Report bugs at http://www.madcapsoftware.com/bugs/submit.aspx.
Request features at https://www.madcapsoftware.com/feedback ... quest.aspx
Re: Reorganizing Topics in the Content Explorer
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
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
-
- Senior Propellus Maximus
- Posts: 3671
- Joined: Thu Feb 02, 2006 9:57 am
- Location: Pittsford, NY
Re: Reorganizing Topics in the Content Explorer
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.
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
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
RETIRED, but still fond of all the Flare friends I've made. See you around now and then!
Re: Reorganizing Topics in the Content Explorer
Great, thanks!
-
- Propeller Head
- Posts: 40
- Joined: Tue Mar 20, 2012 11:00 am
Re: Reorganizing Topics in the Content Explorer
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.
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.
-
- Senior Propellus Maximus
- Posts: 2089
- 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
Have you changed the way files are ordered in Window's file explorer? I think Flare uses this by default...
Steve
Life's too short for bad coffee, bad chocolate, and bad red wine.
Re: Reorganizing Topics in the Content Explorer
Content Explorer has (several times now) started to display files in an unknown order.
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
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
Lone technical author - Flare user since March 2017
Currently using Flare 2020