I'm a relatively new reStructuredText + Sphinx user, and I'm looking to
convert some docbook documentation to reStructuredText. I was looking
through some of the syntax and features of rst, and came upon "include" and
What I'm looking to create is something similar to a docbook "entity" file
where I can, among other things, map out the various gui "click-paths,"
through various menus (e.g. for a calculator application, the user would
click through to Applications --> Accessories --> Calculator ) so that I can
have them all stored in one location. If the menu location ever changes, I
would just need to update the correct click-path in one spot, and all
references to that click-path would be updated throughout the documentation.
>From what I gather thus far, it looks like using some combination of
"include" (to include the separate "entity" file) and/or "replace" (to
replace an abbreviated reference to the fully-detailed click-path) may do
the trick, but I don't quite see it working as easily as I may have hoped.
Using "include" would seem to be a bit convoluted for this if I would need
to repeatedly use "start-after :" and "end-before :". If I use "replace" .
. . I think that the references I am seeking to replace would actually need
to be in the document itself, correct? While that may be somewhat helpful, I
was hoping to have just one or two files that I could use to store all of my
"entities," and not have to include each one within the document itself.
I hope I've explained this well enough to receive some suggestions on what
approach I could take, or if what I want to do is just not possible with the
current incarnation of docutils. Please let me know if I've misunderstood
anything, or if you have additional questions. Thanks very much for your