<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
Hi DAL,<br>
<br>
Just a little notification for whoever is interested in ADQL or,
more generally, in GitHub+IVOA documents matter.<br>
<br>
With the help of James D., Marco M. and Markus D., there is now a
PDF Preview of the ADQL document generated and provided by the
GitHub repository (without adding/committing it inside the
repository):<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/ivoa-std/ADQL/releases/download/auto-pdf-preview/ADQL-draft.pdf">https://github.com/ivoa-std/ADQL/releases/download/auto-pdf-preview/ADQL-draft.pdf</a><br>
<br>
This preview is updated automatically each time a PullRequest is
merged with the ivoa-std/ADQL repository (or more precisely, each
time a commit is pushed into the master branch). This PDF is not
versioned.<br>
<br>
As said just above, it is ONLY a preview ; it must NOT be
distributed. To emphasize this draft status, a watermark has been
applied on the generated PDF (thanks to the very new ivoatex's task
`$(DOCNAME)-draft.pdf`).<br>
<br>
The URL above never changes. You do not have to remember it either
because it can be easily got in two ways:<br>
1. by clicking on the badge <img moz-do-not-send="false"
src="cid:part2.7EA717DC.51760204@astro.unistra.fr"
alt=""Preview | PDF"" title=""Preview | PDF""
width="90" height="28"> at the top of the README.md file
(immediately visible when going at the <a moz-do-not-send="true"
href="https://github.com/ivoa-std/ADQL">root of the ivoa-std/ADQL
repository</a>): <br>
2. by going on the Pre-Release <a moz-do-not-send="true"
href="https://github.com/ivoa-std/ADQL/releases/tag/auto-pdf-preview">"Auto
PDF Preview"</a> in the Releases page of the GitHub repository<br>
<br>
Please note that the process described until now to update the ADQL
(or any IVOA) document on GitHub (i.e. using Issues and
PullRequests) does not change. The PDF preview is automatically
generated and managed by a GitHub Workflow.<br>
<br>
For the curious ones among you, all the magic is in the file <a
moz-do-not-send="true"
href="https://github.com/ivoa-std/ADQL/blob/master/.github/workflows/preview.yml">.github/workflows/preview.yml</a>.
It has been made as much generic as possible so that it could be
copied into an ivoa-std repository for another IVOA document without
too many modifications (e.g. use a recent version of ivoa-tex, adapt
the environment variable `doc_name` and eventually adapt the list of
required dependencies). Of course, it also works with forked
repositories.<br>
<br>
Cheers,<br>
Grégory<br>
<br>
<br>
</body>
</html>