search

zackchase / mxnet-the-straight-dope

An interactive book on deep learning. Much easy, so MXNet. Wow. [Straight Dope is growing up] ---> Much of this content has been incorporated into the new Dive into Deep Learning Book available at https://d2l.ai/.
https://d2l.ai/
Apache License 2.0
2.56k stars 726 forks source link

Citations #26

Open zackchase opened 7 years ago

zackchase commented 7 years ago

In the preliminary material it may or may not be so essential to cite much (could relegate to end-of-chapter references). But as the book approaches more recent material, we'll want to make sure that we have a good protocol for citing papers and for doing so inline.

Is there a good way to handle this? Is there any hope of doing LaTeX style citations within the notebook/markdown world?

@mli @smolix @piiswrong

sebg commented 6 years ago

Found these three options:

  1. http://nbviewer.jupyter.org/gist/z-m-k/6080008/ipyBibtex.ipynb
  2. http://nbviewer.jupyter.org/github/ipython/nbconvert-examples/blob/master/citations/Tutorial.ipynb
  3. https://sylvaindeville.net/2015/07/17/writing-academic-papers-in-plain-text-with-markdown-and-jupyter-notebook/

Seems to come down to what software / packages you want to install and then what coding style you want to use...

zackchase commented 6 years ago

Thanks @sebg. So one issue to consider here is balancing rendering beautifully for print vs being buggy if someone clones the notebook and doesn't want to install any additional plugins.

Any ideas about how we can make the refs work but die gracefully with no plugin?