How do I edit the name of a non-TOC topic (e.g., Popup)

Please post all questions and comments regarding Help & Manual 7 here.

Moderators: Alexander Halser, Tim Green

How do I edit the name of a non-TOC topic (e.g., Popup)

Unread postby Dave Gehman » Wed Jan 16, 2019 2:50 pm

How can I edit the name of an H+M XML file that's in the Topics tree, but not in the TOC.

Specifically, this is for popup files that I've created. These are created in the Project, but not in the Table of Contents.

Reason for change: I've found that I created a file name prefix using an initial number, e.g. "1POP-". Beginning a filename with a number is not recommended by Tim. I concocted this prefix to get all the popup files to rise to the top of the children listed under Project FIles > Topic Files > Topics. I wanted visual organization of all the popups plus ease of access for editing. The tree under this Topics automatically alphabetized.

There are links in the main help file body to these popup-type XMLs.

I want to change the suffixes to "aaPOP-"

Do I edit the topic's <TITLE> Tag and Topic ID? Seems not, as I get an error message about duplicate Help Context Numbers.

Do I change their names in Windows Explorer? Worrisome, as the links to them might break.

Do I have to delete them and add new ones with the correct kind of file name, then edit the links in the main help text body to point to the new non-TOC files? Bummer, as that's a lot of work...
Dave Gehman
 
Posts: 376
Joined: Sat Sep 23, 2017 9:05 pm

Re: How do I edit the name of a non-TOC topic (e.g., Popup)

Unread postby John Johann » Wed Jan 16, 2019 5:38 pm

Did you edit the Topic ID via H&M on its own?
John Johann
 
Posts: 130
Joined: Mon Aug 21, 2017 7:35 pm

Re: How do I edit the name of a non-TOC topic (e.g., Popup)

Unread postby Dave Gehman » Wed Jan 16, 2019 5:44 pm

Could you rephrase? I don't think I understand your question.

In the one instance where I got error codes, I edited the fields in H+M Write mode in the right-hand portion of the Editor pane.
Dave Gehman
 
Posts: 376
Joined: Sat Sep 23, 2017 9:05 pm

Re: How do I edit the name of a non-TOC topic (e.g., Popup)

Unread postby John Johann » Wed Jan 16, 2019 6:02 pm

Sorry. Those options in the Editor pane are also where I would normally rename a Topic ID. By "on its own" I mean only edit the Topic ID first, then save and test the result. You can change the Title in a seccond step if you need to. The filenames you see in the Project Explorer and Windows Explorer are those Topic IDs with an ".xml" on the end. I wouldn't rename anything outside H&M as that will not be automatically picked up.

https://www.helpandmanual.com/help/inde ... odular.htm gives some pointers (and warnings) on renaming topics.

https://www.helpandmanual.com/help/inde ... odular.htm and here, too.
John Johann
 
Posts: 130
Joined: Mon Aug 21, 2017 7:35 pm

Re: How do I edit the name of a non-TOC topic (e.g., Popup)

Unread postby Dave Gehman » Wed Jan 16, 2019 6:06 pm

Thanks, John.

I'll have to study the Modular bit in your link.

Much appreciated.

Dave
Dave Gehman
 
Posts: 376
Joined: Sat Sep 23, 2017 9:05 pm


Return to Help & Manual 7 Forum

Who is online

Users browsing this forum: No registered users and 6 guests