From f2936d66dc04a413bcd08488ffb8e2656f6198a4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9ctor=20C=C3=A1novas?= <47888071+hectorcanovas@users.noreply.github.com> Date: Tue, 9 Apr 2024 16:05:15 +0200 Subject: [PATCH 1/2] Update gaia.rst with corrected hyperlinks MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Dear Astropy/Astroquery team. This is Héctor Cánovas, Support Archive Scientist of the Gaia ESA Archive (writing from my personal account). While inspecting the recently updated documentation of Astroquery.Gaia I noticed that there are 8 hyperlinks that miss the colon (:) symbol after the "https" preamble, and hence they do not work. This proposed version has updated these links as: https// >> https:// --- docs/gaia/gaia.rst | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/gaia/gaia.rst b/docs/gaia/gaia.rst index b168a59c44..8ecdd3c4b6 100644 --- a/docs/gaia/gaia.rst +++ b/docs/gaia/gaia.rst @@ -17,19 +17,22 @@ how to acknowledge and cite Gaia data. .. _guide: https://gea.esac.esa.int/archive/documentation/credits.html This package allows the access to the European Space Agency Gaia Archive -(https//gea.esac.esa.int/archive/). +(https://gea.esac.esa.int/archive/). Gaia Archive access is based on a TAP+ REST_ service. TAP+ is an extension of -Table Access Protocol (TAP: https//www.ivoa.net/documents/TAP/) specified by the +Table Access Protocol (TAP_) specified by the International Virtual Observatory Alliance (IVOA_). -.. _IVOA: https//www.ivoa.net +.. _TAP: https://www.ivoa.net/documents/TAP/ +.. _IVOA: https://www.ivoa.net .. _REST: https://en.wikipedia.org/wiki/Representational_state_transfer The TAP query language is Astronomical Data Query Language -(ADQL: https//www.ivoa.net/documents/ADQL/2.0), which is similar +(ADQL_), which is similar to Structured Query Language (SQL), widely used to query databases. +.. _ADQL: https://www.ivoa.net/documents/ADQL/2.0 + TAP provides two operation modes: * Synchronous: the response to the request will be generated as soon as the @@ -193,7 +196,7 @@ radius argument. Table and columns metadata are specified by IVOA TAP_ recommendation (to access to the actual data, an ADQL query must be executed). -.. _TAP: https//ivoa.info/documents/TAP/20100327/ +.. _TAP: https://ivoa.info/documents/TAP/20100327/ To load only table names metadata (TAP+ capability): @@ -540,7 +543,7 @@ It is now possible to store a table in the private user space. The table to be u be in a VOTable_ located in a given URL, a table stored in a local file in the user machine, a pre-computed Astropy table file or a job executed in the Gaia archive. -.. _VOTable: https//www.ivoa.net/documents/VOTable/ +.. _VOTable: https://www.ivoa.net/documents/VOTable/ Each user has a database schema described as: 'user_'. For instance, if a login name is 'joe', the database schema is 'user_joe'. Your uploaded table can be @@ -688,8 +691,8 @@ The metadata parameter to be changed can be 'utype', 'ucd', 'flags' or 'indexed' * value for 'indexed' is a boolean indicating whether the column is indexed or not. -.. _UCD: https//www.ivoa.net/documents/latest/UCD.html -.. _UTypes: https//www.ivoa.net/documents/Notes/UTypesUsage/index.html +.. _UCD: https://www.ivoa.net/documents/latest/UCD.html +.. _UTypes: https://www.ivoa.net/documents/Notes/UTypesUsage/index.html For instance, the 'ra' column in the gaiadr2.gaia_source catalogue is specified as:: From 26edb93ed5c41e09aeebf025776994f3eb6f94db Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9ctor=20C=C3=A1novas?= <47888071+hectorcanovas@users.noreply.github.com> Date: Tue, 9 Apr 2024 22:37:05 +0200 Subject: [PATCH 2/2] Update gaia.rst The duplicated _TAP link has been deleted, and I have verified that there are no duplicated links in the text. --- docs/gaia/gaia.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/gaia/gaia.rst b/docs/gaia/gaia.rst index 8ecdd3c4b6..9345f2c5da 100644 --- a/docs/gaia/gaia.rst +++ b/docs/gaia/gaia.rst @@ -196,8 +196,6 @@ radius argument. Table and columns metadata are specified by IVOA TAP_ recommendation (to access to the actual data, an ADQL query must be executed). -.. _TAP: https://ivoa.info/documents/TAP/20100327/ - To load only table names metadata (TAP+ capability): .. doctest-remote-data::