< Back to IRCAM Forum

Broken Index of Documentation

Antescofo
#1

Hi, the online documentation for Antescofo at http://support.ircam.fr/docs/Antescofo/manuals/ is very useful. Unfortunately the index (http://support.ircam.fr/docs/Antescofo/manuals/Reference/) currently is broken. Might it be that the link base path changed?

#2

Hi,
Yes it seems broken… you might consider using the search engine according to your index tags in the meantime… the developper may be on holliday :wink:

Bye.

N.

#3

Hi,

I have not verified everything, but I have noticed that if, for example, http://support.ircam.fr/Reference/7-scalar#alive-and-dead-exec is broken, substituting the first part of path with http://support.ircam.fr/docs/Antescofo/manuals/Reference/7-scalar/#alive-and-dead-exec it runs.

In other words, it seems that http://support.ircam.fr/ has to be substituted with http://support.ircam.fr/docs/Antescofo/manuals/

It also probably runs with other broken links.

Best

fdsdb

1 Like
#4

I was forgotten: if you download the offline version of manual: http://support.ircam.fr/docs/Antescofo/AntescofoDocHTML.zip or some other one at this page: http://support.ircam.fr/docs/Antescofo/ the links seem to be integer, and you can consult it offline.

Best

fdsdb

#5

Hello.

Short answer: the documentation must now be accessed using the following address : http://antescofo-doc.ircam.fr

This address is now the stable URL to the documentation and accessing the documentation through this address will solve the problems you have noticed.

Please, note that the offline version of the manual is not the latest one.

 

Longer answer: We had to change the location of the documentation for several technical reasons. The first is that the “support.ircam.fr” machine is likely to change in the near future due to saturation and that we want to keep the same address to access the documentation. The second is that the documentation generation tool, mkdocs, has modified its strategy for processing relative references. Using a new address for documentation allows us to preserve correct references throughout the documentation.

1 Like
#6

It works like a charm now. Thank you.

Is “offline version” refering to the Reference Manual of April 2016? Or is there a newer one. An offline version is very handy, too, as you can read it when you’re, well, offline, what is occuring sometimes :wink:

#7

Yes, the offline version is the Reference Manual of April 2016.

The new documentation is written using the markdown formalism. It makes the HTML version richer, but the corresponding PDF is ugly and need further manual intervention.