<div dir="ltr">All sounds right to me, including Andreas's head start on step 0.<div><br></div><div><br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Dec 30, 2013 at 8:34 AM, 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"><div class="im">On 12/30/2013 02:37 PM, Tom Fifield wrote:<br>
> Hi all,<br>
><br>
> I've been contacted by someone who might have resources to do some<br>
> translation of the api reference. However, I'm not 100% clear on the<br>
> tooling changes required.<br>
><br>
> It looks like we need to<br>
><br>
> 0) change infra, so that openstack-doc-tools is available to jobs in the<br>
> openstack-api-site repo<br>
<br>
</div>Yeah, I'm working on that part and currently are blocked by an infra<br>
review ( <a href="https://review.openstack.org/#/c/62984/" target="_blank">https://review.openstack.org/#/c/62984/</a> ).<br>
<br>
I've also done over the last days quite some changes to<br>
openstack-doc-tools so that it can gate the api-site repo.<br>
<br>
Reviews are welcome:<br>
<a href="https://review.openstack.org/#/q/status:open+project:openstack/openstack-doc-tools,n,z" target="_blank">https://review.openstack.org/#/q/status:open+project:openstack/openstack-doc-tools,n,z</a><br>
<br>
Thanks,<br>
Andreas<br>
<div class="im HOEnZb"><br>
> 1) make openstack-doc-tools/bin/generatepot work with the WADL format,<br>
> if it doesn't already<br></div></blockquote><div><br></div><div>One thought here is that the text that would be translated may already be in the docbook markup, so hopefully there won't be much work to do here.</div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im HOEnZb">
> 2) change infra, so that changes to openstack-api-site are propogated to<br>
> the translation system, like they are already for openstack-manuals<br>
><br>
> did I miss anything?<br></div></blockquote><div><br></div><div>One additional thought is that the html output for api-ref.html hasn't had any translation consideration at all for wrapping, text size, fonts, and so on. Also, it's possible that the table titles are encoded in the xslts themselves. Diane and David may know more. </div>
<div><br></div><div>Also, one last thought, I'd like to know more about the reason for prioritizing an API reference so highly? I thought that other translation efforts hadn't prioritized API info as high as other items, so I'm curious about the audience and their need. If they're SDK devs that's great. Or if user guides and other guides are already done and they're looking for more to translate, that's cool too. Just want to know more background if you can share. </div>
<div>Anne</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im HOEnZb">
><br>
><br>
><br>
> Regards,<br>
><br>
><br>
> Tom<br>
><br>
> _______________________________________________<br>
> Openstack-docs mailing list<br>
> <a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
><br>
<br>
<br>
</div><span class="HOEnZb"><font color="#888888">--<br>
Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>