Book a Demo

Author Topic: Permanence of links in HTML documentation  (Read 2846 times)

morsor

  • EA User
  • **
  • Posts: 32
  • Karma: +0/-0
  • insert text here
    • View Profile
Permanence of links in HTML documentation
« on: November 15, 2006, 01:55:22 am »
When generating HTML documentation, the file names given to the individual HTML files seem to be generated based on tree location.

I would like to link to sections of the HTML documentation from MS Word documents - but that requires that these links are 'static' and don't potentially change everytime elements are added, deleted, moved or re-ordered.

My first tests show that even after re-ordering elements, the links still point to the correct diagram.

Is this intentional and reliable - or was it just a coincidence (or is the browser cache fooling me)?

babak_farshchian

  • EA Novice
  • *
  • Posts: 2
  • Karma: +0/-0
  • I love YaBB 1G - SP1!
    • View Profile
Re: Permanence of links in HTML documentation
« Reply #1 on: November 22, 2006, 05:58:25 am »
Hi, I am also curious about this feature. I have just re-generated the HTML version of my model and it seems like all the links are invalidated  >:(

I have used the version of the URL that uses the format: http://hostname/index.html?goto=3:2:1:237 and not the one that refers to the exact HTML file. But it seems like this format is only a temporary link to the exact HTML file. The message I get for the above URL is:

"The requested URL /EARoot/EA3/EA2/EA1/EA237.html was not found on this server."

It would be a great advantage to keep the HTML links in tact also after generating a new model.

morsor

  • EA User
  • **
  • Posts: 32
  • Karma: +0/-0
  • insert text here
    • View Profile
Re: Permanence of links in HTML documentation
« Reply #2 on: November 23, 2006, 12:29:11 am »
Yeah - it seems links are trashed - as expected. It would have been nice to be able to link from an external resource (Word document) even after a reshuffling or addition/deletion.

Maybe Sparx could find some other way of generating the file names; e.g. use the package names after removing spaces.

«Midnight»

  • EA Guru
  • *****
  • Posts: 5651
  • Karma: +0/-0
  • That nice Mister Grey
    • View Profile
Re: Permanence of links in HTML documentation
« Reply #3 on: November 23, 2006, 04:30:44 am »
Or simply use the conventions of a lot of browser and server side applications - replace spaces with escape sequences in the link, but keep them in the displayed text.

I don't know if EA currently keeps separate display and target values for hyperlinks - and I have not looked it up. If not, this would be a useful enhancement (which might break the schema, but we're getting towards that time anyway).
No, you can't have it!