search

ivoa-std / ConeSearch

Simple Cone Search
Creative Commons Attribution Share Alike 4.0 International
2 stars 4 forks source link

Quick fix to have a working html output #49

Closed molinaro-m closed 4 years ago

molinaro-m commented 4 years ago

Release WD-1.1 has a .tex source that prevents a proper translation into html. This latter is usually only generated when packed for document repository submission, so it doesn't show up on a simple make, but doesn't even block a make package. As a result, at the time of writing, the html document on ivoa.net repository is broken. This PR fixes temporarily the issue, allowing for a readable html version of WD-1.1, but the .tex will need a through re-read to clean it, possibly with some changes in the used LaTeX solution for URLs.

Short: this is only to have a readable html version to submit to ivoa.net instead of the currently broken one.

msdemlei commented 4 years ago

Hm. I've not dug terribly deeply into this, and tth's error message is a bit obscure, but I'm pretty sure this is because of the crappy support for nolinkurl in ivoatex, which, again, is due to tth not supporting changes in catcodes. So -- the good solution would be to add nolinkurl support to ivoatex, and the second best to just use \verb|abc| instead of nolinkurl.

Can you give me week to figure out what kept me from doing the right thing on nolinkurl the last time I looked at it? And if I really can't be bothered to fix it properly, I'd suggest to move to verb (and I'll warn a bit louder against using nolinkurl with URLs having query or local parts in ivoatexDoc).

molinaro-m commented 4 years ago

I have no hurry. I simply wanted to fix the html on ivoa.net. I can do that with my local currently generated html file and leave the comprehensive solution for later.

As an aside: I'd be perfectly fine in using \verbatim for those URLs, only they're a bit tricky to center I'll go back reading better the ivoatexDoc :)

molinaro-m commented 4 years ago

Being the immediate issue (broken HTML on ivoa.net) solved, I close this PR. Editing the document for a better HTML styling is postponed and will fit into editorial work.