Use utf-8 for author accents; switch Makefile to PR for upload

[tomdonaldson]

While preparing the document for PR status, I realized that the accents in an author's name were not being rendered correctly in html format. Instead of using the inputenc Latex package, I just typed the accented letters using utf-8 directly into moc.html. This seems to work for both the pdf and html renderings.

This PR also includes the Makefile updates for submitting the doc as a PR.

[mbtaylor]

The UTF8 characters you've inserted seem to give the right result in HTML and PDF for my LaTeX installation at least ... but this looks like it might be an ivoatex issue. The LaTeX-standard accent escapes (\'{e} etc) work correctly in normal text, but not in \author macro arguments. Can @msdemlei comment?

[tomdonaldson]

The UTF8 characters you've inserted seem to give the right result in HTML and PDF for my LaTeX installation at least ... but this looks like it might be an ivoatex issue. The LaTeX-standard accent escapes (\'{e} etc) work correctly in normal text, but not in \author macro arguments. Can @msdemlei comment?

I agree, and probably should have also filed an issue on https://github.com/ivoa-std/ivoatex. I want to clarify though that both of the current '{e} style accents were working in the pdf, just not in the html.

My little bit of reading shows that there may be some inconsistency in handling UTF-8 across LaTex implementations, but that the trend is toward supporting it. For this, it is working on my Mac for both pdf and html.

[msdemlei]

On Mon, Nov 01, 2021 at 02:56:59AM -0700, Mark Taylor wrote: The UTF8 characters you've inserted seem to give the right result in HTML and PDF for my LaTeX installation at least ... but this looks like it might be an ivoatex issue. The LaTeX-standard accent escapes (`\'{e}` etc) work correctly in normal text, but not in `\author` macro arguments. Can @msdemlei comment?

Not terribly usefully. I confirm there's a bug here in that tth (which makes the HTML) does not expand the macros in this particular place (TeX itself, of course, does). The manipulation that takes place on this in tthdefs.tex is not really challenging, and so it looks as if I would have to dig deeply into tth's code to figure out why the expansion does not take place. Hm. Given that, please for now insert the accented characters in UTF-8, i.e., Sébastien Derriére and feel free to file a bug against ivoatex. I'll probably first try to pass the bug upstream to tth's author. While I'm speaking, can I raise a couple of issues on the document itself? I'll put them into the RFC wiki if you want, but since they're rather trivial: * \label{table:tmocsizeacs} is defined three times in appendix_perf.tex * Please don't use fancyvrb, because it won't work properly in HTML. ivoatexDoc has a chapter on code listings, and if that doesn't work for you, let me know and we'll work something out. * It's "Max Planck", not "Max Plank".

[tomdonaldson]

Thanks @msdemlei. We'll keep the UTF-8 characters here for now, and I'll file an issue on ivoatex.

For completeness, I'll go ahead and transcribe the editorial comments to the RFC. Ada has already addressed the most obvious one.

[msdemlei]

Oh, and I'll do a PR for the Verbatim thing.

[AdaNebot]

Thanks @tomdonaldson and @msdemlei. I edited the main file directly for the typo, then before continuing with modifications I thought that I'd check in with you back. I guess that for the verbatim issue, a separate PR is the way to go.

[tomdonaldson]

Thanks @tomdonaldson and @msdemlei. I edited the main file directly for the typo, then before continuing with modifications I thought that I'd check in with you back. I guess that for the verbatim issue, a separate PR is the way to go.

Thanks, @AdaNebot . I agree a separate PR is best for anything else.

[AdaNebot]

I agree to merging this PR, for other issues raised here we will have separate PRs.