On 2012-04-14, Tom Willis wrote:

> I have a fairly involved question that I'm looking for advice on. I posted 
> this on stackoverflow but I don't know what the action is like for 
> questions regarding sphinx in docutils. 

(Its the other way round: Docutils is the core, used programatically by
Sphinx.)

> I would like to code up a directive/extension so that I can render some 
> custom structured content.

...

> I guess I have 2 challenges.

>    1. how would I take the image option and render it as an image node?(not 
>    sure if that's the correct terminology)
>    2. how would I get the rendered representation of the content?

See how this is done by the image and figure directives in the Docutils
source.

> I've read through the extension tutorial(
> http://sphinx.pocoo.org/ext/tutorial.html) but what I want to do seems a 
> little more involved than what's covered there.

The Docutils documentation for custom directives might be the right place to
start: http://docutils.sourceforge.net/docs/howto/rst-directives.html

You will still need the Sphinx extension tutorial to find out how
to activate your extensions in Sphinx.


Günter

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to