Thread: [Bluemusic-users] blue Manual
Brought to you by:
kunstmusik
From: Steven Yi <ste...@gm...> - 2010-10-25 23:12:11
|
Hi All, I'm going through and trying to get my bearings again on blue development. I've also recently switched to using a Macbook Pro full-time (I'm using it for work as I'm doing a fair amount of iPhone and Android development which I can do all on the same machine), though I'm still working out Csound compilation/installation and getting blue setup. I wanted to ask though, does anyone have any thoughts on the blue Manual? Or I should say, knowing that the blue manual is very much out of date, I would like to begin working on it again, though I am not sure what format/system I should use to create it. I thought about using a wiki, using flossmanuals.net, and using Google Docs. While Docbook creates excellent output, I'm thinking that it might be easier for me to maintain a manual if I was able to use some sort of web app. It would also give a side benefit of speeding up release compilation of blue, as well as remove some dependencies to make it easier for developers to download/compile/go with blue. Any thoughts? Thanks! steven |
From: Dave S. <da...@su...> - 2010-10-26 00:07:10
|
Hi Steven, I think a web-based project would be great, either a wiki or something along the lines of what sites like the PHP and MySQL sites do, i.e., articles/pages with user comments (annotations). - Dave On 10/25/2010 7:12 PM, Steven Yi wrote: > Hi All, > > I'm going through and trying to get my bearings again on blue > development. I've also recently switched to using a Macbook Pro > full-time (I'm using it for work as I'm doing a fair amount of iPhone > and Android development which I can do all on the same machine), > though I'm still working out Csound compilation/installation and > getting blue setup. > > I wanted to ask though, does anyone have any thoughts on the blue > Manual? Or I should say, knowing that the blue manual is very much > out of date, I would like to begin working on it again, though I am > not sure what format/system I should use to create it. I thought about > using a wiki, using flossmanuals.net, and using Google Docs. While > Docbook creates excellent output, I'm thinking that it might be easier > for me to maintain a manual if I was able to use some sort of web app. > It would also give a side benefit of speeding up release compilation > of blue, as well as remove some dependencies to make it easier for > developers to download/compile/go with blue. > > Any thoughts? > > Thanks! > steven > > ------------------------------------------------------------------------------ > Nokia and AT&T present the 2010 Calling All Innovators-North America contest > Create new apps & games for the Nokia N8 for consumers in U.S. and Canada > $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing > Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store > http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Bluemusic-users mailing list > Blu...@li... > https://lists.sourceforge.net/lists/listinfo/bluemusic-users > > |
From: Steven Yi <ste...@gm...> - 2010-10-26 17:50:59
|
Hi Dave and Menno, Thanks for your input. I'm leaning towards a Wiki currently, and no longer packaging anything with the app but pointing everything to the Wiki. If we use a Wiki, we can have a "Manual" section, FAQ, sandbox, etc. I think blueShare should continue to be blueShare, but having a wiki area to collaborate on instrument designs/projects/etc. could work nicely. Now, perhaps more a question for Dave, as I know you do work with ruby and I assume rails: do you know of any good ruby plugins for integrating a wiki into an application? I'm thinking it would be nice to limit wiki access to users who are registered on the blue site with accounts to help prevent spam. On the other hand, using something like media wiki and styling/integrating it into the blue site is an option as well. (Looks like wiki.rubyonrails.org is using dokuwiki itself) Anyone's opinions on this would be very much appreciated! As for generated output, maybe we can find a plugin generate PDF from the wiki? Thanks! steven On Mon, Oct 25, 2010 at 8:06 PM, Dave Seidel <da...@su...> wrote: > Hi Steven, > > I think a web-based project would be great, either a wiki or something > along the lines of what sites like the PHP and MySQL sites do, i.e., > articles/pages with user comments (annotations). > > - Dave > > On 10/25/2010 7:12 PM, Steven Yi wrote: >> Hi All, >> >> I'm going through and trying to get my bearings again on blue >> development. I've also recently switched to using a Macbook Pro >> full-time (I'm using it for work as I'm doing a fair amount of iPhone >> and Android development which I can do all on the same machine), >> though I'm still working out Csound compilation/installation and >> getting blue setup. >> >> I wanted to ask though, does anyone have any thoughts on the blue >> Manual? Or I should say, knowing that the blue manual is very much >> out of date, I would like to begin working on it again, though I am >> not sure what format/system I should use to create it. I thought about >> using a wiki, using flossmanuals.net, and using Google Docs. While >> Docbook creates excellent output, I'm thinking that it might be easier >> for me to maintain a manual if I was able to use some sort of web app. >> It would also give a side benefit of speeding up release compilation >> of blue, as well as remove some dependencies to make it easier for >> developers to download/compile/go with blue. >> >> Any thoughts? >> >> Thanks! >> steven >> >> ------------------------------------------------------------------------------ >> Nokia and AT&T present the 2010 Calling All Innovators-North America contest >> Create new apps & games for the Nokia N8 for consumers in U.S. and Canada >> $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing >> Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store >> http://p.sf.net/sfu/nokia-dev2dev >> _______________________________________________ >> Bluemusic-users mailing list >> Blu...@li... >> https://lists.sourceforge.net/lists/listinfo/bluemusic-users >> >> > > > ------------------------------------------------------------------------------ > Nokia and AT&T present the 2010 Calling All Innovators-North America contest > Create new apps & games for the Nokia N8 for consumers in U.S. and Canada > $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing > Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store > http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Bluemusic-users mailing list > Blu...@li... > https://lists.sourceforge.net/lists/listinfo/bluemusic-users > |
From: Jan J. H. <jj...@so...> - 2010-10-26 21:50:10
|
Dear Steven, dear list, I would like something like a PDF a lot, as I do work with blue partly being offline. As I do see the advantages of a Wiki, the ability to transform this to a PDF or a bunch of HTML-documents would unify the best of the two approaches. Jan Jacob Am 26.10.2010 um 19:50 schrieb Steven Yi: > As for generated output, maybe we can find a plugin generate PDF > from the wiki? sound | movement | object | space sonic architecture | site: http://www.sonicarchitecture.de spatial electronic composition | 2nd order ambisonic music |
From: Adam <ah...@ih...> - 2010-10-26 22:43:31
|
Just to confirm or echo, that some of us use Blue offline mostly, always offline in my case. Thanks. Adam. On Wednesday 27 October 2010 10:30 am, Jan Jacob Hofmann wrote: > Dear Steven, dear list, > > I would like something like a PDF a lot, as I do work with blue > partly being offline. As I do see the advantages of a Wiki, the > ability to transform this to a PDF or a bunch of HTML-documents would > unify the best of the two approaches. > > Jan Jacob > > Am 26.10.2010 um 19:50 schrieb Steven Yi: > > As for generated output, maybe we can find a plugin generate PDF > > from the wiki? > > sound | movement | object > > | space > > sonic architecture | site: http://www.sonicarchitecture.de > spatial electronic composition | 2nd order ambisonic music > > > --------------------------------------------------------------------------- >--- Nokia and AT&T present the 2010 Calling All Innovators-North America > contest Create new apps & games for the Nokia N8 for consumers in U.S. and > Canada $10 million total in prizes - $4M cash, 500 devices, nearly $6M in > marketing Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to > Ovi Store http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Bluemusic-users mailing list > Blu...@li... > https://lists.sourceforge.net/lists/listinfo/bluemusic-users |
From: Steven Yi <ste...@gm...> - 2010-10-26 23:49:00
|
Thanks Jan Jacob and Adam for your thoughts. If anyone knows of a wiki system that allows PDF generation, please do let me know! I will continue to look around but would happy for any suggestions. Thanks! Steven On 10/26/10, Jan Jacob Hofmann <jj...@so...> wrote: > Dear Steven, dear list, > > I would like something like a PDF a lot, as I do work with blue > partly being offline. As I do see the advantages of a Wiki, the > ability to transform this to a PDF or a bunch of HTML-documents would > unify the best of the two approaches. > > Jan Jacob > > Am 26.10.2010 um 19:50 schrieb Steven Yi: > >> As for generated output, maybe we can find a plugin generate PDF >> from the wiki? > > > sound | movement | object > | space > sonic architecture | site: http://www.sonicarchitecture.de > spatial electronic composition | 2nd order ambisonic music > > > ------------------------------------------------------------------------------ > Nokia and AT&T present the 2010 Calling All Innovators-North America contest > Create new apps & games for the Nokia N8 for consumers in U.S. and Canada > $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing > Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store > http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Bluemusic-users mailing list > Blu...@li... > https://lists.sourceforge.net/lists/listinfo/bluemusic-users > -- Sent from my mobile device |
From: Dave S. <da...@su...> - 2010-10-27 00:06:02
|
Hi Steven, Yes, I do use Ruby (actually JRuby) and Rails, but mainly to build web-based applications as opposed to things that look and act like websites, so I'm not aware or plugins or gems for wikis. - Dave On 10/26/2010 1:50 PM, Steven Yi wrote: > Hi Dave and Menno, > > Thanks for your input. I'm leaning towards a Wiki currently, and no > longer packaging anything with the app but pointing everything to the > Wiki. If we use a Wiki, we can have a "Manual" section, FAQ, sandbox, > etc. I think blueShare should continue to be blueShare, but having a > wiki area to collaborate on instrument designs/projects/etc. could > work nicely. > > Now, perhaps more a question for Dave, as I know you do work with ruby > and I assume rails: do you know of any good ruby plugins for > integrating a wiki into an application? I'm thinking it would be nice > to limit wiki access to users who are registered on the blue site with > accounts to help prevent spam. On the other hand, using something > like media wiki and styling/integrating it into the blue site is an > option as well. (Looks like wiki.rubyonrails.org is using dokuwiki > itself) > > Anyone's opinions on this would be very much appreciated! > > As for generated output, maybe we can find a plugin generate PDF from the wiki? > > Thanks! > steven > > On Mon, Oct 25, 2010 at 8:06 PM, Dave Seidel <da...@su...> wrote: >> Hi Steven, >> >> I think a web-based project would be great, either a wiki or something >> along the lines of what sites like the PHP and MySQL sites do, i.e., >> articles/pages with user comments (annotations). >> >> - Dave >> >> On 10/25/2010 7:12 PM, Steven Yi wrote: >>> Hi All, >>> >>> I'm going through and trying to get my bearings again on blue >>> development. I've also recently switched to using a Macbook Pro >>> full-time (I'm using it for work as I'm doing a fair amount of iPhone >>> and Android development which I can do all on the same machine), >>> though I'm still working out Csound compilation/installation and >>> getting blue setup. >>> >>> I wanted to ask though, does anyone have any thoughts on the blue >>> Manual? Or I should say, knowing that the blue manual is very much >>> out of date, I would like to begin working on it again, though I am >>> not sure what format/system I should use to create it. I thought about >>> using a wiki, using flossmanuals.net, and using Google Docs. While >>> Docbook creates excellent output, I'm thinking that it might be easier >>> for me to maintain a manual if I was able to use some sort of web app. >>> It would also give a side benefit of speeding up release compilation >>> of blue, as well as remove some dependencies to make it easier for >>> developers to download/compile/go with blue. >>> >>> Any thoughts? >>> >>> Thanks! >>> steven >>> >>> ------------------------------------------------------------------------------ >>> Nokia and AT&T present the 2010 Calling All Innovators-North America contest >>> Create new apps & games for the Nokia N8 for consumers in U.S. and Canada >>> $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing >>> Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store >>> http://p.sf.net/sfu/nokia-dev2dev >>> _______________________________________________ >>> Bluemusic-users mailing list >>> Blu...@li... >>> https://lists.sourceforge.net/lists/listinfo/bluemusic-users >>> >>> >> >> >> ------------------------------------------------------------------------------ >> Nokia and AT&T present the 2010 Calling All Innovators-North America contest >> Create new apps & games for the Nokia N8 for consumers in U.S. and Canada >> $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing >> Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store >> http://p.sf.net/sfu/nokia-dev2dev >> _______________________________________________ >> Bluemusic-users mailing list >> Blu...@li... >> https://lists.sourceforge.net/lists/listinfo/bluemusic-users >> > > ------------------------------------------------------------------------------ > Nokia and AT&T present the 2010 Calling All Innovators-North America contest > Create new apps & games for the Nokia N8 for consumers in U.S. and Canada > $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing > Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store > http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Bluemusic-users mailing list > Blu...@li... > https://lists.sourceforge.net/lists/listinfo/bluemusic-users > > |
From: menno <nab...@ya...> - 2010-10-26 07:23:34
|
Yes, at the moment the manual is a collection of 'things that concern Blue'. For example I think the section 'concepts' would be something for a wiki, also other contributions about how one can work with blue could be added there. And perhaps the wiki can be a place as well for the Blueshare instruments? The use of yet another place like the flossmanuals would not be my first choice - infromation about Blue should not be scattered everywhere around i think, but could find there home in the wiki too. On the other side i think a basic, solid manual that explains the basic functionality of Blue should be distributed along with the program. (Html, but i love pdf too - pdfs are nice to print out.) But i am not an expert on the possibilities, but i like information to be concentrated in one or two places: one place the official compact manual and the other a public place for users and experiences and ideas. greetings menno -- View this message in context: http://csound.1045644.n5.nabble.com/blue-Manual-tp3236356p3236643.html Sent from the Csound - Blue - User mailing list archive at Nabble.com. |
From: Wolf P. <pe...@re...> - 2010-10-27 07:31:02
|
Hello, Am 27.10.2010 01:48, schrieb Steven Yi: > Thanks Jan Jacob and Adam for your thoughts. If anyone knows of a wiki > system that allows PDF generation, please do let me know! I will > continue to look around but would happy for any suggestions. In my opinion to have both, a wiki (for contributing easyly by the blue community) and a PDF-Form (for offline help), would be best. The python-based MoinMoin wiki engine supports DocBook export, but I'm not experienced in the setup of this feature - the WikiEngine install itself is straightforward. http://moinmo.in/MoinMoinWiki - homepage http://www.wikimatrix.org/show/MoinMoin - features http://wikiindex.org/Category:MoinMoin - some wikis currently using it Best regards, Wolf |
From: cvr <cv...@on...> - 2010-10-27 14:46:07
|
Hi Steven, maybe this would work? ...: http://en.flossmanuals.net/bin/view/Csound/WebHome All the best, Clemens -- View this message in context: http://csound.1045644.n5.nabble.com/blue-Manual-tp3236356p3238832.html Sent from the Csound - Blue - User mailing list archive at Nabble.com. |
From: Steven Yi <ste...@gm...> - 2010-10-27 15:35:11
|
Hi Clemens, I thought about FLOSS but I think Menno had some reservations. On the other hand, taking a look now the output does look good as PDF. I'll take a closer look now. Thanks! steven On Wed, Oct 27, 2010 at 10:46 AM, cvr <cv...@on...> wrote: > > Hi Steven, > > maybe this would work? ...: > > http://en.flossmanuals.net/bin/view/Csound/WebHome > > > All the best, > > Clemens > -- > View this message in context: http://csound.1045644.n5.nabble.com/blue-Manual-tp3236356p3238832.html > Sent from the Csound - Blue - User mailing list archive at Nabble.com. > > ------------------------------------------------------------------------------ > Nokia and AT&T present the 2010 Calling All Innovators-North America contest > Create new apps & games for the Nokia N8 for consumers in U.S. and Canada > $10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing > Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store > http://p.sf.net/sfu/nokia-dev2dev > _______________________________________________ > Bluemusic-users mailing list > Blu...@li... > https://lists.sourceforge.net/lists/listinfo/bluemusic-users > |
From: menno <nab...@ya...> - 2010-10-28 05:41:31
|
Hi everybody, i am not familiar with the possibilities of the Fossmanuals site, i think it would be best to have a compact usage manual with Blue itself and on the web a place where users could give their output and input. I think it would be best not to scatter relevant information about Blue over several places.... -- View this message in context: http://csound.1045644.n5.nabble.com/blue-Manual-tp3236356p3239992.html Sent from the Csound - Blue - User mailing list archive at Nabble.com. |