Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-05-27 Thread Gonzalo Odiard
Great Kalpa. I am interested in work with you to integrate this proposal with the work I am doing on the Help activity. Gonzalo On Mon, May 27, 2013 at 4:28 PM, Kalpa Welivitigoda wrote: > > > > On Fri, May 3, 2013 at 11:24 PM, Kalpa Welivitigoda > wrote: > >> >> >> >> On Mon, Apr 15, 2013 at

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-05-27 Thread Kalpa Welivitigoda
On Fri, May 3, 2013 at 11:24 PM, Kalpa Welivitigoda wrote: > > > > On Mon, Apr 15, 2013 at 8:36 PM, Bastien wrote: > >> Gonzalo Odiard writes: >> >> > FYI, I will convert the update of the sugar manual in the olpc wiki >> > [1] to rst to generate new content for the Help activity. >> > >> > I wi

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-05-03 Thread Kalpa Welivitigoda
On Mon, Apr 15, 2013 at 8:36 PM, Bastien wrote: > Gonzalo Odiard writes: > > > FYI, I will convert the update of the sugar manual in the olpc wiki > > [1] to rst to generate new content for the Help activity. > > > > I will be working on this today and tomorrow probably. > > Great -- don't hesit

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-15 Thread Bastien
Gonzalo Odiard writes: > FYI, I will convert the update of the sugar manual in the olpc wiki > [1] to rst to generate new content for the Help activity. > > I will be working on this today and tomorrow probably. Great -- don't hesitate to use my repository, I can give you write access if that's

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-15 Thread Gonzalo Odiard
FYI, I will convert the update of the sugar manual in the olpc wiki [1] to rst to generate new content for the Help activity. I will be working on this today and tomorrow probably. Gonzalo [1] http://wiki.laptop.org/go/Help_Activity_refresh/TOC On Fri, Apr 12, 2013 at 5:30 AM, Bastien wrote:

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-15 Thread Kalpa Welivitigoda
On Fri, Apr 12, 2013 at 8:37 PM, Kalpa Welivitigoda wrote: > > > > On Fri, Apr 12, 2013 at 2:00 PM, Bastien wrote: > >> Walter Bender writes: >> >> > Coming up with a decent framework which we can populate from these >> > sources would take us a long ways. >> >> Indeed. I created this repo: >>

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-12 Thread Kalpa Welivitigoda
On Fri, Apr 12, 2013 at 2:00 PM, Bastien wrote: > Walter Bender writes: > > > Coming up with a decent framework which we can populate from these > > sources would take us a long ways. > > Indeed. I created this repo: > https://github.com/bzg/aslodocs > > I will try to populate with docs when

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-12 Thread Bastien
Walter Bender writes: > Coming up with a decent framework which we can populate from these > sources would take us a long ways. Indeed. I created this repo: https://github.com/bzg/aslodocs I will try to populate with docs when I find time for this. I welcome merge requests of course, if othe

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-12 Thread Bastien
Kalpa Welivitigoda writes: > Although the project idea says to implement a help system using > Mallard, we can extend it, write help files in plain text and convert > them to desired forms (Mallard, html etc) so that we can present them > in several possible ways. Yep, that makes sense. -- Ba

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Walter Bender
On Thu, Apr 11, 2013 at 11:39 PM, Kalpa Welivitigoda wrote: > > > > On Fri, Apr 12, 2013 at 1:53 AM, Gonzalo Odiard wrote: > >> +10 >> > > Many thanks to Bastein for focusing us all on the topic again. > > >> >> We need use the easier possible way to write (and translate) the docs. >> I don't know

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Kalpa Welivitigoda
On Fri, Apr 12, 2013 at 1:53 AM, Gonzalo Odiard wrote: > +10 > Many thanks to Bastein for focusing us all on the topic again. > > We need use the easier possible way to write (and translate) the docs. > I don't know if there are wysiwyg tools to write the XML files for Mallard, > if not, is a

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Gonzalo Odiard
+10 We need use the easier possible way to write (and translate) the docs. I don't know if there are wysiwyg tools to write the XML files for Mallard, if not, is a big step backward. Gonzalo On Thu, Apr 11, 2013 at 5:19 PM, Bastien wrote: > Hi all, > > translation comes after the docs have be

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Bastien
Hi all, translation comes after the docs have been written. The main barrier is not dependancies for translation tools, it's about *writing* documentation. Hence the idea of using a plain text light markup language. Maybe we could run an informal poll about this in the Sugar community to get a

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Chris Leonard
On Thu, Apr 11, 2013 at 2:55 PM, Kalpa Welivitigoda wrote: > > Here is Shaun's reply > > "We use ITS Tool to extract strings from XML into PO files, then merge > translated strings back to new XML files: > > http://itstool.org/ > > ITS Tool works with any type of XML, and uses the Internationaliz

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Kalpa Welivitigoda
On Thu, Apr 11, 2013 at 11:01 PM, Daniel Narvaez wrote: > On 11 April 2013 19:02, Chris Leonard wrote: > >> On Thu, Apr 11, 2013 at 11:30 AM, Kalpa Welivitigoda >> wrote: >> > >> > Since the initial form of the help file is in plain text, we can simply >> > extract the strings from there. btw, I

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Daniel Narvaez
On 11 April 2013 19:02, Chris Leonard wrote: > On Thu, Apr 11, 2013 at 11:30 AM, Kalpa Welivitigoda > wrote: > > > > Since the initial form of the help file is in plain text, we can simply > > extract the strings from there. btw, I've mailed Shaun so that we can > have > > his inputs to this dis

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Chris Leonard
On Thu, Apr 11, 2013 at 11:30 AM, Kalpa Welivitigoda wrote: > > Since the initial form of the help file is in plain text, we can simply > extract the strings from there. btw, I've mailed Shaun so that we can have > his inputs to this discussion as well. I think most of our builds use fairly plain

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Kalpa Welivitigoda
On Thu, Apr 11, 2013 at 8:31 PM, Chris Leonard wrote: > On Thu, Apr 11, 2013 at 10:59 AM, Chris Leonard > wrote: > > On Thu, Apr 11, 2013 at 10:34 AM, Manuel Quiñones > wrote: > >> 2013/4/11 Bastien : > >>> Hi Kalpa, > >>> > >>> this is a very nice and much needed project. > >>> > >>> Let's wait

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Chris Leonard
On Thu, Apr 11, 2013 at 10:59 AM, Chris Leonard wrote: > On Thu, Apr 11, 2013 at 10:34 AM, Manuel Quiñones wrote: >> 2013/4/11 Bastien : >>> Hi Kalpa, >>> >>> this is a very nice and much needed project. >>> >>> Let's wait for Chris to chim in. My take on this is that help files >>> should be st

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Chris Leonard
On Thu, Apr 11, 2013 at 10:34 AM, Manuel Quiñones wrote: > 2013/4/11 Bastien : >> Hi Kalpa, >> >> this is a very nice and much needed project. >> >> Let's wait for Chris to chim in. My take on this is that help files >> should be stored using a plain text format like MarkDown or Org-mode. >> It's

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Manuel Quiñones
2013/4/11 Bastien : > Hi Kalpa, > > this is a very nice and much needed project. > > Let's wait for Chris to chim in. My take on this is that help files > should be stored using a plain text format like MarkDown or Org-mode. > It's easier to hack directly, it's easier to read diffs against such >

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Kalpa Welivitigoda
On Thu, Apr 11, 2013 at 1:06 PM, Bastien wrote: > Hi Kalpa, > > this is a very nice and much needed project. > > Let's wait for Chris to chim in. My take on this is that help files > should be stored using a plain text format like MarkDown or Org-mode. > It's easier to hack directly, it's easier

Re: [Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-11 Thread Bastien
Hi Kalpa, this is a very nice and much needed project. Let's wait for Chris to chim in. My take on this is that help files should be stored using a plain text format like MarkDown or Org-mode. It's easier to hack directly, it's easier to read diffs against such files, it's easier to feed a trans

[Sugar-devel] [GSoC 2013] Interested in "Implement help mechanism for activities using Mallard"

2013-04-09 Thread Kalpa Welivitigoda
Hi all, I am interested in the GSoC project idea "Implement help mechanism for activities using Mallar" which is mentored by Walter. The idea in my mind is that developers have to have a Mallard file with the help for their activity. And a tool should be developed to extract strings from those Mal