<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi all, <div class="">Here is what I use:</div><div class=""><br class=""></div><div class=""><a href="https://asciidoctor.org" class="">https://asciidoctor.org</a></div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">But it does support, tables, code blocks, themes etc.. I am not sure about the API since I have not used it that way. Here is the asciidoc doc about non-English language </div><div class=""><br class=""></div><div class=""><a href="http://asciidoc.org/userguide.html#_using_asciidoc_with_non_english_languages" class="">http://asciidoc.org/userguide.html#_using_asciidoc_with_non_english_languages</a></div><div class=""><br class=""></div><div class="">Remo <br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On May 30, 2018, at 5:42 PM, Ian Y. Choi <<a href="mailto:ianyrchoi@gmail.com" class="">ianyrchoi@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">Hello Remo,</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">I am not too much familiar with asciidoc, but would you share the followings?</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">- "100 times easier" means overall efficiency or just writing? Is there statistics on that?</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">- Is asciidoc also useful for describing much more contextual description such as tables, code blocks, api documents, custom themes, and so on?</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">- Is there some a kind of well-known tool-chains for asciidoc to support documentation and building with translated resources (e.g., po files) and for publication?</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">IMO choosing of asciidoc is also dependent to Documentation team I think.</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">Akihiro and me are saying that current Sphinx tool-chain sets which we have experienced and are familiar can help on building</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">edge computing whitepaper translation support without too much effort.</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">@Frank,</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">> Customizing things with Latex like fonts, color, background picture, front picture?</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">I previously worked PDF files with basic theme stuff: e.g.,<span class="Apple-converted-space"> </span></span><a href="https://docs.openstack.org/ocata/install-guide-obs/InstallGuide.pdf" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px;" class="">https://docs.openstack.org/ocata/install-guide-obs/InstallGuide.pdf</a><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class=""><span class="Apple-converted-space"> </span>,</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">although the stuff is not very easy - it would take some effort.</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><a href="https://review.openstack.org/#/c/430263/" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px;" class="">https://review.openstack.org/#/c/430263/</a><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class=""><span class="Apple-converted-space"> </span>and<span class="Apple-converted-space"> </span></span><a href="https://review.openstack.org/#/c/439712/" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px;" class="">https://review.openstack.org/#/c/439712/</a><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class=""><span class="Apple-converted-space"> </span>would be cool reference for you I think.</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">For me, implementing PDF & publishing translated documents for project repositories has higher priority to me so I could not help building translated PDFs</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">for edge computing whitepaper with Sphinx stuff right now.</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">With many thanks,</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">/Ian</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">Remo Mattei wrote on 5/30/2018 11:16 PM:</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><blockquote type="cite" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none;" class="">I have done this Frank but asciidoc is 100 times easier to deal than Sphinx.<br class=""><br class="">Remo<br class=""><br class=""><blockquote type="cite" class="">Il giorno 30 mag 2018, alle ore 01:03, Frank Kloeker <<a href="mailto:eumel@arcor.de" class="">eumel@arcor.de</a>> ha scritto:<br class=""><br class="">Good morning,<br class=""><br class="">thanks to Akihiro and Ian to pushing that topic forward. What about PDF creation in Sphinx? Have you some experience to customize things with Latex like fonts, color, background picture, front picture? I tried this but without sucess.<br class=""><br class="">kind regards<br class=""><br class="">Frank<br class=""><br class="">Am 2018-05-30 01:17, schrieb Akihiro Motoki:<br class=""><blockquote type="cite" class="">Hi Ian,<br class="">Thanks for more considerations.<br class="">2018年5月30日(水) 0:42 Ian Y. Choi <<a href="mailto:ianyrchoi@gmail.com" class="">ianyrchoi@gmail.com</a>>:<br class=""><blockquote type="cite" class="">Hello Akihiro,<br class="">Looks so amazing! Thanks a lot for your lots of progress on<br class="">translated<br class="">edge computing white paper publication<br class="">with RST-based method, which is much preferred from I18n team, Docs<br class="">team, and all upstream projects.<br class="">In my honest opinion, using *one* unified tool in all OpenStack area<br class="">including official projects and publication<br class="">would be best, but more discussion and agreement on multiple<br class="">different<br class="">teams (+ Foundation) would be needed I think.<br class="">When I attended to a Forum on ops-guide during Summit last week, I<br class="">found<br class="">that ops-guide would want to convert from Wiki-based format to<br class="">RST-based<br class="">format.<br class="">It would be pretty nice if we all use RST-based documents to many<br class="">places, but more things (e.g., current implementation,<br class="">maintenance, ...) need to be considered I think.<br class=""></blockquote>RST can start from simpler cases and potentially supports more<br class="">complicated cases.<br class="">I personally prefer to using RST-based documents everywhere.<br class=""><blockquote type="cite" class="">Now I would like to ask more opinions on:<br class="">- @amotoki: How long does it take to convert original text file +<br class="">texts<br class="">on a PDF file to RST-based formats?<br class="">Did you do it manually and would it be also<br class="">rather easy for other members such as me or Foundation staff?<br class=""></blockquote>Setting up the initial repo and converting the original text into RST<br class="">format was really simple.<br class="">It tooks only less than our hour.<br class="">In this case, I took extra two or three hous to cover the following,<br class="">but I don't think it always happens.<br class="">- to adjust Japanese translation to cover differences between the<br class="">published PDF version<br class=""> and the text uploaded to Zanata<br class="">- to automate the above differences for other languages<br class=""><blockquote type="cite" class="">- @Foundation: Is it okay for translated white papers to publish<br class="">with<br class="">RST-based tools as Akihiro did, since RST-based tools<br class="">are much easier to publish translated<br class="">documents and sync translated resources (po files)?<br class="">- @Foundation: OpenStack documents use CC BY 3.0. Would it be fine<br class="">for<br class="">translated white papers to use similar CC<br class="">rather than CC BY-ND 4.0, for original<br class="">edge<br class="">computing white paper document or cause intellectual issues?<br class=""></blockquote>I don't mind using different licenses even if they don't block<br class="">community collaborations.<br class="">We have a number of documentations (TC governed project documents, SIG<br class="">documents, .....),<br class="">so it would be nice if we select licenses consistently.<br class=""><blockquote type="cite" class="">- All (including translators): For design stuff, just making use of<br class="">openstackdocstheme would be pretty fine?<br class="">For example, I forked from Akihiro's github repo, and<br class="">published<br class="">using openstackdocstheme<br class="">to <a href="https://ianychoi.github.io/edge-computing-whitepaper/" class="">https://ianychoi.github.io/edge-computing-whitepaper/</a><br class="">(e.g.,<br class=""><a href="https://ianychoi.github.io/edge-computing-whitepaper/ja/" class="">https://ianychoi.github.io/edge-computing-whitepaper/ja/</a> ).<br class=""></blockquote>Using openstackdocstheme would be nice when it is published in<br class=""><a href="http://openstack.org" class="">openstack.org</a> [1].<br class="">openstackdocstheme is intended to use for OpenStack *official*<br class="">projects,<br class="">so I just didn't use it as an initial effort.<br class="">If we continue to use another variants of CC and openstackdocstheme,<br class="">we can update openstackdocstheme to support more CC licensees.<br class="">Thanks,<br class="">Akihiro<br class=""><blockquote type="cite" class="">With many thanks,<br class="">/Ian<br class="">Akihiro Motoki wrote on 5/29/2018 11:37 PM:<br class=""><blockquote type="cite" class="">Hi Ildiko and all,<br class="">I am happy to hear that HTML-based publishing is now on the table<br class=""></blockquote>:)<br class=""><blockquote type="cite" class="">I am synced with Ian and Frank on this topic, though I failed to<br class=""></blockquote>join<br class=""><blockquote type="cite" class="">the conversation at Vancouver.<br class="">RST based process is used much in the community and translation<br class="">publishinng of project docs which Ian and us are working on will<br class=""></blockquote>make<br class=""><blockquote type="cite" class="">the continuous publishing easier.<br class="">I am happy to help setting up a new doc infrastructure and/or<br class="">publishing translations.<br class="">Regarding the license, CC BY-ND license turned out a bit too<br class=""></blockquote>strict in<br class=""><blockquote type="cite" class="">our collaborative works when I checked the current one.<br class="">Hopefully we can get a good conclusion for further similar cases.<br class="">Thanks,<br class="">Akihiro<br class="">2018年5月29日(火) 23:19 Ildiko Vancsa <<a href="mailto:ildiko.vancsa@gmail.com" class="">ildiko.vancsa@gmail.com</a><br class=""><<a href="mailto:ildiko.vancsa@gmail.com" class="">mailto:ildiko.vancsa@gmail.com</a>>>:<br class="">Hi Akihiro and All,<br class="">Thank you for your efforts on helping with publishing the<br class=""></blockquote>white<br class=""><blockquote type="cite" class="">paper in additional languages.<br class="">I talked to Ian and Frank last week about this topic and the<br class="">conundrum on the Foundation side whether or not to do the<br class=""></blockquote>print<br class=""><blockquote type="cite" class="">version for the translations as that is what slows down the<br class="">process a lot due to the design work it requires.<br class="">We got to the conclusion with our team from the Foundation<br class=""></blockquote>(cc’ed<br class=""><blockquote type="cite" class="">Allison, Jimmy and Wes) to do HTML-based publishing to reduce<br class=""></blockquote>this<br class=""><blockquote type="cite" class="">overhead. We need to clarify now on the process and as Jeremy<br class="">indicated the licensing as well.<br class="">Thanks,<br class="">Ildikó<br class=""><blockquote type="cite" class="">On 2018. May 29., at 15:50, Jeremy Stanley<br class=""></blockquote></blockquote><<a href="mailto:fungi@yuggoth.org" class="">fungi@yuggoth.org</a><br class=""><blockquote type="cite" class=""><<a href="mailto:fungi@yuggoth.org" class="">mailto:fungi@yuggoth.org</a>>> wrote:<br class=""><blockquote type="cite" class=""><blockquote type="cite" class="">On 2018-05-29 18:50:23 +0900 (+0900), Akihiro Motoki wrote:<br class="">[...]<br class="">NOTE: Anyway I need to grant it from the foundation because<br class=""></blockquote></blockquote></blockquote>CC<br class=""><blockquote type="cite" class=""><blockquote type="cite" class=""><blockquote type="cite" class="">Attribution-NoDerivatives 4.0 International license does<br class=""></blockquote></blockquote></blockquote>not allow<br class=""><blockquote type="cite" class=""><blockquote type="cite" class=""><blockquote type="cite" class="">me to share translations without permission. I updated this<br class=""></blockquote></blockquote></blockquote>files<br class=""><blockquote type="cite" class=""><blockquote type="cite" class=""><blockquote type="cite" class="">only for discussion and will close this soon.<br class=""></blockquote>[...]<br class="">It seems like this is a really poor choice of license as<br class=""></blockquote></blockquote>it's<br class=""><blockquote type="cite" class=""><blockquote type="cite" class="">impairing open collaboration. Even Creative Commons suggests<br class=""></blockquote></blockquote>that<br class=""><blockquote type="cite" class=""><blockquote type="cite" class="">the CC BY-ND license is unsuitable for free cultural works:<br class=""></blockquote></blockquote><a href="https://creativecommons.org/share-your-work/public-domain/freeworks/" class="">https://creativecommons.org/share-your-work/public-domain/freeworks/</a><br class=""><blockquote type="cite" class=""><blockquote type="cite" class="">We should see about getting this changed to CC BY like is<br class=""></blockquote></blockquote>used for<br class=""><blockquote type="cite" class=""><blockquote type="cite" class="">other collaborative works produced by our community.<br class="">--<br class="">Jeremy Stanley<br class="">_______________________________________________<br class="">openstack-sigs mailing list<br class="">openstack-sigs@lists.openstack.org<br class=""></blockquote><mailto:openstack-sigs@lists.openstack.org><br class=""></blockquote>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-sigs<br class=""><blockquote type="cite" class="">_______________________________________________<br class="">openstack-sigs mailing list<br class="">openstack-sigs@lists.openstack.org<br class=""><mailto:openstack-sigs@lists.openstack.org><br class=""></blockquote>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-sigs<br class=""><blockquote type="cite" class="">_______________________________________________<br class="">OpenStack-I18n mailing list<br class="">OpenStack-I18n@lists.openstack.org<br class="">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n<br class=""></blockquote></blockquote>Links:<br class="">------<br class="">[1] <a href="http://openstack.org" class="">http://openstack.org</a><br class="">_______________________________________________<br class="">openstack-sigs mailing list<br class=""><a href="mailto:openstack-sigs@lists.openstack.org" class="">openstack-sigs@lists.openstack.org</a><br class="">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-sigs<br class=""></blockquote><br class="">_______________________________________________<br class="">OpenStack-I18n mailing list<br class=""><a href="mailto:OpenStack-I18n@lists.openstack.org" class="">OpenStack-I18n@lists.openstack.org</a><br class="">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n<br class=""></blockquote><br class="">_______________________________________________<br class="">OpenStack-I18n mailing list<br class=""><a href="mailto:OpenStack-I18n@lists.openstack.org" class="">OpenStack-I18n@lists.openstack.org</a><br class=""><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n" class="">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n</a><br class=""></blockquote><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><style class="">ul[class*='mb-extra__public-links'], ul[class*='mb-note__public-links'], ul[class*='mb-task__public-links'] { display: none !important; }</style></div></blockquote></div><br class=""></div><img src="https://bowtie.mailbutler.io/tracking/hit/2FC22EFC-C1AD-4242-8330-00BBDA659936/6B447614-7B40-4A95-AF35-89EFC52B09C7/t.gif" align="left" width="0" height="0" style="width:0;height:0;border:0;" title="" alt="" id="MailbutlerTrackingPixel" class=""></body></html>