From michael at civicrm.org Tue Jun 9 05:28:26 2015 From: michael at civicrm.org (Michael McAndrew) Date: Tue, 09 Jun 2015 14:28:26 +0200 Subject: [FM Discuss] objavi Message-ID: <5576DBEA.2020704@civicrm.org> Hey fm-folks, Any idea on if/when http://objavi.booki.ccwill be back up? We use it to publish our book and it doesn't seem to be working at the mo. Thanks, Michael -- Mobile (Spain): +34 671 78 97 76 Skype: michaelmcandrew From jo at flossmanuals.org Tue Jun 9 05:50:47 2015 From: jo at flossmanuals.org (Jo Paulger) Date: Tue, 9 Jun 2015 13:50:47 +0100 Subject: [FM Discuss] objavi In-Reply-To: <5576DBEA.2020704@civicrm.org> References: <5576DBEA.2020704@civicrm.org> Message-ID: I don't think it will, sorry. Try http://objavi.booktype.pro/? On 9 June 2015 at 13:28, Michael McAndrew wrote: > Hey fm-folks, > > Any idea on if/when http://objavi.booki.ccwill be back up? > > We use it to publish our book and it doesn't seem to be working at the mo. > > Thanks, > Michael > > > -- > Mobile (Spain): +34 671 78 97 76 > Skype: michaelmcandrew > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From michaelmcandrew at thirdsectordesign.org Tue Jun 9 13:21:58 2015 From: michaelmcandrew at thirdsectordesign.org (Michael McAndrew) Date: Tue, 09 Jun 2015 22:21:58 +0200 Subject: [FM Discuss] objavi In-Reply-To: References: <5576DBEA.2020704@civicrm.org> Message-ID: <55774AE6.4080309@thirdsectordesign.org> Hey Jo, Thanks for that. Not sure if that will help since I don't think that our book is connected to that Objavi, or is there a way that I can import it? Michael On 09/06/15 14:50, Jo Paulger wrote: > I don't think it will, sorry. Try http://objavi.booktype.pro/? > > On 9 June 2015 at 13:28, Michael McAndrew > wrote: > > Hey fm-folks, > > Any idea on if/when http://objavi.booki.ccwill be back up? > > We use it to publish our book and it doesn't seem to be working at > the mo. > > Thanks, > Michael > > > -- > Mobile (Spain): +34 671 78 97 76 > Skype: michaelmcandrew > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net -- Mobile (Spain): +34 671 789 776 Skype: michaelmcandrew -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Wed Jun 10 00:32:20 2015 From: mick at flossmanuals.net (Mick FM) Date: Wed, 10 Jun 2015 08:32:20 +0100 Subject: [FM Discuss] objavi In-Reply-To: <55774AE6.4080309@thirdsectordesign.org> References: <5576DBEA.2020704@civicrm.org> <55774AE6.4080309@thirdsectordesign.org> Message-ID: <5577E804.9070400@flossmanuals.net> On 09/06/15 21:21, Michael McAndrew wrote: > Hey Jo, > > Thanks for that. Not sure if that will help since I don't think that > our book is connected to that Objavi, or is there a way that I can > import it? Hi there Michael, I issue has had quite a bit of discussion around it on the admin list. http://lists.flossmanuals.net/listinfo.cgi/admin-flossmanuals.net I'm not able to check through the archives of the admin right now. But I think a quick summary is: * objavi.booki.cc uses a slightly older / modified code base * you can use the api at objavi.booktype.pro api to generate pdfs and epubs for books on booki.flossmanuals.net * the html export needed for our and your publishing process isn't produced by objavi.booki.cc Last year we were working on a replacement for booki publisher which used the exported epub as a base rather than the custom html output. We got stalled on that but it seems like a good time to revisit the options open to us to get the publishing sorted out again. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: From jo at flossmanuals.org Wed Jun 10 12:30:16 2015 From: jo at flossmanuals.org (Jo Paulger) Date: Wed, 10 Jun 2015 20:30:16 +0100 Subject: [FM Discuss] objavi In-Reply-To: <5577E804.9070400@flossmanuals.net> References: <5576DBEA.2020704@civicrm.org> <55774AE6.4080309@thirdsectordesign.org> <5577E804.9070400@flossmanuals.net> Message-ID: Apologies Michael, I only gave you part of the workaround there. Here's the full instructions which will hopefully work for you as a stop gap to get epub/pdf etc from booki.flossmanuals.net: The workaround is to import it into http://booktype-demo.sourcefabric.org/ and download the file(s) from there. Here's how: * Register for an account at http://booktype-demo.sourcefabric.org/ * Log in * Go to My Dashboard (top left) * Go to My Books tab * Click "Import Book" button and then: * select "Copy or import Booktype book" * for Source, enter the URL of your book at booki.flossmanual.net (eg. http://booki.flossmanuals.net/manualname) * and enter your desired title * you can also choose whether to keep it initially hidden from others * click Import button * you should then have access to edit your manual in much the same way you're used to at booki.flossmanuals.net (booktype-demo.sourcefabric.org is just a more up-to-date version of our software that hasn't been branded for FM). * select the Publish tab, and then you can download your manual in PDF or epub formats. On the replacement booki publisher, I'm afraid I have gotten a bit sidetracked on other things (blimey time flies when you're busy) and will get back to finish it as soon as I can now - sorry! However, that's only going to be part of the solution to the larger problem because it'll still need booki.flossmanuals.net to be able to publish epub which I don't think it can without objavi.booki.cc. On 10 June 2015 at 08:32, Mick FM wrote: > > > On 09/06/15 21:21, Michael McAndrew wrote: > > Hey Jo, > > Thanks for that. Not sure if that will help since I don't think that our > book is connected to that Objavi, or is there a way that I can import it? > > > Hi there Michael, > > I issue has had quite a bit of discussion around it on the admin list. > http://lists.flossmanuals.net/listinfo.cgi/admin-flossmanuals.net > > I'm not able to check through the archives of the admin right now. But I > think a quick summary is: > > * objavi.booki.cc uses a slightly older / modified code base > * you can use the api at objavi.booktype.pro api to generate pdfs and > epubs for books on booki.flossmanuals.net > * the html export needed for our and your publishing process isn't > produced by objavi.booki.cc > > Last year we were working on a replacement for booki publisher which used > the exported epub as a base rather than the custom html output. We got > stalled on that but it seems like a good time to revisit the options open > to us to get the publishing sorted out again. > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > http://clearerchannel.org - training and freelance workhttp://flossmanuals.net - Free Manuals for Free Software > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From anna at phplist.com Thu Jun 11 02:25:43 2015 From: anna at phplist.com (Anna F J Morris) Date: Thu, 11 Jun 2015 10:25:43 +0100 Subject: [FM Discuss] objavi In-Reply-To: References: <5576DBEA.2020704@civicrm.org> <55774AE6.4080309@thirdsectordesign.org> <5577E804.9070400@flossmanuals.net> Message-ID: <55795417.2020102@phplist.com> Hi Is it worth having a sprint or something to get this all done? I really (really) don't understand the scope or the problem but I get the impression from others that basically you can't publish from flossmanuals now without odd workarrounds. This seems like a big problem. I would be happy to facilitate in a non technical way, for example I could provide food if you had a sprint, and do the cooking etc, as a donation to the project. Kind Regards Anna phpList On 10/06/15 20:30, Jo Paulger wrote: > Apologies Michael, I only gave you part of the workaround there. > Here's the full instructions which will hopefully work for you as a > stop gap to get epub/pdf etc from booki.flossmanuals.net > : > > The workaround is to import it > into http://booktype-demo.sourcefabric.org/ and download the file(s) > from there. Here's how: > > * Register for an account at http://booktype-demo.sourcefabric.org/ > * Log in > * Go to My Dashboard (top left) > * Go to My Books tab > * Click "Import Book" button and then: > * select "Copy or import Booktype book" > * for Source, enter the URL of your book at booki.flossmanual.net > (eg. > http://booki.flossmanuals.net/manualname) > * and enter your desired title > * you can also choose whether to keep it initially hidden from others > * click Import button > * you should then have access to edit your manual in much the same way > you're used to at booki.flossmanuals.net > (booktype-demo.sourcefabric.org > is just a more up-to-date > version of our software that hasn't been branded for FM). > * select the Publish tab, and then you can download your manual in PDF > or epub formats. > > On the replacement booki publisher, I'm afraid I have gotten a bit > sidetracked on other things (blimey time flies when you're busy) and > will get back to finish it as soon as I can now - sorry! However, > that's only going to be part of the solution to the larger problem > because it'll still need booki.flossmanuals.net > to be able to publish epub which I > don't think it can without objavi.booki.cc . > > On 10 June 2015 at 08:32, Mick FM > wrote: > > > > On 09/06/15 21:21, Michael McAndrew wrote: >> Hey Jo, >> >> Thanks for that. Not sure if that will help since I don't think >> that our book is connected to that Objavi, or is there a way that >> I can import it? > > Hi there Michael, > > I issue has had quite a bit of discussion around it on the admin > list. > http://lists.flossmanuals.net/listinfo.cgi/admin-flossmanuals.net > > I'm not able to check through the archives of the admin right now. > But I think a quick summary is: > > * objavi.booki.cc uses a slightly older / > modified code base > * you can use the api at objavi.booktype.pro > api to generate pdfs and epubs for > books on booki.flossmanuals.net > * the html export needed for our and your publishing process isn't > produced by objavi.booki.cc > > Last year we were working on a replacement for booki publisher > which used the exported epub as a base rather than the custom html > output. We got stalled on that but it seems like a good time to > revisit the options open to us to get the publishing sorted out > again. > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > > http://clearerchannel.org - training and freelance work > http://flossmanuals.net - Free Manuals for Free Software > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList -------------- next part -------------- An HTML attachment was scrubbed... URL: From epirat07 at gmail.com Thu Jun 11 02:54:22 2015 From: epirat07 at gmail.com (Marvin Scholz) Date: Thu, 11 Jun 2015 11:54:22 +0200 Subject: [FM Discuss] State of the english Flossmanuals Message-ID: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> Hey, I would like to ask what is going on with the english Flossmanuals Website. The Website looks really outdated and in some aspects is really hard to understand and use. There are even some Pages that just look completely broken. And I am only talking about the frontend. A few weeks ago I updated the Icecast manuals as we were getting a complain about it on our mailinglist although we didn't wrote the original version. Anyway I decided to contribute to the project as I thought it is a really great idea and should be supported. But to be honest, the book editing experience is horrible. And that hardly expresses how bad it really is. After already having written quite some stuff, I decided to add a new Image, but when I uploaded it I was redirected to a new blank page, all my editing work lost. Yay... Anyway I wrote all the stuff again, now using a new tab to do the attachment uploads as they always result in a blank page but succeed anyway. Another horrible thing is the WYSIWYG Editor which is just horrible to use and super old. Now a few weeks after making it through the horrible experience of updating the manual, it's still not live and that is very sad. I already used the contact form on the blog post talking about that help is needed but received no answer. I really think that the Flossmanuals project is a nice thing and would love to help making it better. If this is not possible I would at least want to ask that the Icecast manual is removed or a huge hint added that it is outdated, to prevent newbie users using it, as it will not work anymore with newer versions on some aspects, which caused some users apparently to think that Icecast must be broken and that we do not care about updating our manuals which is not the case. Any information about the current state of the project would be much appreciated, even more some information if help with something is needed. From jh at joachimheintz.de Sat Jun 13 08:32:47 2015 From: jh at joachimheintz.de (joachim heintz) Date: Sat, 13 Jun 2015 17:32:47 +0200 Subject: [FM Discuss] can i publish? Message-ID: <557C4D1F.9060809@joachimheintz.de> hi there - we are now ready to publish the new release of the csound floss manual. can i do this as i did one year ago, or has anything changed? i know there were some issues some months ago; not sure whether they could be fixed or not. thanks and regards - joachim From mick at flossmanuals.net Sat Jun 13 11:22:39 2015 From: mick at flossmanuals.net (Mick FM) Date: Sat, 13 Jun 2015 19:22:39 +0100 Subject: [FM Discuss] can i publish? In-Reply-To: <557C4D1F.9060809@joachimheintz.de> References: <557C4D1F.9060809@joachimheintz.de> Message-ID: <557C74EF.1020808@flossmanuals.net> On 13/06/15 16:32, joachim heintz wrote: > hi there - > > we are now ready to publish the new release of the csound floss manual. > > can i do this as i did one year ago, or has anything changed? i know > there were some issues some months ago; not sure whether they could be > fixed or not. Hi there, We'll have to do it little differently at the moment. I'll get back on Monday with a full plan. We should be able to do this by Tuesday. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From jh at joachimheintz.de Sat Jun 13 11:33:09 2015 From: jh at joachimheintz.de (joachim heintz) Date: Sat, 13 Jun 2015 20:33:09 +0200 Subject: [FM Discuss] can i publish? In-Reply-To: <557C74EF.1020808@flossmanuals.net> References: <557C4D1F.9060809@joachimheintz.de> <557C74EF.1020808@flossmanuals.net> Message-ID: <557C7765.1030305@joachimheintz.de> great; thanks, mick - joachim Am 13.06.2015 um 20:22 schrieb Mick FM: > > > On 13/06/15 16:32, joachim heintz wrote: >> hi there - >> >> we are now ready to publish the new release of the csound floss manual. >> >> can i do this as i did one year ago, or has anything changed? i know >> there were some issues some months ago; not sure whether they could be >> fixed or not. > > Hi there, > > We'll have to do it little differently at the moment. I'll get back on > Monday with a full plan. > We should be able to do this by Tuesday. > > nice one > Mick > From mick at flossmanuals.net Tue Jun 16 02:40:36 2015 From: mick at flossmanuals.net (Mick FM) Date: Tue, 16 Jun 2015 10:40:36 +0100 Subject: [FM Discuss] objavi In-Reply-To: <55795417.2020102@phplist.com> References: <5576DBEA.2020704@civicrm.org> <55774AE6.4080309@thirdsectordesign.org> <5577E804.9070400@flossmanuals.net> <55795417.2020102@phplist.com> Message-ID: <557FEF14.3000206@flossmanuals.net> On 11/06/15 10:25, Anna F J Morris wrote: > Hi > > Is it worth having a sprint or something to get this all done? > > I really (really) don't understand the scope or the problem but I get > the impression from others that basically you can't publish from > flossmanuals now without odd workarrounds. This seems like a big problem. > > I would be happy to facilitate in a non technical way, for example I > could provide food if you had a sprint, and do the cooking etc, as a > donation to the project. Hi there Anna, That's a kind offer. As you are on the admin list you'll know I've got some ideas around this. There are a couple of areas that do need some community input coming up soon which would be suitable for a sprint but I think we are very near getting a plan in place to be able to get a good frame work in place for community involvement. The more fundamental structure elements are I think beyond what is a good idea to have in just volunteers hands, as there would be a danger of burn out there. I'm moving to Todmorden - just over the hill from you - and there's a great community pub there. Rather than doing the hosting, it would be better to use your web-dev skills for a weekend hack on a new front end for publisher. What about we set a date for September for this when people are back from their holidays. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: From anna at phplist.com Tue Jun 16 03:03:35 2015 From: anna at phplist.com (Anna F J Morris) Date: Tue, 16 Jun 2015 11:03:35 +0100 Subject: [FM Discuss] objavi In-Reply-To: <557FEF14.3000206@flossmanuals.net> References: <5576DBEA.2020704@civicrm.org> <55774AE6.4080309@thirdsectordesign.org> <5577E804.9070400@flossmanuals.net> <55795417.2020102@phplist.com> <557FEF14.3000206@flossmanuals.net> Message-ID: <557FF477.7080603@phplist.com> On 16/06/15 10:40, Mick FM wrote: > Rather than doing the hosting, it would be better to use your web-dev > skills for a weekend hack on a new front end for publisher. Sure, however, I have very very low levels of skill here. I can design a site very well but can't build it. I have a lot to offer in terms of designing community facilities however :) > > What about we set a date for September for this when people are back > from their holidays. Sure :) -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From vitolink at gmail.com Wed Jun 17 02:12:44 2015 From: vitolink at gmail.com (Vitaliy Grishenko) Date: Wed, 17 Jun 2015 12:12:44 +0300 Subject: [FM Discuss] cover page Message-ID: <47C19A00-8A99-4037-9377-30BA5E39F27F@gmail.com> Hello everybody, is any of you guys a designer? We?ve created a landing page (http://thunderbird-ru.flossmanuals.net) for the Russian version of this tutorial on PGP (http://flossmanuals.net/thunderbird-workbook/). It would be great to have a simple cover page for this tutorial to replace the default one (http://thunderbird-ru.flossmanuals.net/index_files/CF_cover.png). Thank you very much in advance! I look forward to hearing from you. Best, Vitaliy From mickfuzz23 at gmail.com Thu Jun 11 05:44:18 2015 From: mickfuzz23 at gmail.com (Mick Fuzz) Date: Thu, 11 Jun 2015 13:44:18 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> Message-ID: <08BC2865-32DA-4D6B-879C-9B0C85B59FE3@gmail.com> hi Marvin, Do you want the short answer or the long one? Mick on the move. > On 11 Jun 2015, at 10:54, Marvin Scholz wrote: > > Hey, I would like to ask what is going on with the english Flossmanuals Website. > The Website looks really outdated and in some aspects is really hard to understand and use. There are even some Pages that just look completely broken. And I am only talking about the frontend. > A few weeks ago I updated the Icecast manuals as we were getting a complain about it on our mailinglist although we didn't wrote the original version. Anyway I decided to contribute to the project as I thought it is a really great idea and should be supported. But to be honest, the book editing experience is horrible. And that hardly expresses how bad it really is. After already having written quite some stuff, I decided to add a new Image, but when I uploaded it I was redirected to a new blank page, all my editing work lost. Yay... > Anyway I wrote all the stuff again, now using a new tab to do the attachment uploads as they always result in a blank page but succeed anyway. > Another horrible thing is the WYSIWYG Editor which is just horrible to use and super old. > > Now a few weeks after making it through the horrible experience of updating the manual, it's still not live and that is very sad. > I already used the contact form on the blog post talking about that help is needed but received no answer. > I really think that the Flossmanuals project is a nice thing and would love to help making it better. > > If this is not possible I would at least want to ask that the Icecast manual is removed or a huge hint added that it is outdated, to prevent newbie users using it, as it will not work anymore with newer versions on some aspects, which caused some users apparently to think that Icecast must be broken and that we do not care about updating our manuals which is not the case. > > Any information about the current state of the project would be much appreciated, even more some information if help with something is needed. > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net From mick at flossmanuals.net Wed Jun 17 04:57:51 2015 From: mick at flossmanuals.net (Mick FM) Date: Wed, 17 Jun 2015 12:57:51 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> Message-ID: <558160BF.90300@flossmanuals.net> Hi Marvin, I found out from Jo that my reply to this didn't make it to the list. So in that reply I asked - do you want the short answer or the long answer? Well the medium length answer is that a small team have been working on it but have struggled with the complexities of the system that was in place. We stalled on this process around the new year but are picking this up again now I am happy to say. We can do a work around to make the manual live for the short term. Great work that you have updated. Let's try to celebrate that as well maybe with a short email press release? Also would you consider joining the admin list as well to beta test what we are creating? nice one Mick On 11/06/15 10:54, Marvin Scholz wrote: > Hey, I would like to ask what is going on with the english Flossmanuals Website. > The Website looks really outdated and in some aspects is really hard to understand and use. There are even some Pages that just look completely broken. And I am only talking about the frontend. > A few weeks ago I updated the Icecast manuals as we were getting a complain about it on our mailinglist although we didn't wrote the original version. Anyway I decided to contribute to the project as I thought it is a really great idea and should be supported. But to be honest, the book editing experience is horrible. And that hardly expresses how bad it really is. After already having written quite some stuff, I decided to add a new Image, but when I uploaded it I was redirected to a new blank page, all my editing work lost. Yay... > Anyway I wrote all the stuff again, now using a new tab to do the attachment uploads as they always result in a blank page but succeed anyway. > Another horrible thing is the WYSIWYG Editor which is just horrible to use and super old. > > Now a few weeks after making it through the horrible experience of updating the manual, it's still not live and that is very sad. > I already used the contact form on the blog post talking about that help is needed but received no answer. > I really think that the Flossmanuals project is a nice thing and would love to help making it better. > > If this is not possible I would at least want to ask that the Icecast manual is removed or a huge hint added that it is outdated, to prevent newbie users using it, as it will not work anymore with newer versions on some aspects, which caused some users apparently to think that Icecast must be broken and that we do not care about updating our manuals which is not the case. > > Any information about the current state of the project would be much appreciated, even more some information if help with something is needed. > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From epirat07 at gmail.com Wed Jun 17 06:01:44 2015 From: epirat07 at gmail.com (Marvin Scholz) Date: Wed, 17 Jun 2015 15:01:44 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558160BF.90300@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> Message-ID: <7496331E-67B1-45BB-8ED5-EC04F0623F4B@gmail.com> On 17 Jun 2015, at 13:57, Mick FM wrote: > So in that reply I asked - do you want the short answer or the long > answer? As my original mail was very long, I have no problems with a long answer. > Well the medium length answer is that a small team have been working > on > it but have struggled with the complexities of the system that was in > place. > We stalled on this process around the new year but are picking this up > again now I am happy to say. That are good news, let me know if there is anything I can help with. > We can do a work around to make the manual live for the short term. > Great work that you have updated. Let's try to celebrate that as well > maybe with a short email press release? If it is possible to update the manual, I would rather update more aspects of it as I only updated what was needing an urgent update for now. Specially with our new 2.5 release soon, there will be a number of changes. > Also would you consider joining the admin list as well to beta test > what > we are creating? Sure, unfortunately I'm not able to find it? Can you point me to the URL where to find the list? From mick at flossmanuals.net Wed Jun 17 06:10:28 2015 From: mick at flossmanuals.net (Mick FM) Date: Wed, 17 Jun 2015 14:10:28 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <7496331E-67B1-45BB-8ED5-EC04F0623F4B@gmail.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <7496331E-67B1-45BB-8ED5-EC04F0623F4B@gmail.com> Message-ID: <558171C4.5030206@flossmanuals.net> On 17/06/15 14:01, Marvin Scholz wrote: >> > If it is possible to update the manual, I would rather update more > aspects of it as I only updated what was needing an urgent update for > now. Specially with our new 2.5 release soon, there will be a number > of changes. > >> Also would you consider joining the admin list as well to beta test what >> we are creating? > Sure, unfortunately I'm not able to find it? Can you point me to the > URL where to find the list? Hi there, Thanks for your understanding Marvin, It's here - http://lists.flossmanuals.net/listinfo.cgi/admin-flossmanuals.net Have a look at the solution that we came up with as a work around for Vitaliy. Here we have linked to the live site instead of a published one. In the case of Icecast that would be http://booki.flossmanuals.net/icecast/introduction/ Also in regards to your concern about the out of date manual Jo has done a quick hack on the server to put up the following message at - http://flossmanuals.net/icecast If you check you'll see that the epub and pdf links there are to the updated manual. Thanks Jo! On 17/06/15 10:12, Vitaliy Grishenko wrote: > Hello everybody, > > is any of you guys a designer? We?ve created a landing page (http://thunderbird-ru.flossmanuals.net) for the Russian version of this tutorial on PGP (http://flossmanuals.net/thunderbird-workbook/). It would be great to have a simple cover page for this tutorial to replace the default one (http://thunderbird-ru.flossmanuals.net/index_files/CF_cover.png). Thank you very much in advance! > > I look forward to hearing from you. > > Best, > Vitaliy -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From epirat07 at gmail.com Wed Jun 17 06:42:17 2015 From: epirat07 at gmail.com (Marvin Scholz) Date: Wed, 17 Jun 2015 15:42:17 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558171C4.5030206@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <7496331E-67B1-45BB-8ED5-EC04F0623F4B@gmail.com> <558171C4.5030206@flossmanuals.net> Message-ID: <3B0BE52F-C034-4555-BE39-BC82245525F6@gmail.com> On 17 Jun 2015, at 15:10, Mick FM wrote: > It's here - > http://lists.flossmanuals.net/listinfo.cgi/admin-flossmanuals.net I just subscribed to the list. > Have a look at the solution that we came up with as a work around for > Vitaliy. > Here we have linked to the live site instead of a published one. > In the case of Icecast that would be > http://booki.flossmanuals.net/icecast/introduction/ > > Also in regards to your concern about the out of date manual Jo has done > a quick hack on the server to put up the following message at - > http://flossmanuals.net/icecast Thank you very much! From mark.r.hancock at gmail.com Wed Jun 17 08:16:14 2015 From: mark.r.hancock at gmail.com (Mark Hancock) Date: Wed, 17 Jun 2015 16:16:14 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558160BF.90300@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> Message-ID: Hi, This is purely free thinking and I?ve had a lot of green tea today, but is there any way FLOSS manuals could move over to GitHub for production? I?m imagining there are several reasons not to, but it is stable and I know a few people are using it to write manuals these days. Happy for someone to point out something really obvious that I?ve not realised about this idea. Cheers M > On 17 Jun 2015, at 12:57, Mick FM wrote: > > Hi Marvin, > > I found out from Jo that my reply to this didn't make it to the list. > > So in that reply I asked - do you want the short answer or the long answer? > > Well the medium length answer is that a small team have been working on > it but have struggled with the complexities of the system that was in > place. > We stalled on this process around the new year but are picking this up > again now I am happy to say. > > We can do a work around to make the manual live for the short term. > Great work that you have updated. Let's try to celebrate that as well > maybe with a short email press release? > > Also would you consider joining the admin list as well to beta test what > we are creating? > > > nice one > Mick > > > On 11/06/15 10:54, Marvin Scholz wrote: >> Hey, I would like to ask what is going on with the english Flossmanuals Website. >> The Website looks really outdated and in some aspects is really hard to understand and use. There are even some Pages that just look completely broken. And I am only talking about the frontend. >> A few weeks ago I updated the Icecast manuals as we were getting a complain about it on our mailinglist although we didn't wrote the original version. Anyway I decided to contribute to the project as I thought it is a really great idea and should be supported. But to be honest, the book editing experience is horrible. And that hardly expresses how bad it really is. After already having written quite some stuff, I decided to add a new Image, but when I uploaded it I was redirected to a new blank page, all my editing work lost. Yay... >> Anyway I wrote all the stuff again, now using a new tab to do the attachment uploads as they always result in a blank page but succeed anyway. >> Another horrible thing is the WYSIWYG Editor which is just horrible to use and super old. >> >> Now a few weeks after making it through the horrible experience of updating the manual, it's still not live and that is very sad. >> I already used the contact form on the blog post talking about that help is needed but received no answer. >> I really think that the Flossmanuals project is a nice thing and would love to help making it better. >> >> If this is not possible I would at least want to ask that the Icecast manual is removed or a huge hint added that it is outdated, to prevent newbie users using it, as it will not work anymore with newer versions on some aspects, which caused some users apparently to think that Icecast must be broken and that we do not care about updating our manuals which is not the case. >> >> Any information about the current state of the project would be much appreciated, even more some information if help with something is needed. >> _______________________________________________ >> Discuss mailing list >> Discuss at lists.flossmanuals.net >> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > > http://clearerchannel.org - training and freelance work > http://flossmanuals.net - Free Manuals for Free Software > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net From mick at flossmanuals.net Wed Jun 17 11:42:45 2015 From: mick at flossmanuals.net (Mick FM) Date: Wed, 17 Jun 2015 19:42:45 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> Message-ID: <5581BFA5.1010300@flossmanuals.net> On 17/06/15 16:16, Mark Hancock wrote: > Hi, > > This is purely free thinking and I?ve had a lot of green tea today, but is there any way FLOSS manuals could move over to GitHub for production? I?m imagining there are several reasons not to, but it is stable and I know a few people are using it to write manuals these days. > > Happy for someone to point out something really obvious that I?ve not realised about this idea. > > Cheers > > M Hi Mark, This is a good point. There are some good solutions out there for those able to use MarkUp and git. These are really getting a lot of pick up. eg. https://www.gitbook.com/ https://readthedocs.org/ I'm ccing Simon as I realise that I forgot to answer a similar email he sent a while ago asking the same kind of question. I think this is a good choice for many projects especially for technical projects where they are documented mainly by coders. I personally don't think it's good for FM as really we want to lower barriers to writing docs, so having to use git, or mark up doesn't really fit the bill. I'd be really interested to know what other people think of other options and how they stack up against Booktype. The preview I've had of Booktype 2.0 is looking good and I think we've found a solution to the current hole we are in which would involve minimal complexity of migrating the data (which has really held us up so far) I'd also be interested to know what people thought were the essential features for a diverse, low entry point, collaborative writing community such as FM. For me some of the musts are: * what you see is what you get editor (no mark up code knowledge needed) * easy way to upload and place images * simple web log in, and writing workflow * ability to leave with your book (ie export an epub or similar) * ability to import your book (ie epub import or similar) nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From epirat07 at gmail.com Wed Jun 17 11:57:05 2015 From: epirat07 at gmail.com (Marvin Scholz) Date: Wed, 17 Jun 2015 20:57:05 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581BFA5.1010300@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> Message-ID: On 17 Jun 2015, at 20:42, Mick FM wrote: > I personally don't think it's good for FM as really we want to lower > barriers to writing docs, so having to use git, or mark up doesn't > really fit the bill. Hey, well to be honest I think the opposite is the case. Most people writing technical documentation would prefer a markup language like Markdown instead of a WYSIWG editor. A lot of sites do a "best of both worlds" solution by having an editor that has buttons for most common formatting and inserts the correct Markdown. I mean if I get it right, it's mostly about open source software, and I think people that have enough understanding to write those, know how to use Markdown or, if they prefer, HTML. I agree that having a WYSIWYG Editor is nice, but I would definitely find it much easier if I could switch to a Markdown editor in account settings or such as I prefer to use Markdown or even HTML over a graphical editor. From mick at flossmanuals.net Wed Jun 17 12:51:28 2015 From: mick at flossmanuals.net (Mick FM) Date: Wed, 17 Jun 2015 20:51:28 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> Message-ID: <5581CFC0.70609@flossmanuals.net> On 17/06/15 19:57, Marvin Scholz wrote: > >> I personally don't think it's good for FM as really we want to lower >> barriers to writing docs, so having to use git, or mark up doesn't >> really fit the bill. > > Hey, well to be honest I think the opposite is the case. Most people > writing technical > documentation would prefer a markup language like Markdown instead of > a WYSIWG editor. I hear what you are saying there, and I wouldn't dispute it, but let me clarify a bit, I meant that the goal is to make it as easy as possible for *anyone* to write docs without any other technical knowledge. > A lot of sites do a "best of both worlds" solution by having an editor > that has buttons for > most common formatting and inserts the correct Markdown. Sure, that would be ideal, definitely. And even more ideal if technically able writers could write via markdown and git and others who were less technical could write via a web interface. I think this has already been mentioned on this list but for Booktype 2.0 the Aloha editor is used. http://www.alohaeditor.org/ This looks to be a huge improvement! nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From helen at creative-catalyst.com Wed Jun 17 13:47:36 2015 From: helen at creative-catalyst.com (helen varley jamieson) Date: Wed, 17 Jun 2015 22:47:36 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581CFC0.70609@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> Message-ID: <5581DCE8.8080401@creative-catalyst.com> i work on the UpStage manual, for which we have (occasionally) had contributions from users of the platform who are not at all technical. it has been really helpful to be able to involve these people in the manual-writing process. in fact the previous FM interface was almost too difficult for people to use. keeping it simple for users of software to be able to contribute is really important, since users will write quite different instructions to those who wrote the software. h : ) On 17/06/15 9:51 28PM, Mick FM wrote: > > > On 17/06/15 19:57, Marvin Scholz wrote: >> >>> I personally don't think it's good for FM as really we want to lower >>> barriers to writing docs, so having to use git, or mark up doesn't >>> really fit the bill. >> >> Hey, well to be honest I think the opposite is the case. Most people >> writing technical >> documentation would prefer a markup language like Markdown instead of >> a WYSIWG editor. > > I hear what you are saying there, and I wouldn't dispute it, but let me > clarify a bit, I meant that the goal is to make it as easy as possible > for *anyone* to write docs without any other technical knowledge. > >> A lot of sites do a "best of both worlds" solution by having an editor >> that has buttons for >> most common formatting and inserts the correct Markdown. > > Sure, that would be ideal, definitely. > And even more ideal if technically able writers could write via markdown > and git and others who were less technical could write via a web interface. > > I think this has already been mentioned on this list but for Booktype > 2.0 the Aloha editor is used. > http://www.alohaeditor.org/ > This looks to be a huge improvement! > > nice one > Mick > > > -- helen varley jamieson helen at creative-catalyst.com http://www.creative-catalyst.com http://www.upstage.org.nz Magdalena M?nchen - Erstes Treffen: 5-7 June 2015 From mokurai at sugarlabs.org Wed Jun 17 14:02:57 2015 From: mokurai at sugarlabs.org (Edward Mokurai Cherlin) Date: Wed, 17 Jun 2015 17:02:57 -0400 Subject: [FM Discuss] State of the english Flossmanuals Message-ID: Thanks, Mick. I have been holding off on some projects ever since the first promise of migrating to Booktype (originally Real Soon Now), due to current problems I have had under booki. When that happens, I can recruit some more people and get those projects started. Let me know if I can help with the migration. On Wed, June 17, 2015 2:42 pm, Mick FM wrote: > > > On 17/06/15 16:16, Mark Hancock wrote: >> Hi, >> >> This is purely free thinking and I've had a lot of green tea today, >> but is there any way FLOSS manuals could move over to GitHub for >> production? I'm imagining there are several reasons not to, but it is >> stable and I know a few people are using it to write manuals these days. >> >> Happy for someone to point out something really obvious that I???ve not >> realised about this idea. >> >> Cheers >> >> M > > Hi Mark, > > This is a good point. There are some good solutions out there for those > able to use MarkUp and git. > These are really getting a lot of pick up. eg. > > https://www.gitbook.com/ > https://readthedocs.org/ > > I'm ccing Simon as I realise that I forgot to answer a similar email he > sent a while ago asking the same kind of question. > > I think this is a good choice for many projects especially for technical > projects where they are documented mainly by coders. > > I personally don't think it's good for FM as really we want to lower > barriers to writing docs, so having to use git, or mark up doesn't > really fit the bill. > > I'd be really interested to know what other people think of other > options and how they stack up against Booktype. > > The preview I've had of Booktype 2.0 is looking good and I think we've > found a solution to the current hole we are in which would involve > minimal complexity of migrating the data (which has really held us up so > far) > > I'd also be interested to know what people thought were the essential > features for a diverse, low entry point, collaborative writing community > such as FM. For me some of the musts are: > > * what you see is what you get editor (no mark up code knowledge needed) > * easy way to upload and place images > * simple web log in, and writing workflow > * ability to leave with your book (ie export an epub or similar) > * ability to import your book (ie epub import or similar) > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > > http://clearerchannel.org - training and freelance work > http://flossmanuals.net - Free Manuals for Free Software > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > -- Edward Mokurai (??/??????????/???????) Cherlin Silent Thunder is my name, and Children are my nation. The Cosmos is my dwelling place, the Truth my destination. http://wiki.sugarlabs.org/go/Replacing_Textbooks -- Edward Mokurai (??/??????????/???????) Cherlin Silent Thunder is my name, and Children are my nation. The Cosmos is my dwelling place, the Truth my destination. http://wiki.sugarlabs.org/go/Replacing_Textbooks From andre at andrecastro.info Wed Jun 17 14:56:54 2015 From: andre at andrecastro.info (andre) Date: Wed, 17 Jun 2015 23:56:54 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581DCE8.8080401@creative-catalyst.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> Message-ID: <5581ED26.4020608@andrecastro.info> Sorry to barge in. I just been lurking for a a couple of months on the floss manuals list and have been a reader for some years(floss manuals helped me a lot to get into free software). I am grateful to the project and hope I can somehow contribute. The discussion concerning a more flexible system for writing-publishing-maintaining floss manuals got me interested, so I'll trow in my 2cents. At a point in the discussion GitHub was suggested as a possibility. Although it sounds tempting, as it was already referred, it can discourage less tech minded people from contributing. But then aren't most of those writing the manuals familiar with git and markdown? On-the-other-hand using GitHub, seems like a contradiction for a project focused on the dissemination of floss, as GitHub is not an open source initiative, but a proprietary service, based on Git. Mediawiki could be another interesting solution. I allow writing in both wiki syntax or with a WYSIWYG editor, and I believe there are a few plugins that allow the use of markdown. It lends itself to a number of editing and publishing workflow, and organizational structure. The markup can easily and cleanly converted to HTML (epub and Pdf, with so hacks needed for the last). And includes a very comprehensive web api. curious where the discussion will head. best a On 06/17/2015 10:47 PM, helen varley jamieson wrote: > i work on the UpStage manual, for which we have (occasionally) had > contributions from users of the platform who are not at all technical. > it has been really helpful to be able to involve these people in the > manual-writing process. in fact the previous FM interface was almost too > difficult for people to use. keeping it simple for users of software to > be able to contribute is really important, since users will write quite > different instructions to those who wrote the software. > > h : ) > > On 17/06/15 9:51 28PM, Mick FM wrote: >> >> >> On 17/06/15 19:57, Marvin Scholz wrote: >>> >>>> I personally don't think it's good for FM as really we want to lower >>>> barriers to writing docs, so having to use git, or mark up doesn't >>>> really fit the bill. >>> >>> Hey, well to be honest I think the opposite is the case. Most people >>> writing technical >>> documentation would prefer a markup language like Markdown instead of >>> a WYSIWG editor. >> >> I hear what you are saying there, and I wouldn't dispute it, but let me >> clarify a bit, I meant that the goal is to make it as easy as possible >> for *anyone* to write docs without any other technical knowledge. >> >>> A lot of sites do a "best of both worlds" solution by having an editor >>> that has buttons for >>> most common formatting and inserts the correct Markdown. >> >> Sure, that would be ideal, definitely. >> And even more ideal if technically able writers could write via markdown >> and git and others who were less technical could write via a web interface. >> >> I think this has already been mentioned on this list but for Booktype >> 2.0 the Aloha editor is used. >> http://www.alohaeditor.org/ >> This looks to be a huge improvement! >> >> nice one >> Mick >> >> >> > -- pinknoi.so bibliotecha.info andrecastro.info/a/acastro.gpg --..,___.--,--'-,---..-.--+--.,,-,,... From anna at phplist.com Thu Jun 18 03:06:56 2015 From: anna at phplist.com (Anna F J Morris) Date: Thu, 18 Jun 2015 11:06:56 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581BFA5.1010300@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> Message-ID: <55829840.9000401@phplist.com> On 17/06/15 19:42, Mick FM wrote: > I'd be really interested to know what other people think of other > options and how they stack up against Booktype. at phpList we looked at a lot of options but choose FM because of the simple software (while it has issues, it is easy to use) and also the "book" idea in itself. We used to have a wiki but a large number of our users have a very technical skill level and they find this confusing I think - there is something more understandable about a "book." -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From mark.r.hancock at gmail.com Thu Jun 18 03:13:13 2015 From: mark.r.hancock at gmail.com (Mark Hancock) Date: Thu, 18 Jun 2015 11:13:13 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <55829840.9000401@phplist.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <55829840.9000401@phplist.com> Message-ID: <36893DB8-8606-44A4-A767-60CCAAA884E8@gmail.com> I love books and the thing I?ve always liked about FLOSS manuals is the publishing model and the option to output as a book. I think I?m in favour of sticking with the platform, now I?ve seen the arguments for and against. My input isn?t much more than promoting the idea of FLOSS manuals across my media channels (fancy way of saying Twitter and Facebook), but I?d be happy to apply some of my low level tech skills to helping out on back end stuff if that?s possible? Build with what we?ve got, I guess? M > On 18 Jun 2015, at 11:06, Anna F J Morris wrote: > > On 17/06/15 19:42, Mick FM wrote: >> I'd be really interested to know what other people think of other >> options and how they stack up against Booktype. > > at phpList we looked at a lot of options but choose FM because of the > simple software (while it has issues, it is easy to use) and also the > "book" idea in itself. We used to have a wiki but a large number of our > users have a very technical skill level and they find this confusing I > think - there is something more understandable about a "book." > > -- > Share the phpList love! > Twitter: @phpList > Facebook: facebook.com/phpList > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net From anna at phplist.com Thu Jun 18 03:14:26 2015 From: anna at phplist.com (Anna F J Morris) Date: Thu, 18 Jun 2015 11:14:26 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> Message-ID: <55829A02.6060904@phplist.com> On 17/06/15 19:57, Marvin Scholz wrote: > I think people that > have enough understanding to write those, know how to use Markdown or, > if they prefer, HTML. hi, not really the case in our example. I mean, phpList is email newsletter/marketing software, that it's Open Source is why *I* work on it, but many (most?) of our users don't know/care. Some of those have skills because they have hosted it themselves, however, many click one button on their go-daddy cpanel and then wham, they are using phpList. They really have no skills at all - hence the need for a basic manual. Now, some of those people will never write for us, however some have, and their perspective is really helpful when wiring. Many more have helped with proof reading and testing etc. The very basic tools are really good for getting new people involved in Open Source projects :) I suspect this is similar for many web-based applications, like WordPress etc. People use them becuase of the convenience which stems from Open Source, such as being able to self host for little cost and learn the skills over time. Also, for the record, I don't know how to use markdown and my html is very very basic.. I essentially am one of those people as described above, I am just 5 years further along my journey and 110% enthusiastic about the Free Software philosophy :) a x -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From anna at phplist.com Thu Jun 18 03:16:04 2015 From: anna at phplist.com (Anna F J Morris) Date: Thu, 18 Jun 2015 11:16:04 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581DCE8.8080401@creative-catalyst.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> Message-ID: <55829A64.8000302@phplist.com> On 17/06/15 21:47, helen varley jamieson wrote: > in fact the previous FM interface was almost too > difficult for people to use. yes, I have had this too, and things like making screenshots to add in is really hard for some people as well I find. -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From anna at phplist.com Thu Jun 18 03:35:50 2015 From: anna at phplist.com (Anna F J Morris) Date: Thu, 18 Jun 2015 11:35:50 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581ED26.4020608@andrecastro.info> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <5581ED26.4020608@andrecastro.info> Message-ID: <55829F06.9030109@phplist.com> On 17/06/15 22:56, andre wrote: > It lends itself to a number of editing and publishing workflow, and organizational structure. I wonder, do any of you feel that FM has a specific workflow? I have written 3 (and a bit) books now, I worked with Mick on two of them, and I feel that there is something really core to FM about workflow. Trying to condense this might be helpful. From my perceptive the FM method: * It's results in something quite linear * The beginning should be super simple - an overview of basic functionality, orientation style. * The main chapters should be structured by day to day USE of software and the building of skills, using real life examples often. * We can assume that installation was done by someone else, esp if a web-app, and put that at the end with advanced chapters. * Not a single step should be skipped - every click needed should be noted * The language should be relaxed, clear to second-language English speakers (avoid metaphores) a x -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList -------------- next part -------------- An HTML attachment was scrubbed... URL: From gpittman at iglou.com Thu Jun 18 15:49:01 2015 From: gpittman at iglou.com (Gregory Pittman) Date: Thu, 18 Jun 2015 18:49:01 -0400 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581CFC0.70609@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> Message-ID: <55834ADD.3020007@iglou.com> On 06/17/2015 03:51 PM, Mick FM wrote: > > > On 17/06/15 19:57, Marvin Scholz wrote: >> >>> I personally don't think it's good for FM as really we want to lower >>> barriers to writing docs, so having to use git, or mark up doesn't >>> really fit the bill. >> >> Hey, well to be honest I think the opposite is the case. Most people >> writing technical >> documentation would prefer a markup language like Markdown instead of >> a WYSIWG editor. > > I hear what you are saying there, and I wouldn't dispute it, but let me > clarify a bit, I meant that the goal is to make it as easy as possible > for *anyone* to write docs without any other technical knowledge. > >> A lot of sites do a "best of both worlds" solution by having an editor >> that has buttons for >> most common formatting and inserts the correct Markdown. > > Sure, that would be ideal, definitely. > And even more ideal if technically able writers could write via markdown > and git and others who were less technical could write via a web interface. > This is something I would endorse, the idea that there does not need to be one common pathway for all writers. While there are typically some advantages of a website-centric platform for writing and then processing, we have seen the downsides of this, when something on the server goes bust, and suddenly no one can do much of anything. There can be a simple, straightforward, type-on-the-site method, but there can also be one or more other methods which might involve downloading/uploading content which only has to have one or more filetype characteristics to be compatible with flossmanuals. There might be the possibility to pull out, edit, then replace a chapter of a book, as long as the writer has access to appropriate software to do this. This might sound complicated, but it's really only multifaceted, allowing for choices in how to contribute to flossmanuals, and the various facets can be complementary, not competing with each other. Greg From mick at flossmanuals.net Sat Jun 20 00:15:38 2015 From: mick at flossmanuals.net (Mick FM) Date: Sat, 20 Jun 2015 08:15:38 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <55829840.9000401@phplist.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <55829840.9000401@phplist.com> Message-ID: <5585131A.5090808@flossmanuals.net> On 18/06/15 11:06, Anna F J Morris wrote: > and also the > "book" idea in itself. We used to have a wiki but a large number of our > users have a very technical skill level and they find this confusing I > think - there is something more understandable about a "book." I agree, that has always been a massive part of the FM drive. Since Adam hasn't been doing FM booksprints this has fallen off the agenda a fair bit. If you have a look at the French site they have a great looking shop there. http://boutique.flossmanualsfr.net/5-livres nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From mick at flossmanuals.net Sat Jun 20 01:14:24 2015 From: mick at flossmanuals.net (Mick FM) Date: Sat, 20 Jun 2015 09:14:24 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <55829F06.9030109@phplist.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <5581ED26.4020608@andrecastro.info> <55829F06.9030109@phplist.com> Message-ID: <558520E0.5020508@flossmanuals.net> On 18/06/15 11:35, Anna F J Morris wrote: > > * It's results in something quite linear > * The beginning should be super simple - an overview of basic > functionality, orientation style. > * The main chapters should be structured by day to day USE of > software and the building of skills, using real life examples often. > * We can assume that installation was done by someone else, esp if a > web-app, and put that at the end with advanced chapters. > * Not a single step should be skipped - every click needed should be > noted > * The language should be relaxed, clear to second-language English > speakers (avoid metaphores) > That's a really nice summary. In terms of not a single step skipped. I would agree with this mostly for the software manuals, but I also think that there is a good case for more general / overview guides about why to approach problems in a certain way. Examples would be tech tools for activism & open video workbook http://flossmanuals.net/tech-tools-for-activism/ http://en.flossmanuals.net/open-video-workbook The linear / self-contained book structure, with published versions, also really lends itself to being translated. After all it's a bigger ask to translate a wiki. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: From jh at joachimheintz.de Sat Jun 20 13:19:33 2015 From: jh at joachimheintz.de (joachim heintz) Date: Sat, 20 Jun 2015 22:19:33 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581ED26.4020608@andrecastro.info> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <5581ED26.4020608@andrecastro.info> Message-ID: <5585CAD5.300@joachimheintz.de> i second what you say about github. although many open source initiatives are on it (because it offers better services than sourceforge), it is in itself a proprietary platform. but flossmanuals is not, as far as i know. i trust in fm, although there have been some issues over the years. but this is a community effort, and i would like to stick on it. joachim Am 17.06.2015 um 23:56 schrieb andre: > Sorry to barge in. > I just been lurking for a a couple of months on the floss manuals list and have been a reader for some years(floss > manuals helped me a lot to get into free software). I am grateful to the project and hope I can somehow contribute. > > The discussion concerning a more flexible system for writing-publishing-maintaining floss manuals got me interested, so > I'll trow in my 2cents. > > At a point in the discussion GitHub was suggested as a possibility. > Although it sounds tempting, as it was already referred, it can discourage less tech minded people from contributing. > But then aren't most of those writing the manuals familiar with git and markdown? > On-the-other-hand using GitHub, seems like a contradiction for a project focused on the dissemination of floss, as > GitHub is not an open source initiative, but a proprietary service, based on Git. > > Mediawiki could be another interesting solution. > I allow writing in both wiki syntax or with a WYSIWYG editor, and I believe there are a few plugins that allow the use > of markdown. > It lends itself to a number of editing and publishing workflow, and organizational structure. > The markup can easily and cleanly converted to HTML (epub and Pdf, with so hacks needed for the last). > And includes a very comprehensive web api. > > > curious where the discussion will head. > best > a > > > On 06/17/2015 10:47 PM, helen varley jamieson wrote: >> i work on the UpStage manual, for which we have (occasionally) had >> contributions from users of the platform who are not at all technical. >> it has been really helpful to be able to involve these people in the >> manual-writing process. in fact the previous FM interface was almost too >> difficult for people to use. keeping it simple for users of software to >> be able to contribute is really important, since users will write quite >> different instructions to those who wrote the software. >> >> h : ) >> >> On 17/06/15 9:51 28PM, Mick FM wrote: >>> >>> >>> On 17/06/15 19:57, Marvin Scholz wrote: >>>> >>>>> I personally don't think it's good for FM as really we want to lower >>>>> barriers to writing docs, so having to use git, or mark up doesn't >>>>> really fit the bill. >>>> >>>> Hey, well to be honest I think the opposite is the case. Most people >>>> writing technical >>>> documentation would prefer a markup language like Markdown instead of >>>> a WYSIWG editor. >>> >>> I hear what you are saying there, and I wouldn't dispute it, but let me >>> clarify a bit, I meant that the goal is to make it as easy as possible >>> for *anyone* to write docs without any other technical knowledge. >>> >>>> A lot of sites do a "best of both worlds" solution by having an editor >>>> that has buttons for >>>> most common formatting and inserts the correct Markdown. >>> >>> Sure, that would be ideal, definitely. >>> And even more ideal if technically able writers could write via markdown >>> and git and others who were less technical could write via a web interface. >>> >>> I think this has already been mentioned on this list but for Booktype >>> 2.0 the Aloha editor is used. >>> http://www.alohaeditor.org/ >>> This looks to be a huge improvement! >>> >>> nice one >>> Mick >>> >>> >>> >> > > From anna at phplist.com Mon Jun 22 00:52:43 2015 From: anna at phplist.com (Anna F J Morris) Date: Mon, 22 Jun 2015 08:52:43 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5585131A.5090808@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <55829840.9000401@phplist.com> <5585131A.5090808@flossmanuals.net> Message-ID: <5587BECB.1090407@phplist.com> On 20/06/15 08:15, Mick FM wrote: > If you have a look at the French site they have a great looking shop there. > > http://boutique.flossmanualsfr.net/5-livres stunning! Does anyone know how much they turnover? a x -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From anna at phplist.com Mon Jun 22 00:54:13 2015 From: anna at phplist.com (Anna F J Morris) Date: Mon, 22 Jun 2015 08:54:13 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558520E0.5020508@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <5581ED26.4020608@andrecastro.info> <55829F06.9030109@phplist.com> <558520E0.5020508@flossmanuals.net> Message-ID: <5587BF25.90106@phplist.com> On 20/06/15 09:14, Mick FM wrote: > The linear / self-contained book structure, with published versions, > also really lends itself to being translated. true, very good point - translation is super important in FM. -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From davidam at es.gnu.org Tue Jun 23 10:18:54 2015 From: davidam at es.gnu.org (David Arroyo =?utf-8?Q?Men=C3=A9ndez?=) Date: Tue, 23 Jun 2015 19:18:54 +0200 Subject: [FM Discuss] Can I add gnu manuals to floss manuals? Message-ID: <7umvzqxs01.fsf@chapters.gnu.org> Hello, In floss manuals everyone can upload manuals in a wiki fashion, but if the book is written in latex, or texinfo. How can I upload to floss manuals? Thanks in advance. From gpittman at iglou.com Tue Jun 23 13:21:08 2015 From: gpittman at iglou.com (Gregory Pittman) Date: Tue, 23 Jun 2015 16:21:08 -0400 Subject: [FM Discuss] an article for opensource.com Message-ID: <5589BFB4.9020203@iglou.com> Hi, I've written an article, and it's been accepted by opensource.com about my experience translating the book Scribus from the French flossmanuals site. They tell me it's scheduled to be published on their site the week of June 29th. Greg From anna at phplist.com Wed Jun 24 01:48:51 2015 From: anna at phplist.com (Anna F J Morris) Date: Wed, 24 Jun 2015 09:48:51 +0100 Subject: [FM Discuss] an article for opensource.com In-Reply-To: <5589BFB4.9020203@iglou.com> References: <5589BFB4.9020203@iglou.com> Message-ID: <558A6EF3.6010108@phplist.com> On 23/06/15 21:21, Gregory Pittman wrote: > They tell me it's scheduled to be published on their site the week of > June 29th. fantastic, remind me and I will tweet it from phpList a x -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From mick at flossmanuals.net Thu Jun 25 07:43:42 2015 From: mick at flossmanuals.net (Mick FM) Date: Thu, 25 Jun 2015 15:43:42 +0100 Subject: [FM Discuss] Can I add gnu manuals to floss manuals? In-Reply-To: <7umvzqxs01.fsf@chapters.gnu.org> References: <7umvzqxs01.fsf@chapters.gnu.org> Message-ID: <558C139E.7030302@flossmanuals.net> On 23/06/15 18:18, David Arroyo Men?ndez wrote: > Hello, > > In floss manuals everyone can upload manuals in a wiki fashion, but if > the book is written in latex, or texinfo. How can I upload to floss > manuals? > There is the ability to import epub files if they are online. So a sample workflow which should work would be. Latex to epub with pandoc - http://pandoc.org/demos.html Upload epub to archive.org or similar - Import to booki.flossmanuals.net. - http://sourcefabric.booktype.pro/booktype-16-for-authors-and-publishers/_draft/_v/1.0/importing-a-book/ Hope this helps! Thanks Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From mick at flossmanuals.net Thu Jun 25 08:00:07 2015 From: mick at flossmanuals.net (Mick FM) Date: Thu, 25 Jun 2015 16:00:07 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration Message-ID: <558C1777.80504@flossmanuals.net> Hi there, If you are active maintaining or editing a manual could you spare 30mins to an hour to do a bit of testing for FLOSS Manuals. The mission is to test migration of manuals from booki.flossmanuals.net to another writing server. This would be done on a manual by manual basis rather than en-masse. There is a hope that this can act as a way of checking who is still up for maintaining manuals. We are looking into getting SourceFabric to host the writing side of FLOSS Manuals. This would be a positive step for reducing the technical overheads of the project and having a very stable set up. Email if you are up for doing this and I'll let you know more next week. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From epirat07 at gmail.com Thu Jun 25 08:03:57 2015 From: epirat07 at gmail.com (Marvin Scholz) Date: Thu, 25 Jun 2015 17:03:57 +0200 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <558C1777.80504@flossmanuals.net> References: <558C1777.80504@flossmanuals.net> Message-ID: <3F54A698-6A24-4F3E-B049-1C784EA09A13@gmail.com> On 25 Jun 2015, at 17:00, Mick FM wrote: > Email if you are up for doing this and I'll let you know more next > week. Would be happy to test this with the Icecast Manual, if it is possible, although I am not the person that wrote it originally. From mick at flossmanuals.net Thu Jun 25 08:09:08 2015 From: mick at flossmanuals.net (Mick FM) Date: Thu, 25 Jun 2015 16:09:08 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <5581DCE8.8080401@creative-catalyst.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> Message-ID: <558C1994.3040403@flossmanuals.net> On 17/06/15 21:47, helen varley jamieson wrote: > keeping it simple for users of software to > be able to contribute is really important, since users will write quite > different instructions to those who wrote the software. I agree. I think this can be a key differentiator to Read the Docs / git books. Would you be interested in testing the new Booktype 2.0 Helen, or do you want to wait till it's in place. Just out of interest, what's the timescale for the next Upstage manual v3? nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From mick at flossmanuals.net Thu Jun 25 08:15:50 2015 From: mick at flossmanuals.net (Mick FM) Date: Thu, 25 Jun 2015 16:15:50 +0100 Subject: [FM Discuss] cover page In-Reply-To: <47C19A00-8A99-4037-9377-30BA5E39F27F@gmail.com> References: <47C19A00-8A99-4037-9377-30BA5E39F27F@gmail.com> Message-ID: <558C1B26.8020305@flossmanuals.net> On 17/06/15 10:12, Vitaliy Grishenko wrote: > Hello everybody, > > is any of you guys a designer? We?ve created a landing page (http://thunderbird-ru.flossmanuals.net) for the Russian version of this tutorial on PGP (http://flossmanuals.net/thunderbird-workbook/). It would be great to have a simple cover page for this tutorial to replace the default one (http://thunderbird-ru.flossmanuals.net/index_files/CF_cover.png). Thank you very much in advance! > > I look forward to hearing from you. I just wanted to bump this to see if anyone has a template for a book image like the one at the link above. If you fancy doing a full design that would be great, but if not maybe a template instead? I guess there is probably an Adobe one, but maybe there is a SVG that could be used as a base. Has anyone got any leads? It would be super useful for other projects too. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From mick at flossmanuals.net Thu Jun 25 08:19:41 2015 From: mick at flossmanuals.net (Mick FM) Date: Thu, 25 Jun 2015 16:19:41 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <3F54A698-6A24-4F3E-B049-1C784EA09A13@gmail.com> References: <558C1777.80504@flossmanuals.net> <3F54A698-6A24-4F3E-B049-1C784EA09A13@gmail.com> Message-ID: <558C1C0D.2000906@flossmanuals.net> On 25/06/15 16:03, Marvin Scholz wrote: > On 25 Jun 2015, at 17:00, Mick FM wrote: > > >> Email if you are up for doing this and I'll let you know more next week. > > Would be happy to test this with the Icecast Manual, if it is > possible, although I am not the person > that wrote it originally. That would be great, Marvin. I'll get in touch next week with more details. Thanks for your help. nice one Mick From helen at creative-catalyst.com Thu Jun 25 08:27:15 2015 From: helen at creative-catalyst.com (helen varley jamieson) Date: Thu, 25 Jun 2015 17:27:15 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558C1994.3040403@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <558C1994.3040403@flossmanuals.net> Message-ID: <558C1DD3.4060201@creative-catalyst.com> hi mick, i'm sort of up for testing, but somehow my time just keeps filling up so i'm worried about over-committing. the new UpStage v3 manual should be near the top of my list but it keeps getting pushed out of the way by other things ... i hope that i will get it finished over the summer but that's not promise ... h : ) On 25/06/15 5:09 08PM, Mick FM wrote: > > > On 17/06/15 21:47, helen varley jamieson wrote: >> keeping it simple for users of software to >> be able to contribute is really important, since users will write quite >> different instructions to those who wrote the software. > I agree. I think this can be a key differentiator to Read the Docs / git > books. > > Would you be interested in testing the new Booktype 2.0 Helen, or do you > want to wait till it's in place. > > Just out of interest, what's the timescale for the next Upstage manual v3? > > nice one > Mick > -- helen varley jamieson helen at creative-catalyst.com http://www.creative-catalyst.com http://www.upstage.org.nz Magdalena M?nchen - Erstes Treffen: 5-7 June 2015 From jh at joachimheintz.de Thu Jun 25 13:57:36 2015 From: jh at joachimheintz.de (joachim heintz) Date: Thu, 25 Jun 2015 22:57:36 +0200 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <558C1777.80504@flossmanuals.net> References: <558C1777.80504@flossmanuals.net> Message-ID: <558C6B40.2060802@joachimheintz.de> hi mick - yes i could do this next week. best - joachim Am 25.06.2015 um 17:00 schrieb Mick FM: > Hi there, > > If you are active maintaining or editing a manual could you spare 30mins > to an hour to do a bit of testing for FLOSS Manuals. > > The mission is to test migration of manuals from booki.flossmanuals.net > to another writing server. This would be done on a manual by manual > basis rather than en-masse. There is a hope that this can act as a way > of checking who is still up for maintaining manuals. > > We are looking into getting SourceFabric to host the writing side of > FLOSS Manuals. This would be a positive step for reducing the technical > overheads of the project and having a very stable set up. > > Email if you are up for doing this and I'll let you know more next week. > > nice one > Mick > From anna at phplist.com Fri Jun 26 02:37:02 2015 From: anna at phplist.com (Anna F J Morris) Date: Fri, 26 Jun 2015 10:37:02 +0100 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558C1994.3040403@flossmanuals.net> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <558C1994.3040403@flossmanuals.net> Message-ID: <558D1D3E.2060409@phplist.com> On 25/06/15 16:09, Mick FM wrote: > On 17/06/15 21:47, helen varley jamieson wrote: >> > keeping it simple for users of software to >> > be able to contribute is really important, since users will write quite >> > different instructions to those who wrote the software. > I agree. I think this can be a key differentiator to Read the Docs / git > books. "Documentation by users for users" -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From anna at phplist.com Fri Jun 26 02:43:58 2015 From: anna at phplist.com (Anna F J Morris) Date: Fri, 26 Jun 2015 10:43:58 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <558C1777.80504@flossmanuals.net> References: <558C1777.80504@flossmanuals.net> Message-ID: <558D1EDE.9060009@phplist.com> On 25/06/15 16:00, Mick FM wrote: > Email if you are up for doing this and I'll let you know more next week. sure, I can spare an hour or two on the phpList manual, I can also look at some of the others we wrote mick if that helps (maybe the video editing one, I know that best) a x -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From helen at creative-catalyst.com Fri Jun 26 02:50:28 2015 From: helen at creative-catalyst.com (helen varley jamieson) Date: Fri, 26 Jun 2015 11:50:28 +0200 Subject: [FM Discuss] State of the english Flossmanuals In-Reply-To: <558D1D3E.2060409@phplist.com> References: <2FD71FBC-EA04-44EE-AD3E-6E5C13B41F6D@gmail.com> <558160BF.90300@flossmanuals.net> <5581BFA5.1010300@flossmanuals.net> <5581CFC0.70609@flossmanuals.net> <5581DCE8.8080401@creative-catalyst.com> <558C1994.3040403@flossmanuals.net> <558D1D3E.2060409@phplist.com> Message-ID: <558D2064.3090000@creative-catalyst.com> :) On 26/06/15 11:37 02AM, Anna F J Morris wrote: > On 25/06/15 16:09, Mick FM wrote: >> On 17/06/15 21:47, helen varley jamieson wrote: >>>> keeping it simple for users of software to >>>> be able to contribute is really important, since users will write quite >>>> different instructions to those who wrote the software. >> I agree. I think this can be a key differentiator to Read the Docs / git >> books. > > "Documentation by users for users" > -- helen varley jamieson helen at creative-catalyst.com http://www.creative-catalyst.com http://www.upstage.org.nz Magdalena M?nchen - Erstes Treffen: 5-7 June 2015 From mick at flossmanuals.net Fri Jun 26 03:26:35 2015 From: mick at flossmanuals.net (Mick FM) Date: Fri, 26 Jun 2015 11:26:35 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <558D1EDE.9060009@phplist.com> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> Message-ID: <558D28DB.1040108@flossmanuals.net> On 26/06/15 10:43, Anna F J Morris wrote: > sure, I can spare an hour or two on the phpList manual, I can also look > at some of the others we wrote mick if that helps (maybe the video > editing one, I know that best) That would be great. Thanks Anna and Joachim. I'll do the OwnCloud one and a few more. One or two more volunteers and I think we've got a good team for the test. Anyone? You don't have to have created the manual, just be prepared to check the contents. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From tmolloy at gmx.co.uk Fri Jun 26 13:00:50 2015 From: tmolloy at gmx.co.uk (tmolloygmx) Date: Fri, 26 Jun 2015 21:00:50 +0100 Subject: [FM Discuss] Content strategy: the new philosophy of technical documentation Message-ID: <558DAF72.2090906@gmx.co.uk> http://opensource.com/business/15/6/documentation-content-strategy From mick at flossmanuals.net Mon Jun 29 00:50:24 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 08:50:24 +0100 Subject: [FM Discuss] Content strategy: the new philosophy of technical documentation In-Reply-To: <558DAF72.2090906@gmx.co.uk> References: <558DAF72.2090906@gmx.co.uk> Message-ID: <5590F8C0.3080701@flossmanuals.net> On 26/06/15 21:00, tmolloygmx wrote: > http://opensource.com/business/15/6/documentation-content-strategy Great article, this bit especially jumped out at me. " Why do my readers need this content? This question is probably the trickiest of all, because it puts the purpose of your content under scrutiny with the WIIFM (what's in it for me) test: Why are you even writing this content? Which pain are you solving for your readers? Why would they care about what you're writing? " --// Interestingly the writer is from Open Stack team. Anne Gentle who is a friend of FLOSS Manuals is on that team. They did a booksprint not so long ago. There's some more info from Anne on that here. http://programming.oreilly.com/2014/05/the-book-sprint.html and an article here too. http://www.openstack.org/blog/2014/07/five-days-twelve-writers-one-book-sprint-one-excellent-book-on-openstack-architecture/ nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From mick at flossmanuals.net Mon Jun 29 00:57:53 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 08:57:53 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <558D1EDE.9060009@phplist.com> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> Message-ID: <5590FA81.8030001@flossmanuals.net> On 26/06/15 10:43, Anna F J Morris wrote: > On 25/06/15 16:00, Mick FM wrote: >> Email if you are up for doing this and I'll let you know more next week. > sure, I can spare an hour or two on the phpList manual, I can also look > at some of the others we wrote mick if that helps (maybe the video > editing one, I know that best) > Thanks if you volunteered to do a migration test. Here are the steps. * Go here - http://floss.booktype.pro/ * Create an account * Click on My Dashboard > My Books > Import Book * Select Import Type: Copy or import Booktype book * Enter the URL of the book you want to migrate from booki.flossmanuals.net - ie http://booki.flossmanuals.net/owncloud (see image attached) * Then click Import * Then check if the content has been migrated ok and report back any errors or omissions (especially check the images) Many Thanks! Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: -------------- next part -------------- A non-text attachment was scrubbed... Name: import.png Type: image/png Size: 269145 bytes Desc: not available URL: From mick at flossmanuals.net Mon Jun 29 01:06:39 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 09:06:39 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <5590FA81.8030001@flossmanuals.net> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> <5590FA81.8030001@flossmanuals.net> Message-ID: <5590FC8F.20601@flossmanuals.net> On 29/06/15 08:57, Mick FM wrote: > Then check if the content has been migrated ok and report back any > errors or omissions (especially check the images) On reflection, it would be best to collate issues on this list to prevent too much noise here. http://lists.flossmanuals.net/listinfo.cgi/admin-flossmanuals.net Thanks! Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From anna at phplist.com Mon Jun 29 03:39:20 2015 From: anna at phplist.com (Anna F J Morris) Date: Mon, 29 Jun 2015 11:39:20 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <5590FA81.8030001@flossmanuals.net> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> <5590FA81.8030001@flossmanuals.net> Message-ID: <55912058.7070505@phplist.com> On 29/06/15 08:57, Mick FM wrote: > # Click on My Dashboard > My Books > Import Book Hi, I can't do this step for phpList because it was never published to FM. If I do this for the kdenlive book does this make me "owner" or "maintainer" or something? I am not sure I want that role.... Thanks a x -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Mon Jun 29 03:52:55 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 11:52:55 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <55912058.7070505@phplist.com> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> <5590FA81.8030001@flossmanuals.net> <55912058.7070505@phplist.com> Message-ID: <55912387.6090501@flossmanuals.net> On 29/06/15 11:39, Anna F J Morris wrote: > > Hi, I can't do this step for phpList because it was never published to FM. > You'll need to put in - http://booki.flossmanuals.net/phplist/ The address on the WRITE part of the FLOSS Manuals site. > If I do this for the kdenlive book does this make me "owner" or > "maintainer" or something? I am not sure I want that role.... Good question! No don't worry about that, this is a test of a migration, so while it would be great for community members to step forward and adopt manuals, doing this won't sign you up to do that. Once we test this migration route then reaching out for maintainers / guardian is a good next step. It might be nice to think about what that role can entail as well. For example I would like there to be a pretty low barrier to entry to being a guardian of an existing manual. So that it is not your responsibility to keep the manual up to date. However is someone pops up on the list as says, can I contribute / update this manual, the guardian could encourage that contribution. nice one Mick From anna at phplist.com Mon Jun 29 03:55:51 2015 From: anna at phplist.com (Anna F J Morris) Date: Mon, 29 Jun 2015 11:55:51 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <55912387.6090501@flossmanuals.net> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> <5590FA81.8030001@flossmanuals.net> <55912058.7070505@phplist.com> <55912387.6090501@flossmanuals.net> Message-ID: <55912437.9040900@phplist.com> On 29/06/15 11:52, Mick FM wrote: > On 29/06/15 11:39, Anna F J Morris wrote: >> > >> > Hi, I can't do this step for phpList because it was never published to FM. >> > > You'll need to put in - http://booki.flossmanuals.net/phplist/ > The address on the WRITE part of the FLOSS Manuals site. > but there is nothing at that link. I can import the draft? -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From anna at phplist.com Mon Jun 29 03:57:23 2015 From: anna at phplist.com (Anna F J Morris) Date: Mon, 29 Jun 2015 11:57:23 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <55912437.9040900@phplist.com> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> <5590FA81.8030001@flossmanuals.net> <55912058.7070505@phplist.com> <55912387.6090501@flossmanuals.net> <55912437.9040900@phplist.com> Message-ID: <55912493.1020400@phplist.com> On 29/06/15 11:55, Anna F J Morris wrote: > but there is nothing at that link. I can import the draft? oh, ok, I see. Sorry, I didn't understand the dropdown. I got it now. Will look for errors ax -- Share the phpList love! Twitter: @phpList Facebook: facebook.com/phpList From mick at flossmanuals.net Mon Jun 29 03:58:54 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 11:58:54 +0100 Subject: [FM Discuss] Volunteer Manual maintainers wanted to test migration In-Reply-To: <55912437.9040900@phplist.com> References: <558C1777.80504@flossmanuals.net> <558D1EDE.9060009@phplist.com> <5590FA81.8030001@flossmanuals.net> <55912058.7070505@phplist.com> <55912387.6090501@flossmanuals.net> <55912437.9040900@phplist.com> Message-ID: <559124EE.4090306@flossmanuals.net> On 29/06/15 11:55, Anna F J Morris wrote: >>>> Hi, I can't do this step for phpList because it was never published to FM. >>>> >> > >> > You'll need to put in - http://booki.flossmanuals.net/phplist/ >> > The address on the WRITE part of the FLOSS Manuals site. >> > > but there is nothing at that link. I can import the draft? That's the link you put in to import, trust me! It's worth moving this level of detail to the admin list I think. http://lists.flossmanuals.org/listinfo.cgi/admin-flossmanuals.org nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From mick at flossmanuals.net Mon Jun 29 10:13:14 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 18:13:14 +0100 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> Message-ID: <55917CAA.2040802@flossmanuals.net> On 24/12/14 16:26, Bruno Ruviaro wrote: > On Wednesday, December 24, 2014, Mick FM > wrote: > > > On 22/12/14 23:47, Bruno Ruviaro wrote: >> Hi Mick, >> >> Sorry to hear about the problem with the publishing server, and >> thanks for offering temporary workarounds. I went ahead and >> finished all the edits and just published everything using GitHub >> Pages: >> >> http://brunoruviaro.github.io/ardour3-floss-tutorial/ >> >> I've been working on other projects using that interface, so it >> was not too hard to put it together. > > Cool beans, > If that works for you in the short term that's great Bruno. > Hi Bruno, I'm interested to know if we can reincorporate your manual back into FLOSS Manuals. Have you got an epub of the materials that we could try to import? nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: From bruviaro at scu.edu Mon Jun 29 13:34:09 2015 From: bruviaro at scu.edu (Bruno Ruviaro) Date: Mon, 29 Jun 2015 13:34:09 -0700 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: <55917CAA.2040802@flossmanuals.net> References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> Message-ID: Hi Mick, The current version of the Ardour tutorial is a collection of markdown files on GitHub (https://github.com/brunoruviaro/ardour3-floss-tutorial/), with associated images saved in a separate folder. Is there a way to import this back into booktype? I'd like to give it a try. There was a major release of Ardour just this month (from 3.5 to 4.0), so at some point this Summer we'll update the tutorial to Ardour 4.0. This would be a good time to test and see if it makes sense to move the Ardour tutorial from its current GitHub location. Side question: can booktype export content as markdown files, if needed? Thanks! Bruno On Mon, Jun 29, 2015 at 10:13 AM, Mick FM wrote: > > > On 24/12/14 16:26, Bruno Ruviaro wrote: > > On Wednesday, December 24, 2014, Mick FM wrote: > >> >> On 22/12/14 23:47, Bruno Ruviaro wrote: >> >> Hi Mick, >> >> Sorry to hear about the problem with the publishing server, and thanks >> for offering temporary workarounds. I went ahead and finished all the edits >> and just published everything using GitHub Pages: >> >> http://brunoruviaro.github.io/ardour3-floss-tutorial/ >> >> I've been working on other projects using that interface, so it was not >> too hard to put it together. >> >> >> Cool beans, >> If that works for you in the short term that's great Bruno. >> > > Hi Bruno, > > I'm interested to know if we can reincorporate your manual back into FLOSS > Manuals. > > Have you got an epub of the materials that we could try to import? > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > http://clearerchannel.org - training and freelance workhttp://flossmanuals.net - Free Manuals for Free Software > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Mon Jun 29 14:27:08 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 22:27:08 +0100 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> Message-ID: <5591B82C.2050901@flossmanuals.net> On 29/06/15 21:34, Bruno Ruviaro wrote: > Hi Mick, > > The current version of the Ardour tutorial is a collection of markdown > files on GitHub > (https://github.com/brunoruviaro/ardour3-floss-tutorial/), with > associated images saved in a separate folder. Is there a way to import > this back into booktype? I'd like to give it a try. > A quick google shows that markdown files can be converted to epub files using pandoc tool. I can remember doing that. But I'm not sure how pandoc would handle a series of files or know what order they are in. Can anyone on this list help? If not it may be one for the 80cc mailing list. I think I saw you were using jekyll to generate pages. If so, these links may also help. https://github.com/glejeune/jekyll-epub https://github.com/lmullen/jekyll-ebook > There was a major release of Ardour just this month (from 3.5 to 4.0), > so at some point this Summer we'll update the tutorial to Ardour 4.0. > This would be a good time to test and see if it makes sense to move > the Ardour tutorial from its current GitHub location. > > Side question: can booktype export content as markdown files, if needed? > I think that may be easier by exporting an epub from Booktype and feeding it to pandoc to create mark up. If you manage to create an epub let me know and we can test the next stages. nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Mon Jun 29 14:45:14 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 22:45:14 +0100 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: <5591B82C.2050901@flossmanuals.net> References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> <5591B82C.2050901@flossmanuals.net> Message-ID: <5591BC6A.20705@flossmanuals.net> On 29/06/15 22:27, Mick FM wrote: >> The current version of the Ardour tutorial is a collection of >> markdown files on GitHub >> (https://github.com/brunoruviaro/ardour3-floss-tutorial/), with >> associated images saved in a separate folder. Is there a way to >> import this back into booktype? I'd like to give it a try. >> > > A quick google shows that markdown files can be converted to epub > files using pandoc tool. I can remember doing that. > But I'm not sure how pandoc would handle a series of files or know > what order they are in. This may be a better solution to move from markdown to epub. https://github.com/GitbookIO/gitbook nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software -------------- next part -------------- An HTML attachment was scrubbed... URL: From bruviaro at scu.edu Mon Jun 29 14:56:11 2015 From: bruviaro at scu.edu (Bruno Ruviaro) Date: Mon, 29 Jun 2015 14:56:11 -0700 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: <5591BC6A.20705@flossmanuals.net> References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> <5591B82C.2050901@flossmanuals.net> <5591BC6A.20705@flossmanuals.net> Message-ID: Thanks. I will give it a try. On Monday, June 29, 2015, Mick FM wrote: > > > On 29/06/15 22:27, Mick FM wrote: > > The current version of the Ardour tutorial is a collection of markdown > files on GitHub (https://github.com/brunoruviaro/ardour3-floss-tutorial/), > with associated images saved in a separate folder. Is there a way to import > this back into booktype? I'd like to give it a try. > > > A quick google shows that markdown files can be converted to epub files > using pandoc tool. I can remember doing that. > But I'm not sure how pandoc would handle a series of files or know what > order they are in. > > > This may be a better solution to move from markdown to epub. > > https://github.com/GitbookIO/gitbook > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > http://clearerchannel.org - training and freelance workhttp://flossmanuals.net - Free Manuals for Free Software > > -------------- next part -------------- An HTML attachment was scrubbed... URL: From mick at flossmanuals.net Mon Jun 29 15:00:55 2015 From: mick at flossmanuals.net (Mick FM) Date: Mon, 29 Jun 2015 23:00:55 +0100 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> <5591B82C.2050901@flossmanuals.net> <5591BC6A.20705@flossmanuals.net> Message-ID: <5591C017.1010908@flossmanuals.net> On 29/06/15 22:56, Bruno Ruviaro wrote: > Thanks. I will give it a try. Great. I've just done a quick test with an epub created with gitbook and it imported fine into Booktype. Thanks for trying this out Bruno, I think it is an interesting experiment in federated publication and a real example of books on the move. Out of interest how did you get the FM Ardour content into markup for your project on git pages? nice one Mick -- Mick Chesterman - mick at flossmanuals.net mickfuzz [skype] @onefuzzyduck [twitter] http://clearerchannel.org - training and freelance work http://flossmanuals.net - Free Manuals for Free Software From bruviaro at scu.edu Tue Jun 30 10:53:22 2015 From: bruviaro at scu.edu (Bruno Ruviaro) Date: Tue, 30 Jun 2015 10:53:22 -0700 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: <5591C017.1010908@flossmanuals.net> References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> <5591B82C.2050901@flossmanuals.net> <5591BC6A.20705@flossmanuals.net> <5591C017.1010908@flossmanuals.net> Message-ID: On Mon, Jun 29, 2015 at 3:00 PM, Mick FM wrote: > > > On 29/06/15 22:56, Bruno Ruviaro wrote: > > Thanks. I will give it a try. > > Great. I've just done a quick test with an epub created with gitbook and > it imported fine into Booktype. > > Thanks for trying this out Bruno, I think it is an interesting > experiment in federated publication and a real example of books on the > move. > > Out of interest how did you get the FM Ardour content into markup for > your project on git pages? > ?I don't remember exactly (I was trying a bunch of options at the time), but I think I did it mostly with pandoc and manual adjustments. > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > > http://clearerchannel.org - training and freelance work > http://flossmanuals.net - Free Manuals for Free Software > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > -------------- next part -------------- An HTML attachment was scrubbed... URL: From andre at andrecastro.info Tue Jun 30 11:54:35 2015 From: andre at andrecastro.info (Andr3 Castr0) Date: Tue, 30 Jun 2015 20:54:35 +0200 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: <5591B82C.2050901@flossmanuals.net> References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> <5591B82C.2050901@flossmanuals.net> Message-ID: <5592E5EB.6090207@andrecastro.info> On 06/29/2015 11:27 PM, Mick FM wrote: > > > On 29/06/15 21:34, Bruno Ruviaro wrote: >> Hi Mick, >> >> The current version of the Ardour tutorial is a collection of >> markdown files on GitHub >> (https://github.com/brunoruviaro/ardour3-floss-tutorial/), with >> associated images saved in a separate folder. Is there a way to >> import this back into booktype? I'd like to give it a try. >> > > A quick google shows that markdown files can be converted to epub > files using pandoc tool. I can remember doing that. > But I'm not sure how pandoc would handle a series of files or know > what order they are in. > > Can anyone on this list help? If not it may be one for the 80cc > mailing list. > For pandoc to export to epub(2 and 3) all the source text files must be assembled onto one single file. But it is simple a concatenation. Something like: $ for i in folder/*.md; do cat $i >> book.md; done If you have footnotes or metadata in each markdown, scripts have to reorganize them in new file, but it is also simple. In pandoc's conversion to epub, you must indicate at what level you want the chapters to be generate: heading 1 or 2. But it is essentially that. I have assembled a series of simple scripts, triggered by a makefile, to perform this (and other) conversion. Fell welcome to use https://gitlab.com/DigitalPublishingToolkit/Hybrid-Publishing-Resources/tree/master hope it helps > I think I saw you were using jekyll to generate pages. > If so, these links may also help. https://github.com/glejeune/jekyll-epub > https://github.com/lmullen/jekyll-ebook > >> There was a major release of Ardour just this month (from 3.5 to >> 4.0), so at some point this Summer we'll update the tutorial to >> Ardour 4.0. This would be a good time to test and see if it makes >> sense to move the Ardour tutorial from its current GitHub location. >> >> Side question: can booktype export content as markdown files, if needed? >> > I think that may be easier by exporting an epub from Booktype and > feeding it to pandoc to create mark up. > > If you manage to create an epub let me know and we can test the next > stages. > > nice one > Mick > > -- > Mick Chesterman -mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > > http://clearerchannel.org - training and freelance work > http://flossmanuals.net - Free Manuals for Free Software > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net -------------- next part -------------- An HTML attachment was scrubbed... URL: From bruviaro at scu.edu Tue Jun 30 12:37:35 2015 From: bruviaro at scu.edu (Bruno Ruviaro) Date: Tue, 30 Jun 2015 12:37:35 -0700 Subject: [FM Discuss] Ardour3 manual update and question In-Reply-To: <5592E5EB.6090207@andrecastro.info> References: <54956746.9000800@flossmanuals.net> <549AA1D1.40607@flossmanuals.net> <55917CAA.2040802@flossmanuals.net> <5591B82C.2050901@flossmanuals.net> <5592E5EB.6090207@andrecastro.info> Message-ID: Thanks, Andr?! Bruno On Tue, Jun 30, 2015 at 11:54 AM, Andr3 Castr0 wrote: > > > On 06/29/2015 11:27 PM, Mick FM wrote: > > > > On 29/06/15 21:34, Bruno Ruviaro wrote: > > Hi Mick, > > The current version of the Ardour tutorial is a collection of markdown > files on GitHub (https://github.com/brunoruviaro/ardour3-floss-tutorial/), > with associated images saved in a separate folder. Is there a way to import > this back into booktype? I'd like to give it a try. > > > A quick google shows that markdown files can be converted to epub files > using pandoc tool. I can remember doing that. > But I'm not sure how pandoc would handle a series of files or know what > order they are in. > > Can anyone on this list help? If not it may be one for the 80cc mailing > list. > > For pandoc to export to epub(2 and 3) all the source text files must be > assembled onto one single file. But it is simple a concatenation. > Something like: $ for i in folder/*.md; do cat $i >> book.md; done > If you have footnotes or metadata in each markdown, scripts have to > reorganize them in new file, but it is also simple. > > In pandoc's conversion to epub, you must indicate at what level you want > the chapters to be generate: heading 1 or 2. > But it is essentially that. > > I have assembled a series of simple scripts, triggered by a makefile, to > perform this (and other) conversion. > Fell welcome to use > > https://gitlab.com/DigitalPublishingToolkit/Hybrid-Publishing-Resources/tree/master > > hope it helps > > I think I saw you were using jekyll to generate pages. > If so, these links may also help. https://github.com/glejeune/jekyll-epub > https://github.com/lmullen/jekyll-ebook > > There was a major release of Ardour just this month (from 3.5 to 4.0), > so at some point this Summer we'll update the tutorial to Ardour 4.0. This > would be a good time to test and see if it makes sense to move the Ardour > tutorial from its current GitHub location. > > Side question: can booktype export content as markdown files, if needed? > > I think that may be easier by exporting an epub from Booktype and > feeding it to pandoc to create mark up. > > If you manage to create an epub let me know and we can test the next > stages. > > nice one > Mick > > -- > Mick Chesterman - mick at flossmanuals.net > mickfuzz [skype] > @onefuzzyduck [twitter] > http://clearerchannel.org - training and freelance workhttp://flossmanuals.net - Free Manuals for Free Software > > > > _______________________________________________ > Discuss mailing listDiscuss at lists.flossmanuals.nethttp://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > > > _______________________________________________ > Discuss mailing list > Discuss at lists.flossmanuals.net > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net > > -------------- next part -------------- An HTML attachment was scrubbed... URL: