<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Jun 10, 2013 at 6:19 PM, Gonzalo Odiard <span dir="ltr"><<a href="mailto:gonzalo@laptop.org" target="_blank">gonzalo@laptop.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Ok.<div><br></div><div>You need look at a mechanism to generate the index.</div>
</div></blockquote><div><br></div><div style>Since markdown is only for the source, I don't think it is necessary, an index would be useful when we are going to display the help using Mallard. What do you think Gonzalo?</div>
<div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div>Right now, index.markdown is almost empty, probably because was not used a rst standard,</div>
<div>but a sphinx extension:</div>
<div><br></div><div><a href="https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content/blobs/4ef6675c1322b8a5ab7e37dfaade498a9edd6bc8/source/index.markdown" target="_blank">https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content/blobs/4ef6675c1322b8a5ab7e37dfaade498a9edd6bc8/source/index.markdown</a><br>
</div><div><br></div><div>Also, we need a method to generate the html content (a script is ok)</div></div></blockquote><div><br></div><div style>It can be done from pandoc itself and pandoc is available in stable repos of many popular distros (including fedora). That will be useful.</div>
<div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div>Can you create a page in the wiki, like [1]</div>
<div>to document your work?</div></div></blockquote><div><br></div><div style>Hope this would do <a href="http://wiki.sugarlabs.org/go/GSoC/2013/MallardHelp">http://wiki.sugarlabs.org/go/GSoC/2013/MallardHelp</a></div><div style>
I will keep on adding more info as I progress.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div dir="ltr"><div>
<br></div><div>Gonzalo </div><div><br></div><div><br></div><div>[1] <a href="http://wiki.laptop.org/go/Help_Activity_refresh/0.98" target="_blank">http://wiki.laptop.org/go/Help_Activity_refresh/0.98</a></div><div>
<br></div></div><div class="gmail_extra"><br><br><div class="gmail_quote"><div><div class="h5">On Mon, Jun 10, 2013 at 8:57 AM, Kalpa Welivitigoda <span dir="ltr"><<a href="mailto:callkalpa@gmail.com" target="_blank">callkalpa@gmail.com</a>></span> wrote:<br>
</div></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div class="h5"><div dir="ltr">Hi,<div><br>
</div><div>After the initial discussion I had with Gonzalo last Monday, we agreed to use Markdown [1] as the base for the source Help files. Existing help content [2] is in rst and they needs to be converted to Markdown. I've used pandoc [3] to convert those rts source files to Markdown and has pushed them to a fork [4] the repo. So the developers can either use rst or Markdown to write their source help files.</div>
<div><br></div><div>[1] <a href="http://daringfireball.net/projects/markdown/" target="_blank">http://daringfireball.net/projects/markdown/</a><br></div><div>[2] <a href="https://git.sugarlabs.org/help-activity-content" target="_blank">https://git.sugarlabs.org/help-activity-content</a></div>
<div>[3] <a href="http://johnmacfarlane.net/pandoc/" target="_blank">http://johnmacfarlane.net/pandoc/</a></div><div>[4] <a href="https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content" target="_blank">https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content</a></div>
<span><font color="#888888">
<div><br clear="all"><div><br></div>-- <br>Best Regards,<br><br>Kalpa Welivitigoda<br>
Junior Treasurer | Electrical Engineering Society<br>Undergraduate | Department of Electrical Engineering<br>University of Moratuwa<br>Sri Lanka<br><a href="http://about.me/callkalpa" target="_blank">http://about.me/callkalpa</a>
</div></font></span></div></div></div><span class=""><font color="#888888"><span><font color="#888888">
<p></p>
-- <br>
You received this message because you are subscribed to the Google Groups "Sugar GSoC" group.<br>
To unsubscribe from this group and stop receiving emails from it, send an email to <a href="mailto:sugar-gsoc%2Bunsubscribe@googlegroups.com" target="_blank">sugar-gsoc+unsubscribe@googlegroups.com</a>.<br>
For more options, visit <a href="https://groups.google.com/groups/opt_out" target="_blank">https://groups.google.com/groups/opt_out</a>.<br>
<br>
<br>
</font></span></font></span></blockquote></div><span class=""><font color="#888888"><br></font></span></div><span class=""><font color="#888888">
<p></p>
-- <br>
You received this message because you are subscribed to the Google Groups "Sugar GSoC" group.<br>
To unsubscribe from this group and stop receiving emails from it, send an email to <a href="mailto:sugar-gsoc%2Bunsubscribe@googlegroups.com" target="_blank">sugar-gsoc+unsubscribe@googlegroups.com</a>.<br>
For more options, visit <a href="https://groups.google.com/groups/opt_out" target="_blank">https://groups.google.com/groups/opt_out</a>.<br>
<br>
<br>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br>Best Regards,<br><br>Kalpa Welivitigoda<br>Junior Treasurer | Electrical Engineering Society<br>Undergraduate | Department of Electrical Engineering<br>
University of Moratuwa<br>Sri Lanka<br><a href="http://about.me/callkalpa" target="_blank">http://about.me/callkalpa</a>
</div></div>