#sphinx-doc

https://github.com/sgenoud/remarkdown is a docutils' markdown parser. I think it works with Sphinx but I've never tried.

Another way https://gist.github.com/tk0miya/4336929 that call 'pandoc' command internally.

hello

I've got a problem with Sphinx, using rst2html, it says " Unknown directive type "code-block". " Yet Pygments is installed, can someone help me? Thanks.

rst2html is not a sphinx command

If you want to use 'code-block' like directive under docutils (it means without sphinx), you can use 'code' directive that is provided from docutils-0.9.

see also: http://docutils.sourceforge.net/docs/ref/rst/di...

I get the same error with the code directive

which docutils version do you use?

very good question, how can I check?

rst2html.py --version

rst2html (Docutils 0.8.1 [release], Python 2.7.3, on linux2)

code directive has been provided from docutils-0.9

but I get this when I try to upgrade with pip:

Command python setup.py egg_info failed with error code 1 in /tmp/pip_build_root/docutils

hum... I have no idea for that..

I think this is a cause: http://stackoverflow.com/questions/17886647/can...

I think your environment doesn't have setuptools library.

now I get this when trying to upgrade with pip:

Command /usr/bin/python -c "import setuptools, tokenize;__file__='/tmp/pip_build_root/docutils/setup.py';exec(compile(getattr(tokenize, 'open', open)(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-Tuk2_5-record/install-record.txt --single-version-externally-managed --compile failed with error code 1 in /tmp/pip_build_root/docutils Storing debug log for failure in /root/.pip/pip.log

Lionel__: show the contents of pip.log

or some useful output

InstallationError: Command /usr/bin/python -c "import setuptools, tokenize;__file__='/tmp/pip_build_root/docutils/setup.py';exec(compile(getattr(tokenize, 'open', open)(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-Tuk2_5-record/install-record.txt --single-version-externally-managed --compile failed with error code 1 in /tmp/pip_build_root/docutils

that's not usefull - there's no error message in the command line

something like a exception or traceback is useful

running install_data running install_egg_info Traceback (most recent call last): File "<string>", line 1, in <module> File "/tmp/pip_build_root/docutils/setup.py", line 224, in <module> do_setup() File "/tmp/pip_build_root/docutils/setup.py", line 98, in do_setup dist = setup(**kwargs) File "/usr/lib/python2.7/distutils/core.py", line 152, in setup dist.run_commands() File "/usr/lib/python2.7/dis

Lionel__: use a pastebin

yes, sorry

Lionel__: looks like this http://superuser.com/questions/762800/attemptin...

i think there's something horribly wrong on your machine

eg: you have multiple versions of setuptools installed all over the place

yep, i'll reinstall it, it's a vm

i don't use ubuntu's python-setuptools package

or python-pip

or whatever

but instead get the latest from pypi

actually, this: https://bootstrap.pypa.io/

see https://packaging.python.org/en/latest/

hi, I use sphinx to generate my project documentation, and I use rst2pdf to make my pdf from sphinx

when my doc is more than 30 pages, I got an error on Adobe Acrobat :

There was a problem reading this document (14)

Expected a dict object

my question: How sphinx does to generate his huge documentation into a PDF ?

kikimeter: I generate big PDFs, but I don't use rst2pdf

I use the latexpdf target in the Makefile.

k

are you on windows ?

for examples, see http://opendylan.org/documentation/

I'm on OS X and Linux.

thank you

my PDF can be read on Chrome or Firefox

not on Adobe

I think it’s a rst2pdf problem

maybe with encoding special char or code example

I try to use latexpdf

hi folks, qq, if i have a extension that wants to insert a node.reference to a refname, is that possible? i was trying this over the weekend and it seems like the refname is never resolved to the refuri (even though other refnames are resolved correctly), is the extension activation time or something stopping this from correctly occurring?