add references

.github/workflows/pages.yml

@@ -23,7 +23,6 @@ jobs:
       run: |
         sed -ri 's#^(\s*baseurl:).*#\1 ${{ steps.pages.outputs.base_url }}#g' _config.yml
         # https://jupyterbook.org/en/stable/reference/cli.html
-        touch references.bib # TODO: remove
         jupyter-book build --warningiserror --nitpick .
     - uses: actions/upload-pages-artifact@v2
       with: {path: _build/html}

README.md

@@ -50,7 +50,8 @@ This is a **figure caption** *in the margin*, vis https://jupyterbook.org/en/sta
 - [inline ref](fig-ref)
 - numbered ref: {numref}`fig-ref`
 - custom ref: {numref}`Figure {number} with caption "{name}" <fig-ref>`
-- glossary ref: {term}`GPU`
+- glossary term: {term}`GPU`
+- `references.bib` citation: {cite}`python`
 
 ## Table of Contents
 
@@ -153,4 +154,5 @@ VRAM
 ### References
 
 ```{bibliography}
+:style: unsrt
 ```

_config.yml

@@ -7,6 +7,18 @@ repository:
   url: https://github.com/premAI-io/state-of-open-source-ai
   branch: main
 only_build_toc_files: true
+html:
+  baseurl: http://localhost:8000
+  favicon: assets/favicon.ico
+  use_edit_page_button: true
+  use_issues_button: true
+  use_repository_button: true
+  comments:
+    utterances:
+      issue-term: pathname
+      label: question
+      repo: premAI-io/state-of-open-source-ai
+      theme: preferred-color-scheme
 parse:
   myst_substitutions:
     repo_url: https://github.com/premAI-io/state-of-open-source-ai
@@ -25,21 +37,11 @@ parse:
 sphinx:
   extra_extensions:
   - sphinxemoji.sphinxemoji
-html:
-  baseurl: http://localhost:8000
-  favicon: assets/favicon.ico
-  use_edit_page_button: true
-  use_issues_button: true
-  use_repository_button: true
-  comments:
-    utterances:
-      issue-term: pathname
-      label: question
-      repo: premAI-io/state-of-open-source-ai
-      theme: preferred-color-scheme
-execute:
-  execute_notebooks: force  # re-exec on each build (https://jupyterbook.org/content/execute.html)
+  config:
+    bibtex_reference_style: label
+bibtex_bibfiles: [references.bib] # citations
 latex: # for PDF builds
   latex_documents:
     targetname: book.tex
-bibtex_bibfiles: [references.bib] # citations
+execute:
+  execute_notebooks: force  # re-exec on each build (https://jupyterbook.org/content/execute.html)

references.bib

@@ -0,0 +1,9 @@
+---
+---
+@manual{python,
+title={{Python}: A dynamic, open source programming language},
+author={Python Core Team},
+organization={{Python Software Foundation (PSF)}},
+year={2019},
+url={https://www.python.org}
+}