Re: [Docutils-users] Question about substitution definitions as relating to figures

[Suzanne H. <wi...@gm...>]

I'm trying to make a line of thumbnails with captions, and have headers
above some of them. I want both the thumbs and the captions to be links, as
well.

Something like this:

Reports

Competitive Analysis                          Contextual Interviews
                       Design Thinking Session
     Figure one                        Figure two
 Figure three                              Figure four
     caption                             caption
 caption                                     caption

Basically, I'm looking to highlight various design artifacts within my
portfolio, and link those to the specific pages within the regular
portfolio so people can find whatever artifacts they are interested in
seeing my skill with without having to sort through a specific project. And
the 'Reports' section of this is complex enough that I'd prefer to make it
easier to interpret via the structure above.

Something sort of like the bottom of this page, but with captions and
headers: https://designattic.wordpress.com/

Does this make sense?

Sz


On Wed, May 3, 2017 at 9:41 PM, David Goodger <go...@py...> wrote:

> On Wed, May 3, 2017 at 8:26 PM, Suzanne Hillman <wi...@gm...> wrote:
> > Hello everyone!
> >
> > I'm back again. Again, please cc me on replies. :)
> >
> > In looking at the substitution definitions
> > (http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#
> substitution-definitions),
> > I see that they include images and replacement text. As far as I can
> tell,
> > they do not include the possibility of substituting for figures.
> >
> > Is this accurate?
>
> Yes, by definition. Substitutions are a phrase-level (within text)
> construct, e.g. in the middle of a sentence. From the reST spec:
> "Substitution definitions allow the power and flexibility of
> block-level directives to be shared by inline text." Figures are
> block-level elements (consisting of an image, and optionally a caption
> and/or a legend), and thus cannot occur inside text.
>
> > Do substitutions not yet allow you to substitute for
> > figures?
>
> Correct, however they won't be added in future. One can't put a figure
> inside a sentence.
>
> > I also tried using replace for figures, but it didn't like that.
>
> Only a subset of directives can be used in substitutions: image,
> unicode, replace, date.
> http://docutils.sourceforge.net/docs/ref/rst/directives.
> html#directives-for-substitution-definitions
>
> > I couldn't figure out how to add a feature request, if in fact that's not
> > yet available.
>
> https://sourceforge.net/p/docutils/feature-requests/
>
> If you want to request this as a feature, you'll first have to
> demonstrate how it would work. Please show an example of the reST
> source, as well as indicate what the result would be.
>
> What do you want to do in your document? Perhaps there's another way.
>
> David Goodger
> <http://python.net/~goodger>
>