Imported topics don't display without relinking in TOC

This forum is for all Flare issues related to importing files or projects.

Imported topics don't display without relinking in TOC

Postby nfinberg on Tue Apr 27, 2021 3:23 pm

I have configured a project (P0) that contains a TOC (A), a portion of which is a TOC (B), imported from a source project (P1). TOC A links to topics T01 - T50, and TOC B links to topics T51 - T100, also imported from project P1.

When I build the html target linked to TOC A in project P0, all topics in the TOC display correctly, except for the topics linked to TOC B. When I build the html target for TOC B in the source project P1, all topics display correctly.

When I open TOC B in projct P0, then open the link for each entry in the TOC, the correct topic displays.

The URLs for topics linked to TOC B in project P0 that do not display include an additional set of nestings not present in the URLs of topics that do display properly.

When I link the entries from TOC B in project P0 to the corresponding imported topics (T51 - T100), then save and build the html target again, the topics linked to TOC B do display correctly.

So, despite TOC B and associated topics T51 - T100 having been configured and imported properly in project P0, the topics do not display when the associated target is built, even though the TOC entries were apparently already linked to the correct imported topics.

However, when explicitly linking TOC B to the corresponding topics in P0, then rebuilding, the topics display properly - a step which should be unnecessary, since the links were configured in the source project. Given the additional URL nestings for the topics that don't display, it seems that the topics linked to TOC B in P0 may originally have been pointing to the source project P1, rather than P0.

Any thoughts as to whether this is an issue with Flare, or an issue in my config?
nfinberg
Jr. Propeller Head
 
Posts: 2
Joined: Tue Apr 27, 2021 11:35 am

Re: Imported topics don't display without relinking in TOC

Postby Dave Lee on Wed Apr 28, 2021 12:47 am

How are you "importing" from project P1?

If you use a Flare project import (also called Global Project Linking), and import the TOC file (*.fltoc) and topics, then these files should be copied to project P0 as-is. The topics will be in the same folder location as the source project P0, and the URLs in the TOC file should be linked to them.

I didn't quite understand what you meant by the "additional URL nesting". Do you mean (a) the imported topics in P0 are in a different folder location to the source project P1? or (b) the topic links in the imported TOC (*.fltoc) in P0 are different to P1?
Dave Lee
Master Propellus Maximus
 
Posts: 5959
Joined: Mon Mar 05, 2007 8:33 am
Location: UK

Re: Imported topics don't display without relinking in TOC

Postby nfinberg on Wed Apr 28, 2021 1:01 pm

Yes, the import configuration is set up in P0 using Global Project Linking, and includes TOC B and topics T51 - T100. These items are reimported into P0 when they are changed in the source, P1.

Reimport workflow: Select import file (TOC or topics) in P0 > ensure Source Project location is correct > Click Reimport > review Accept Imported Documents pane > Click Accept.

The URLs I'm referring to are the ones displayed in the web browser when the html output is rendered for the built target.

URL for topics that display correctly:
Image 1.png

URL for topics that do not display:
Image 2.png
You do not have the required permissions to view the files attached to this post.
nfinberg
Jr. Propeller Head
 
Posts: 2
Joined: Tue Apr 27, 2021 11:35 am

Re: Imported topics don't display without relinking in TOC

Postby doloremipsum on Wed Apr 28, 2021 5:56 pm

Yeah, it looks like the link has got messed up somehow. Maybe in part of the import process Flare has tried to 'correct' the links in TOCB, and so given it a relative link. What do those two links look like in the TOC files in Flare? i.e. Open TOC B, select a topic that works and check the Link in the Properties, then compare to a link that doesn't work.

Typically in my TOCs the Link starts with /Content - it doesn't try to do relative linking like you have in your faulty link (../../.. etc).
neque porro quisquam est qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit - sed saepe cum dolor apud multos callidos mutuetur, reduci potest.
doloremipsum
Sr. Propeller Head
 
Posts: 175
Joined: Mon Aug 26, 2019 2:11 pm

Re: Imported topics don't display without relinking in TOC

Postby Dave Lee on Thu Apr 29, 2021 1:13 am

As you're using a project import, the imported TOCB in project 0 should be exactly the same as TOCB in project 0. Flare doesn't process modify the TOC during import.

I'd suggest looking at TOCB in both projects, and compare how the links look for topics that don't work and the topics that do work.

All topic links in the TOC should start with "/Content", such as: /Content/Folder/Topic.htm
Dave Lee
Master Propellus Maximus
 
Posts: 5959
Joined: Mon Mar 05, 2007 8:33 am
Location: UK


Return to Importing

Who is online

Users browsing this forum: No registered users and 6 guests