-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi,
On 29/04/15 00:06, Bill Allombert wrote: > On Tue, Apr 28, 2015 at 09:06:29PM +0200, Jerome BENOIT wrote: >>> So you should be able to avoid this issue by setting >>> GAPDoc2HTMLProcs.MathJaxURL:="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"; >>> in the the file makedocrel.g or whatever the program that call GAPDoc is >>> used. >>> >>> But of course, we should try to solve the problem globally. >>> >>> One solution: >>> >>> 1) I patch GAPDoc/lib/GAPDoc2HTML.gi to >>> use >>> GAPDoc2HTMLProcs.MathJaxURL:="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"; >>> as the default value >> >> I would try to avoid this. > > The alternative is to do that in every package makedocrel.g file. > >>> 2) I change gap-gapdoc to Recommends libjs-mathjax and fonts-mathjax-extras. >> >> this sounds good. >> >>> 3) then we will need to rebuild the affected packages >> >> this is not an issue, but rather annoying I agree. >> >>> Better idea ? >>> Do you know if it is possible to avoid the absolute file:// URL >>> (file:///usr/share/javascript/mathjax/MathJax.js) which does not >>> play well with webserver ? >>> >>> We can do it by creating a symlink >>> mathjax --> /usr/share/javascript/mathjax >>> in the doc directory of the package and set >>> GAPDoc2HTMLProcs.MathJaxURL:="mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"; >> >> This does not sounds reasonable. > > Why not ? > >> If I remember well, for docbook stuff there is a machinery that >> transparently via some catalog grabs >> meta data files when available while WWW are let unchanged. Quick man look >> gives update-catalog(8). >> Something similar here would be definitely the best answer. > > Could you elaborate ? > > update-catalog works at compile time, not at runtime. > Here there is only one set of HTML files. > They are not normally in the webspace. The user would need to > set up a web browser to point to the GAP directories. > Maybe dwww does that but it seems broken now. This sound too heavy. A quick look on the internet about URI convinced me that what I had in mind does not exist: browsers seem unable to substitute global path to local path with respect to some catalogue. I guess that such a scheme is quite a non sense as web documents are in most of the case very volatile except for some rare case as MathJax. So indeed your solution (1) sounds now reasonable. Nevertheless I am wondering if some code can first check for the existence of a (decent) local version of MathJax and favour it over the global one available on the internet. I cannot say if it can be encoded in the final documents themselves, but I guess that GAP can perform some easy checks and generate document accordingly; a configuration variable might be also introduced to allow users to set their preferences. Of course generated documents coming within Debian balls must assumed a local MathJax. This approach seems more flexible and exportable to upstream. Cheers, Jerome > > If you have a better way to handle it, please explain. > > Cheers, > -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iQEcBAEBAgAGBQJVQVptAAoJEIC/w4IMSybjNAkH/3dftUttdKDNaG8IEXenIPB3 jB2bFXxSdgbGjUrqCuAa1/MHD3+z2bUHCo/zYrrpjGkCVGY3/JeKWD82ByWpA9OQ GGIKsyiZh0F3hnqKtdBNOpwWdN/Ub84pmR7MyT5fzm1SYksZYjI4+Q/NHhWTqh8m 9IGvgv4p2OzqgWWJF6zsM1Z+mCTVvk/noeo32a3mJn0jbZckre2oqDiK/yz4fvTd ueRnsXefE4s7a4OkdcgTlJu5qpbwPjRYdN8Z4qwXS8Uhkht83XTEsrQVT9HbqviL xuJNTaptMlCLhnqV1Gei9wcXjXnf96Xip4c3Goh2JBguxTUFjnxhi4OkCicFq8c= =JTiq -----END PGP SIGNATURE----- -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
