Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-14360

Pin pybtex/sphinxcontrib-bibtex dependencies in documenteer 0.2.x & dev guide update

    Details

    • Templates:
    • Story Points:
      0.5
    • Epic Link:
    • Team:
      SQuaRE

      Description

      The Dev Guide suggests we use the following:

      .. bibliography:: local.bib lsstbib/books.bib lsstbib/lsst.bib lsstbib/lsst-dm.bib lsstbib/refs.bib lsstbib/refs_ads.bib
         :encoding: latex+latin
         :style: lsst_aa
      

      However, when I tried this with a recent sphinxcontrib-bibtex, I get:

      /Users/jds/Projects/LSST/docs/dmtn/031/index.rst:508: ERROR: Error in "bibliography" directive:
      invalid option value: (option: "encoding"; value: 'latex+latin')
      unknown encoding: "latex+latin".
       
      .. bibliography:: lsst-texmf/texmf/bibtex/bib/refs_ads.bib
         :style: lsst_aa
         :encoding: latex+latin
      

      I think this is due to changes upstream (I didn't track it down fully, but I note that both sphixcontrib-bibtex and pybtex have been making changes to the way they handle encodings in recent releases).

      Simply removing the :encoding: line works fine for me.

        Attachments

          Activity

            People

            • Assignee:
              jsick Jonathan Sick
              Reporter:
              swinbank John Swinbank
              Watchers:
              John Swinbank, Jonathan Sick
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Summary Panel