Add proper UAT concept tagging

[augustfly]

via @tconnor

https://twitter.com/Thomas_Connor/status/1189672974724390912

Add ability to anchor link UAT concepts to their concept landing pages.

\uat{Galaxy Clusters}{584}

Also relabel the manuscript heading from "Keywords" to "Something else UAT related" (e.g., "Unified Astronomy Thesaurus concepts" as suggested by the author.

Additional suggestions re UAT concepts welcome in this thread.

[dncnwtts]

Just so it's easier to copy and paste for others who are interested (copied @tconnor's code here);

Replace the keywords block in aastex3.cls with the following;

% Following https://twitter.com/thomas_connor/status/1189672974724390912

%  ****************************************
%  *             KEYWORDS                 *
%  ****************************************

  \def\@keys@name{\textit{Unified Astronomy Thesaurus concepts:}\/~\mbox{}}%

\newlength{\keys@width}
\def\frontmatter@keys@format{\ifmodern\vskip0pt\else\vspace*{0.5mm}\fi%
    \settowidth{\keys@width}{0pt}%
\ifmodern\else
\rightskip=0.5in
\leftskip=34pt
\fi
\parindent=0pt%
    \hangindent=0pt}%keys@width\hangafter=1\normalsize}%
\def\@keywords@produce#1{%
 \showKEYS@sw{%
  \begingroup%
   \frontmatter@keys@format%
   \@keys@name#1
\vrule depth 12pt width 0pt
\ifnobreakafterkeywords
\vrule depth 24pt width0pt\fi
\par
  \endgroup
 }{%
  \@if@empty{#1}{}{%
   \class@warn{If you want your keywords to appear in your output, use document class option showkeys}%
  }%
 }%
}%

then in your main file create a new command \uat,

\newcommand{\uat}[2]{\href{http://astrothesaurus.org/uat/#2}{#1 (#2)}}

and after the abstract, add the UAT keywords

\keywords{
\uat{Intergalactic medium}{813};
\uat{Cosmic web}{330};
\uat{Warm-hot intergalactic medium};
...
\uat{Quasar absorption line spectroscopy{1317}
}

[tconnor]

To be clear, this was a hack designed to make things easy for others to change in 6.3. It's probably better to define \uat in the actual .cls file and to make a separate entry \uatconcepts{} in addition to \keywords{} in the actual, supported version 6.4.

[pkgw]

I'll mention that this proposed change connects to something that came up in our discussions of the UAT changeover. Namely: how should we connect any keyword names in the TeX file to the tags associated with a manuscript after the end of the EJPress submission process? We came to a consensus that it is good to emphasize the EJPress submission-time webform as the single point of truth for the UAT keyword selection, mainly because we need to enforce various consistency checks — e.g., what if the ID number and descriptive text mismatch? what if an unrecognized concept is used? And of course some of our authors submit manuscripts as Word documents.

When it comes to the proposed change here, I don't think that really has any implications except that our documentation should make the point that any "Keywords" text appearing in a PDF are purely advisory when it comes to the article submission/publication process.

[augustfly]

@pkgw I might say "purely advisory" or "exclusively for the preparation of a preprint version of the manuscript" and "the published article's final UAT concepts will be collected as part the submission process".

(more to at:world) Folks can still use old keywords if they want (as they can use emulateapj if they want), but a change like this to AASTeX has the advantage of highlighting the existence of the UAT and porting more folks over to it. I'm super excited to see it get out in the wild more.