Re: [Doxygen-users] External documentation links

[Mark <dox...@er...>]

I am still seeking help with the following questions.

> On Apr 22, 2018, at 22:26, Mark <dox...@er...> wrote:
> 
> I’m experimenting with TAG files and external links and have a couple of questions.
> 
> 1. Is it possible to disambiguate links in refs? I want to link to the index page of an external doc set for an API. I have
> 
> @subpage index
> 
> in the document doing the referencing. It is linking back to itself ‘cos it is also named index.

I have found that if I hand edit the tag file changing

  <compound kind="page">
    <name>index</name>
    <title>Introduction</title>
    <filename>index</filename>
    ...
 </compound>

to

  <compound kind="page">
    <name>libktx_index</name>
    <title>Introduction</title>
    <filename>libktx_index</filename>
    ...
 </compound>

then the link from the external document works. However I need to change both <name> and <filename> otherwise doxygen reports that it is unable to resolve the reference to “libktx_index” when it is processing the doc that reads the tag file. This is unfortunate as I want the filename to remain index.html for ease of web use. Also I haven’t found any setting that would let me change this name. index corresponds to the page called “mainpage” in the source doc.

So I ask again, is the a way to explicitly disambiguate my umbrella doc’s index from libktx's?

> 
> 1a. If not, how can I tell Doxygen to use something other than “index” for the starting page when generating the external API doc?
> 
> 2. Is there some way to reference an external page at the page level rather than subpage? If I try
> 
> @page externalref
> 
> Nothing appears. Only if I use
> 
> @subpage externalref
> 
> do I get a usable link.

I have not made any progress with this one.

Regards

    -Mark