<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=us-ascii"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:"Trebuchet MS";
panose-1:2 11 6 3 2 2 2 2 2 4;}
@font-face
{font-family:"MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Trebuchet MS",sans-serif;
color:#240692;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:99.25pt 3.0cm 3.0cm 3.0cm;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-US link="#0563C1" vlink="#954F72"><div class=WordSection1><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>First, I hope it’s OK if a newbie uses this mailing list to request help for bug fixing. If there are better ways, please let me know.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>The bug in question is <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1421799">https://bugs.launchpad.net/openstack-manuals/+bug/1421799</a>. It’s a request to add a “log a bug” link to the openstackdocstheme templates, similar to the cute red bug links at the top and bottom of each page in the current DocBook-based documentation.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>I recklessly assigned this bug to myself. While I should be able to put the mechanism in place, I don’t have enough information to construct the link into launchpad and could do with some help from knowledgeable people.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>In the current documentation, the bug link is a launchpad URL that contains the book title (such as “SLES 11 installation guide”) and information of the following form:<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal style='margin-left:36.0pt'>-----------------------------------<br>Built: 2015-02-17T17:45:22 00:00<br>git SHA: 3f5dd2abd6d6f94cfffcb26f88c830da38af5d9e<br>URL: <a href="http://docs.openstack.org/juno/config-reference/content/section_compute-scheduler.html">http://docs.openstack.org/juno/config-reference/content/section_compute-scheduler.html</a><br>source File: file:/home/jenkins/workspace/openstack-manuals-tox-doc-publishdocs/doc/config-reference/compute/section_compute-scheduler.xml<br>xml:id: section_compute-scheduler<span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>My question is: Where would I find equivalent information in the Sphinx/Jinja environment? <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>The Sphinx documentation lists a few promising helper functions and variables (<a href="http://sphinx-doc.org/templating.html#helper-functions">http://sphinx-doc.org/templating.html#helper-functions</a>). It seems that some settings are derived from conf.py, and I don’t know if there is any conf.py standard that I can base this on.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>No idea how to retrieve the SHA key, and what to use instead of the XML ID (or can it just be left out).<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>Rather than asking for help, I could also just implement whatever I can and leave a few gaps for more experienced people or reviewers. Is that an acceptable approach?<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>Regards,<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:10.5pt;font-family:"Trebuchet MS",sans-serif;color:#240692'>Bernd</span><span style='font-size:10.0pt;color:#240692'><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.0pt;color:#240692'>Bernd Bausch<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.0pt;color:#240692'><a href="mailto:berndbausch@gmail.com">berndbausch@gmail.com</a><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:10.0pt;color:#240692'>+81 80 8892 5564<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p></div></body></html>