How to use with sphinx?
Created by: bk322
I've installed zot4rst the way it is described in README.rst.
I have {{{ ~/.local/lib/python2.7/site-packages/zot4rst-0.2dev-py2.7.egg: tree . ├── EGG-INFO │ ├── dependency_links.txt │ ├── PKG-INFO │ ├── requires.txt │ ├── scripts │ │ ├── zotcite │ │ ├── zrst2html │ │ ├── zrst2odt │ │ ├── zrst2pdf │ │ ├── zrst2pseudoxml │ │ ├── zrst2rst │ │ └── zupdatekeymap │ ├── SOURCES.txt │ ├── top_level.txt │ └── zip-safe ├── xciterst │ ├── citations.py │ ├── citations.pyc │ ├── directives.py │ ├── directives.pyc │ ├── init.py │ ├── init.pyc │ ├── parser.py │ ├── parser.pyc │ ├── roles.py │ ├── roles.pyc │ ├── util.py │ └── util.pyc └── zot4rst ├── init.py ├── init.pyc ├── jsonencoder.py ├── jsonencoder.pyc ├── sphinx.py ├── sphinx.pyc ├── util.py └── util.pyc
4 directories, 33 files }}}
and also: {{{ zotcite zrst2html zrst2odt zrst2pdf zrst2pseudoxml zrst2rst zupdatekeymap }}} in my PATH.
Still, sphinx can't find the new directives:
{{{
make html
sphinx-build -b html -d _build/doctrees . build/html
Running Sphinx v1.1.3
loading pickled environment... done
building [html]: targets for 8 source files that are out of date
updating environment: [extensions changed] 8 added, 0 changed, 0 removed
reading sources... [100%] index
/home/boris/pst/wordy/edu/MolDynOfMicroBioSystems/2-Classical_molecular_dynamics.rst:315: WARNING: Explicit markup ends without a blank line; unexpected unindent.
/home/boris/pst/wordy/edu/MolDynOfMicroBioSystems/3-_Gromacs.rst:1: ERROR: Unknown directive type "zotero-setup".
.. zotero-setup:: :keymap: bk_molDyn_mcroBio.zot :style: chicago-author-date /home/boris/pst/wordy/edu/MolDynOfMicroBioSystems/3_-Gromacs.rst:313: ERROR: Unknown interpreted text role "xcite". /home/boris/pst/wordy/edu/MolDynOfMicroBioSystems/3-_Gromacs.rst:380: ERROR: Unknown directive type "bibliography". }}}
I guess I should make zot4rst directives visible to sphinx. How this can be done?
Imported comments:
By egh on 2012-09-19 15:25:58+00:00
Hi Boris,
I had a sphinx extension, but it wasn't working. I just committed a fix.
You need to have the following in your conf.py file:
{{{ extensions = ['zot4rst.sphinx'] }}}
By bk322 on 2012-09-20 10:46:16+00:00
Oh -- I might have forgotten to add to extension list. I'll try Your fix. Actually my final goal -- is to be able to insert clickable links to rst file -- that is not only to insert the authors and the paper title -- but also a link to the paper (zotero do store that information also). I'll make an issue -- if I'll fail to acheive that with a fixed zot4rst.