On 2013-05-23, J Luis wrote:

> Sorry, I have another problem. For a question of organization for cmake 
> build we would like to have the figure directives declared as macros in an 
> external file. That file would than be included by the main rst file.
> However, I just faced the fact that I can define macros for images but not 
> for figures. That is, I can declare this and refer to it normally as |Fig1| 
> in the text.

> .. |Fig1| image:: fig.jpg

> but I can't do

> .. |Fig1| figure:: fig.jpg

> Well, I can do but it wont build. Real case error

> source/figs_Cookbook.rst_:1: WARNING: Substitution definition 
> "Fig-GMT5_Summit" empty or invalid.

>  Can't figures really be called from macros?

The documentation__ is not explicit on the implemented directives for
substitutions. However, it says:

  Substitution definitions allow the power and flexibility of block-level
  directives to be shared by inline text.

A figure is an image with heading. In contrast to an image, a figure cannot
be an inline element, hence it does not make sense to define it as a
substitution.
  
__ 
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#substitution-definitions

Günter

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to