<br><br>On Sunday, September 9, 2018, Terry Reedy <<a href="mailto:tjreedy@udel.edu">tjreedy@udel.edu</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 9/9/2018 3:43 PM, Jacqueline Kazil wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<http:///>The PSF has received a few inquiries asking the question — “How do I cite Python?”So, I am reaching out to you all to figure this out.<br>
<br>
(For those that don’t know my background, I have been in academia for a bit as a Ph.D student and have worked at the Library of Congress writing code to process Marc records <<a href="https://www.loc.gov/marc/bibliographic/" target="_blank">https://www.loc.gov/marc/bibl<wbr>iographic/</a>>, among other things.)<br>
<br>
IMHO the citation for Python should be decided upon by the Python developers and should live somewhere on the site.<br>
<br>
Two questions to be answered…<br>
<br>
 1. What format should it take?<br>
</blockquote>
<br>
There are by now formats for citing web documents.  I presume style guides now include such.  Try a current version of the Chicago Manual of Style.  (not sure of exact title).  I will ask a university professor who should know more than I.</blockquote><div><br></div><div>Citation Style Language -- supported by a number of citation tools such as Zotero and Mendeley -- is used to generate citations in very many citation styles such as Chicago, MLA, </div><div><a href="https://citationstyles.org">https://citationstyles.org</a><br></div><div><a href="https://citationstyles.org/authors/">https://citationstyles.org/authors/</a><br></div><div><a href="https://www.zotero.org/styles">https://www.zotero.org/styles</a> (9141 styles, really)<br></div><div><a href="https://github.com/citation-style-language/styles">https://github.com/citation-style-language/styles</a><br></div><div><br></div><div>BibTeX can be generated with CSL.</div><div><br></div><div>SciPy, scikit-learn, statsmodels, and pandas all list bibtex citations in their docs.</div><div><br></div><div><a href="https://www.scipy.org/citing.html">https://www.scipy.org/citing.html</a><br></div><div>- [ ] Add the Python citation to this list</div><div><br></div><div><a href="http://scikit-learn.org/stable/about.html#citing-scikit-learn">http://scikit-learn.org/stable/about.html#citing-scikit-learn</a></div><div><a href="https://www.statsmodels.org/stable/#citation">https://www.statsmodels.org/stable/#citation</a></div><div><a href="https://pandas.pydata.org/talks.html">https://pandas.pydata.org/talks.html</a><br></div><div><br></div><div>BibTeX is rather unspecified; in terms of which fields/attributes to define.</div><div><br></div><div>Search engines index <a href="http://schema.org">schema.org</a> metadata; which can be represented as RDF in HTML (RDFa), microdata, JSON-LD:</div><div><br></div><div><a href="https://schema.org/CreativeWork">https://schema.org/CreativeWork</a></div><div>  <a href="https://schema.org/Code">https://schema.org/Code</a></div><div>  <a href="https://schema.org/SoftwareApplication">https://schema.org/SoftwareApplication</a></div><div>  <a href="https://schema.org/ScholarlyArticle">https://schema.org/ScholarlyArticle</a></div><div> </div><div>Ideally, a tool such as Zotero or Mendeley can auto-detect and parse the citation for reformatting (with CSL) into whichever citation style is used for a bibliography / works cited / tools section.</div><div><br></div><div>Are there separate citations for Python and CPython?</div><div><br></div><div><a href="https://westurner.github.io/tools/#cpython">https://westurner.github.io/tools/#cpython</a><br></div><div><br></div><div><a href="https://sphinxcontrib-bibtex.readthedocs.io/en/latest/quickstart.html">https://sphinxcontrib-bibtex.readthedocs.io/en/latest/quickstart.html</a><br></div><div><br></div><div>> This extension allows BibTeX citations to be inserted into documentation generated by Sphinx, via a bibliography directive, and a cite role, which work similarly to LaTeX’s thebibliography environment and \cite command.<br></div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
 2. Where does it live on the site?<br>
</blockquote>
<br>
On <a href="https://bugs.python.org/issue26597" target="_blank">https://bugs.python.org/issue2<wbr>6597</a>, I suggested the Copyright page. I now think a link to 'Citing these Documents' on <a href="https://docs.python.org/3/" target="_blank">https://docs.python.org/3/</a><br>
would be even better.</blockquote><div><br></div><div>A heading in the docs would be great.</div><div>People may also be likely to read the README.</div><div><br></div><div>If there are potentially multiple citations, sphinxcontrib-bibtex may be worth adding to the CPython docs.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
-- <br>
Terry Jan Reedy<br>
<br>
<br>
______________________________<wbr>_________________<br>
Python-Dev mailing list<br>
<a href="mailto:Python-Dev@python.org" target="_blank">Python-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-dev" target="_blank">https://mail.python.org/mailma<wbr>n/listinfo/python-dev</a><br>
Unsubscribe: <a href="https://mail.python.org/mailman/options/python-dev/wes.turner%40gmail.com" target="_blank">https://mail.python.org/mailma<wbr>n/options/python-dev/wes.<wbr>turner%40gmail.com</a><br>
</blockquote>