<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Aug 10, 2015 at 11:43 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>On 08/11/2015 01:12 AM, Karen Bradshaw wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi.  I am wondering if there is a variable in the RST build environment<br>
for the release name.  I am interested in possibly providing a<br>
substitution variable for strings that contain the release name.<br>
One example in the Install guide is a command with a URL that contains<br>
'kilo'.<br>
<br>
# curl -o /etc/swift/swift.conf \<br>
<a href="https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/kilo" rel="noreferrer" target="_blank">https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/kilo</a><br>
<br>
# curl -o /etc/swift/swift.conf \<br>
<a href="https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/%release_name%" rel="noreferrer" target="_blank">https://git.openstack.org/cgit/openstack/swift/plain/etc/swift.conf-sample?h=stable/%release_name%</a><br>
<br>
Or perhaps there is another way these strings are already handled from<br>
release to release.<br>
</blockquote>
<br></span>
So far we've updated them manually ;(</blockquote><div><br></div><div>I think "release" is a bit problematic because Sphinx already has a concept of release that it adds to each page with the semver n.n.n notation. </div><div><br></div><div>However, you can add variables to conf.py and then refer to them in a deliverable that uses that conf.py. </div><div><br></div><div>So try something like what we do for bug_tag: </div><div><a href="https://github.com/openstack/openstack-manuals/blob/master/doc/user-guide/source/conf.py#L59">https://github.com/openstack/openstack-manuals/blob/master/doc/user-guide/source/conf.py#L59</a><br></div><div><br></div><div>making a variable release_name or some such.</div><div><br></div><div>We could use <a href="http://sphinx-doc.org/rest.html#substitutions">http://sphinx-doc.org/rest.html#substitutions</a> but I'm guessing that won't work inline for URLs and such, but you can test it.</div><div><br></div><div>Just some ideas for you -- sorry I don't know the exact answer and would have to experiment myself.</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span><font color="#888888"><br>
<br>
Andreas<br>
-- <br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br><div><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</div></div>