<div dir="ltr"><div class="gmail_extra">On Wed, Sep 2, 2015 at 3:27 AM, Carlos sanchiavedraZ <span dir="ltr"><<a href="mailto:csanchezgs@gmail.com" target="_blank">csanchezgs@gmail.com</a>></span> wrote:<br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi Bruno,<br><div class="gmail_extra"><br><div class="gmail_quote"><div>If I had some time to contribute in a not so distant future, I'd try to add some content but also will like to make translations. I see there's content on how to contribute.<br></div></div></div></div></blockquote><div><br><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;display:inline">​Hi Carlos, <br><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;display:inline">Any help now or in the future is always most welcome! The info on how to contribute is here: <a href="http://brunoruviaro.github.io/ardour4-tutorial/how-to-contribute-0/">http://brunoruviaro.github.io/ardour4-tutorial/how-to-contribute-0/</a>​</div> -<div class="gmail_default" style="font-family:arial,helvetica,sans-serif;display:inline">​ any questions, just shoot me an e-mail.​</div></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div><br>I can't remember if you mentioned at LAC2015 how to include translations (or how easily it is) with that ecosystem (github+jekyll) you were starting to use or improving. I guess you could follow same instructions but you'll end up with a mixed index and menu items; or you could fork it but it should be accessible from this tutorial, maybe in a chapter for translations to make room for other languages as well.<br><br>Is there any procedure/first steps on adding translations?<br></div></div></div></div></blockquote><div><br><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">​I think your last suggestion makes sense: I can add a chapter to the English tutorial called "Translations" that links to any and all available translations.​ A pointer to it can be included on the landing page.<br><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">Anyone willing to create and maintain a translation can just fork the tutorial from github and send me the link of the translated tutorial; then I'll add the link to the Translations page.<br><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">Essentially, your first steps would be<br><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">1) Log in to your github account and fork the tutorial from there: <a href="https://github.com/brunoruviaro/ardour4-tutorial">https://github.com/brunoruviaro/ardour4-tutorial</a> - Give your fork a name that indicates the language. For example if I did a Portuguese translation the link should end up being something like <a href="http://github.com/myusername/ardour4-tutorial-pt">github.com/myusername/ardour4-tutorial-pt</a> (I suggest we use the same letter codes that wikipedia uses: en for english, es for spanish, pt for portuguese, etc.)<br><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">2) Create a branch called "gh-pages", and make it the default branch (this is in github "settings"). That's the branch you should be always working on, as that's where github builds the website automatically from. The website will be automatically published on a URL like <a href="http://myusername.github.io/ardour4-tutorial-pt">myusername.github.io/ardour4-tutorial-pt</a></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">2) From your fork, and always in the gh-pages branch, go inside the "_posts" folder, select a file, and you can start editing and writing the translation right there from the browser (if you like this method). <br><br>3) If you plan to redo all screenshots with Ardour in your language, simply save all images inside "images" folder. It will be easier if you keep the exact file names I gave in English, and simple overwrite my screenshots with yours. If you are not redoing screenshots, you don't need to do anything.<br><br>4) The main titles and general stuff can be edit in the _config.yml file.<br><br>Feel free to ask if you have any questions!<br><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">All best, and thanks for your help!<br></div><br><div class="gmail_default" style="font-family:arial,helvetica,sans-serif">​Bruno​</div><br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><div class="h5"><div><div><div class="gmail_extra"><div class="gmail_quote">On Sat, Jun 27, 2015 at 7:23 PM, Robin Gareus <span dir="ltr"><<a href="mailto:robin@gareus.org" target="_blank">robin@gareus.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span>On 06/28/2015 02:26 AM, Bruno Ruviaro wrote:<br>
> Hi all,<br>
><br>
> Sometime this summer I would like to update the FLOSS tutorial from version<br>
> 3 to 4. Version 3 is currently here:<br>
> <a href="http://brunoruviaro.github.io/ardour3-floss-tutorial/" rel="noreferrer" target="_blank">http://brunoruviaro.github.io/ardour3-floss-tutorial/</a><br>
<br>
</span>Yay!<br>
<span><br>
> If anybody is interested and has the time to help out, it would be great to<br>
> do this as a small team -- perhaps a "book sprint" effort lasting one week<br>
> or something like that. Essentially, the bulk of the work is to re-read the<br>
> whole thing and change text and screenshots as needed to reflect 4.X<br>
> changes.<br>
><br>
> In addition, if there are Mac and Windows users willing to write specific<br>
> pages for their OS'es, that would be excellent.<br>
><br>
> Finally, I noticed today that the "Help > Manual" menu of Ardour 4.1<br>
> redirects to the old FLOSS manual for version 2.8. Would it be appropriate<br>
> to make the menu point to this new version I have been hosting on github?<br>
<br>
</span>Yes, it makes perfect sense. While many of the concepts described in old<br>
flossmanual are still valid, it is indeed rather dated.<br>
<br>
Done. <a href="https://github.com/Ardour/ardour/commit/bdd46bad" rel="noreferrer" target="_blank">https://github.com/Ardour/ardour/commit/bdd46bad</a><br>
<br>
It's a user preference where the link goes, so this update has no effect<br>
if a user keeps old settings. I don't know if we can easily do something<br>
about that with the next release. I'll sleep over it.<br>
<br>
Now there's a 302 redirect from <a href="http://ardour.org/tutorial" rel="noreferrer" target="_blank">http://ardour.org/tutorial</a> to<br>
<a href="http://brunoruviaro.github.io/ardour3-floss-tutorial/" rel="noreferrer" target="_blank">http://brunoruviaro.github.io/ardour3-floss-tutorial/</a> . So in the future<br>
we can change it easily to e.g. ardour4-floss-manual server side.<br>
<br>
(the old flossmanual link is a 301 permanent redirect, no dice)<br>
<span><br>
> Or would it be desirable to merge it somehow as a separate section of the<br>
> main Ardour documentation? (bearing in mind that this FLOSS tutorial is<br>
> essentially a different animal than the Reference Manual; the former is<br>
> conversational in tone and guides the reader along with practical exercises<br>
> and goal-oriented tasks; the latter is intended to be a comprehensive<br>
> reference manual with in-depth explanations.)<br>
</span>more of the<br>
<br>
I think it's good to keep both separate, The tutorial is orthogonal to<br>
the reference manual.<br>
<br>
It's an excellent beginner's tutorial. Thanks for writing and<br>
maintaining it. I dare say that hosting or mirroring the final site on<br>
<a href="http://ardour.github.io" rel="noreferrer" target="_blank">ardour.github.io</a> or somewhere on *.<a href="http://ardour.org" rel="noreferrer" target="_blank">ardour.org</a> or can be arranged easily<br>
if there's interest (all hail git).<br>
<br>
<br>
best,<br>
robin<br>
<br>
<br>
PS. We also have a standing offer from sourcefabric to move to<br>
<a href="https://www.booktype.pro/" rel="noreferrer" target="_blank">https://www.booktype.pro/</a> for free (engine successor to<br>
<a href="http://flossmanuals.net" rel="noreferrer" target="_blank">flossmanuals.net</a>); but unless the idea is to eventually publish it as<br>
paperback, the current github version is more convenient.<br>
</blockquote></div><br></div>
</div></div><br></div></div>_______________________________________________<br>
Ardour-Users mailing list<br>
<a href="mailto:ardour-users@lists.ardour.org" target="_blank">ardour-users@lists.ardour.org</a><br>
To unsubscribe  or change your mailing preferences please visit:<br>
<a href="http://lists.ardour.org/listinfo.cgi/ardour-users-ardour.org" rel="noreferrer" target="_blank">http://lists.ardour.org/listinfo.cgi/ardour-users-ardour.org</a><br>
<br></blockquote></div><span class=""><font color="#888888"><br><br clear="all"><br>-- <br><div><br>C. sanchiavedraZ:<br>* NEW / NUEVO:     <a href="http://www.sanchiavedraZ.com" target="_blank">www.sanchiavedraZ.com</a><br>* Musix GNU+Linux: <a href="http://www.musix.es" target="_blank">www.musix.es</a></div>
</font></span></div></div>
</blockquote></div><br></div></div>