#sphinx-doc

i'd like to have a figure:: which includes an SVG verbatim into the generated HTML.

in the SVG i have onclick handlers configured to let the SVG act as kind of a navigation.

there's literalinclude::, but it escapes stuff and wraps it in a Python-highlighted <div>.

so it's not a misnomer, not literal at all :)

aha. raw::

yep. that worked.

Hello, I encountered a problem while using the sphinx 1.3.1: I ran sphinx-quickstart as said in the documentation, but got unfriendly error message. The interactive quetions are gone and I could not figure out how can I create a basic sphinx doc as before. Can anybody help?

It seems that since 0.6, sphinx has changed a lot, both in sphinx-quickstart and sphinx-build.

I did the quick start according to this link: http://sphinx-doc.org/latest/tutorial.html#inst...

determinant, what error did you get?

Taggnostr: sphinx-quickstart: error: A package path is required.

And its usage seems to be complex: Usage: sphinx-quickstart [options] -o <output_path> <module_path> [exclude_path, ...]

I think this is not exactly the latest documentation talking about.

It only suggests me to run sphinx-quickstart without additional options.

yes, you shouldn't need extra options

perhaps you still have 0.6 installed and sphinx-quickstart is picking up that one instead?

determinant, if you are on linux, can you try `which sphinx-quickstart`?

Taggnostr: /usr/bin/sphinx-quickstart

Taggnostr: I tried pip install -U Sphinx==0.5, and the old version did work without additional options, but not for 0.6 and later versions.

when you launch it it should tell the version at the top

Welcome to the Sphinx 1.2.2 quickstart utility.

Taggnostr: I tried `sphinx-quickstart --version` and got "Sphinx (sphinx-apidoc) 1.3.1".

Taggnostr: unfortunately, there is no such welcome title, nor do an iteractive interface shows up...The first line is that usage information.

have you tried passing the two dirs?

something like `sphinx-quickstart -o _build .`

on 1.2.2 it doesn't seem to accept --version, and the first argument (optional) seems to be root path

Taggnostr: it responds with "Creating file _build/modules.rst."

nothing else?

not sure what's going on, but if you can't figure it out, maybe you could install 1.2 instead?

Taggnostr: yeah...Oh, my gosh..I think it is an issue of my Linux distribution.

Taggnostr: I'm using Gentoo, the package manager which is written in Python also prints the same error message.

Taggnostr: So i'm pretty sure now it is not the problem of Sphinx.

looks like you have a bigger problem :)

Taggnostr: Thank you, and apologize my carelessness. :)

Taggnostr: indeed..it seems that I screwed up the package system because I have already installed Sphinx via distribution package manager and reinstalled it via pip.

Taggnostr: and something bad happened..

hello all I wanted to know if GFM (Github Flavored Markdown) is supported as it is a Markdown

ahoneybun: Looks like that depends on what Markdown parser you use.

I'm not noticing one built-in.

so it would not work?

If you'll read the documentation you'll see the only mention of Markdown is in the source_parsers section of the configuration page: http://sphinx-doc.org/config.html?highlight=mar...

This leads me to believe it is 1) possible 2) not built-in