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

[Kalpa Welivitigoda]

On Thu, Apr 11, 2013 at 8:31 PM, Chris Leonard <cjlhomeaddress at gmail.com>wrote:

> On Thu, Apr 11, 2013 at 10:59 AM, Chris Leonard
> <cjlhomeaddress at gmail.com> wrote:
> > On Thu, Apr 11, 2013 at 10:34 AM, Manuel Quiñones <manuq at laptop.org>
> wrote:
> >> 2013/4/11 Bastien <bzg at laptop.org>:
> >>> 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 translator with them, and it can then be
> >>> converted into Mallard (for internal browsing), or HTML (for online
> >>> documentation) or... anything else.
> >>>
> >>> Storing directly in Mallard would be a mistake IMHO.
> >
>
>
> I know that Gnome projects use Mallard.  I don't really know the string
> extraction workflow that results in them being posted to the Damned
> Lies server.  I would guess that the gnome-18n mailing list or Shaun
> McCance would be the people who would know more about that.
>
>
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.


> cjl
>



-- 
Best Regards,

Kalpa Welivitigoda
Junior Treasurer | Electrical Engineering Society
Undergraduate | Department of Electrical Engineering
University of Moratuwa
Sri Lanka
http://about.me/callkalpa
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.sugarlabs.org/archive/sugar-devel/attachments/20130411/14687ded/attachment.html>