[Ardour-Users] plan to update FLOSS tutorial to version 4

Carlos sanchiavedraZ csanchezgs at gmail.com
Wed Sep 2 03:27:57 PDT 2015

Hi Bruno,

2015-09-02 2:36 GMT+02:00 Bruno Ruviaro <bruviaro at scu.edu>:

> Hi all,
> Before Summer disappears, I am right now working on updating the FLOSS
> tutorial to Ardour version 4. The work in progress is here:
> http://brunoruviaro.github.io/ardour4-tutorial/tags/
> Mostly updating screenshots and modifying the text as necessary. If anyone
> wants to help out, let me know. It would be nice to have extra sets of eyes
> to catch typos, suggest any text improvements, etc. Even nicer if someone
> wants to take a stab at writing a MIDI chapter! (currently there is none)
> Bruno
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.

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.

Is there any procedure/first steps on adding translations?

> On Sat, Jun 27, 2015 at 7:23 PM, Robin Gareus <robin at gareus.org> wrote:
>> On 06/28/2015 02:26 AM, Bruno Ruviaro wrote:
>> > Hi all,
>> >
>> > Sometime this summer I would like to update the FLOSS tutorial from
>> version
>> > 3 to 4. Version 3 is currently here:
>> > http://brunoruviaro.github.io/ardour3-floss-tutorial/
>> Yay!
>> > If anybody is interested and has the time to help out, it would be
>> great to
>> > do this as a small team -- perhaps a "book sprint" effort lasting one
>> week
>> > or something like that. Essentially, the bulk of the work is to re-read
>> the
>> > whole thing and change text and screenshots as needed to reflect 4.X
>> > changes.
>> >
>> > In addition, if there are Mac and Windows users willing to write
>> specific
>> > pages for their OS'es, that would be excellent.
>> >
>> > Finally, I noticed today that the "Help > Manual" menu of Ardour 4.1
>> > redirects to the old FLOSS manual for version 2.8. Would it be
>> appropriate
>> > to make the menu point to this new version I have been hosting on
>> github?
>> Yes, it makes perfect sense. While many of the concepts described in old
>> flossmanual are still valid, it is indeed rather dated.
>> Done. https://github.com/Ardour/ardour/commit/bdd46bad
>> It's a user preference where the link goes, so this update has no effect
>> if a user keeps old settings. I don't know if we can easily do something
>> about that with the next release. I'll sleep over it.
>> Now there's a 302 redirect from http://ardour.org/tutorial to
>> http://brunoruviaro.github.io/ardour3-floss-tutorial/ . So in the future
>> we can change it easily to e.g. ardour4-floss-manual server side.
>> (the old flossmanual link is a 301 permanent redirect, no dice)
>> > Or would it be desirable to merge it somehow as a separate section of
>> the
>> > main Ardour documentation? (bearing in mind that this FLOSS tutorial is
>> > essentially a different animal than the Reference Manual; the former is
>> > conversational in tone and guides the reader along with practical
>> exercises
>> > and goal-oriented tasks; the latter is intended to be a comprehensive
>> > reference manual with in-depth explanations.)
>> more of the
>> I think it's good to keep both separate, The tutorial is orthogonal to
>> the reference manual.
>> It's an excellent beginner's tutorial. Thanks for writing and
>> maintaining it. I dare say that hosting or mirroring the final site on
>> ardour.github.io or somewhere on *.ardour.org or can be arranged easily
>> if there's interest (all hail git).
>> best,
>> robin
>> PS. We also have a standing offer from sourcefabric to move to
>> https://www.booktype.pro/ for free (engine successor to
>> flossmanuals.net); but unless the idea is to eventually publish it as
>> paperback, the current github version is more convenient.
> _______________________________________________
> Ardour-Users mailing list
> ardour-users at lists.ardour.org
> To unsubscribe  or change your mailing preferences please visit:
> http://lists.ardour.org/listinfo.cgi/ardour-users-ardour.org


C. sanchiavedraZ:
* NEW / NUEVO:     www.sanchiavedraZ.com
* Musix GNU+Linux: www.musix.es
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ardour.org/pipermail/ardour-users-ardour.org/attachments/20150902/a8d9aad3/attachment-0002.htm>

More information about the Ardour-Users mailing list