search

ietf-tools / xml2rfc

Generate RFCs and IETF drafts from document source in XML according to the IETF xml2rfc v2 and v3 vocabularies
https://ietf-tools.github.io/xml2rfc/
BSD 3-Clause "New" or "Revised" License
64 stars 38 forks source link

HTML rendering needs better meta tags for indexing #757

Open jrlevine opened 2 years ago

jrlevine commented 2 years ago

The meta tags in the HTML rendering turn out not to be the ones that indexing systems actually use, so we need to add those in addtition to the ones in RFC 7992. Here's the ones I added to RFC 6376 which Google Scholar tells me are correct:

<meta name="citation_author" content="T. Hansen"/>  <meta name="citation_author" content="M. Kucherawy"/>  <meta name="citation_publication_date" content="September, 2011"/>   <meta name="citation_title" content="DomainKeys Identified Mail (DKIM) Signatures"/>   <meta name="citation_doi" content="10.17487/RFC6376"/>   <meta name="citation_issn" content="2070-1721"/>   <meta name="citation_technical_report_number" content="rfc6376">   <meta name="citation_pdf_url" content="https://www.rfc-editor.org/rfc/pdfrfc/rfc6376.txt.pdf"/>

They are quite insistent that the author tags have just the author's name, and not annotations like ", Ed".

kesara commented 2 years ago

According to Google Scholar Indexing Guidelines, Author names can be listed either as "Smith, John" or as "John Smith".

So xml2rfc can add fullname or asciifullname.

BTW xml2rfc also adds rfc.number or ietf.draft in addtition to metadata in RFC 7992.

reschke commented 2 years ago

Why "rfc.number" and "ietf.draft"?