GSoC/2013/MallardHelp - Revision history

Callkalpa at 18:19, 10 July 2013

2013-07-10T18:19:36Z

← Older revision		Revision as of 14:19, 10 July 2013
Line 1:		Line 1:
			''' It was found that the objectives of the project can be achieved through the current help mechanism. Therefore Mallard was abandoned and more info on the current project is at http://wiki.sugarlabs.org/go/GSoC/2013/ActivityHelp '''

	==Introduction==		==Introduction==

Callkalpa: /* To-do */

2013-07-08T13:15:53Z

To-do

← Older revision		Revision as of 09:15, 8 July 2013
Line 22:		Line 22:
	==To-do==		==To-do==

	* Develop a script to convert ~~Markdown~~ source files to Mallard		* Develop a script to convert html source files to Mallard
	** ~~Up to now the current plan~~ is ~~to use html as an intermediate format~~. ~~It will~~ be ~~easy to convert markdown or rst to html, it is straight forward with pandoc. Next a xml parser will be used and the mallard file will be written. At the moment~~ I ~~am reading about xml parsing in python.~~		** This is being developed already. I'll be adding more tags as I come across them
	* ~~Implement a mechanism to show~~ help in ~~each~~ activity		* Display the relevant help file in the activity (map help file with their relevant activity)
	* ~~Extract strings from the~~ help ~~docs and feed them to pootle for l10n~~		* Lokalization of help content
	* Write help for activities for which help is not there yet		* Write help for activities for which help is not there yet

	==Reference==		==Reference==
	<references />		<references />

Callkalpa: /* Work so far */

2013-07-08T13:11:09Z

Work so far

← Older revision		Revision as of 09:11, 8 July 2013
Line 14:		Line 14:
	==Work so far==		==Work so far==

	* Help content<ref>Help content of the Help activity [https://git.sugarlabs.org/help-activity-content]</ref> of the Help activity which is in rst has been converted to Markdown. The conversion was done using pandoc<ref>pandoc [http://johnmacfarlane.net/pandoc/]</ref>. The Markdown files are push at a fork<ref>Markdown files of the current help content [https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content]</ref> of the help-activity-content.		* Help content<ref>Help content of the Help activity [https://git.sugarlabs.org/help-activity-content]</ref> of the Help activity which is in rst has been converted to Markdown. The conversion was done using pandoc<ref>pandoc [http://johnmacfarlane.net/pandoc/]</ref>. The Markdown files are push at a fork<ref>Markdown files of the current help content [https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content]</ref> of the help-activity-content. (This is not relevant anymore since we are using html as the final file format before Mallard conversion)

	* A python script<ref>HTML to mallard conversion script [https://git.sugarlabs.org/mallardhelp/mallardhelp]</ref> to convert from html to mallard is being developed.		* A python script<ref>HTML to mallard conversion script [https://git.sugarlabs.org/mallardhelp/mallardhelp]</ref> to convert from html to mallard is being developed.

Callkalpa: /* Introduction */

2013-07-08T13:09:41Z

Introduction

← Older revision		Revision as of 09:09, 8 July 2013
Line 8:		Line 8:
	[[Image:MallardHelpStructure.png]]		[[Image:MallardHelpStructure.png]]

	In the current help system, the source docs are only of rst. This projects expands it to be either rst, markdown or html. Ultimately the doc will be converted to html using pandoc before converting to Mallard. Mallard is a topic oriented help documentation system. The help for each activity will be displayed in a pop up window (~~just as~~ view source) once the shortcut key is pressed.		In the current help system, the source docs are only of rst. This projects expands it to be either rst, markdown or html. Ultimately the doc will be converted to html using pandoc before converting to Mallard. Mallard is a topic oriented help documentation system. The help for each activity will be displayed in a pop up window (similar to view source) once the shortcut key is pressed.

			The help maintainer is to take care of the process upto generating the final html file. The final html file will only be shipped with sugar so as to avoid any additional dependencies and to avoid any slowness. To display the help, a new Gtk Window will be implemented and shipped with sugar core. The help maintainer will be using pandoc, html to mallard script and yelp's xslt conversion before he commit the final html file.

	==Work so far==		==Work so far==

Callkalpa: /* Work so far */ ViewHelp window implemented

2013-07-08T12:25:59Z

Work so far: ViewHelp window implemented

← Older revision		Revision as of 08:25, 8 July 2013
Line 15:		Line 15:

	* A python script<ref>HTML to mallard conversion script [https://git.sugarlabs.org/mallardhelp/mallardhelp]</ref> to convert from html to mallard is being developed.		* A python script<ref>HTML to mallard conversion script [https://git.sugarlabs.org/mallardhelp/mallardhelp]</ref> to convert from html to mallard is being developed.

			* A Gtk Window is implemented with WebKit to display the help for each activity. The shortcut key is [Alt][Shift]h

	==To-do==		==To-do==

Callkalpa: /* Introduction */ process image and description added

2013-07-08T12:23:42Z

Introduction: process image and description added

← Older revision		Revision as of 08:23, 8 July 2013
Line 2:		Line 2:

	This page presents the status of the project "Implement help mechanism for activities using Mallard" <ref>Implement help mechanism for activities using Mallard [http://wiki.sugarlabs.org/go/Summer_of_Code/2013#Implement_help_mechanism_for_activities_using_Mallard]</ref>. This project is being implemented as a GSoC 2013 project.		This page presents the status of the project "Implement help mechanism for activities using Mallard" <ref>Implement help mechanism for activities using Mallard [http://wiki.sugarlabs.org/go/Summer_of_Code/2013#Implement_help_mechanism_for_activities_using_Mallard]</ref>. This project is being implemented as a GSoC 2013 project.


			Following is a representation of the desired process.

			[[Image:MallardHelpStructure.png]]

			In the current help system, the source docs are only of rst. This projects expands it to be either rst, markdown or html. Ultimately the doc will be converted to html using pandoc before converting to Mallard. Mallard is a topic oriented help documentation system. The help for each activity will be displayed in a pop up window (just as view source) once the shortcut key is pressed.

	==Work so far==		==Work so far==

Callkalpa: /* Work so far */

2013-06-21T16:41:38Z

Work so far

← Older revision		Revision as of 12:41, 21 June 2013
Line 6:		Line 6:

	* Help content<ref>Help content of the Help activity [https://git.sugarlabs.org/help-activity-content]</ref> of the Help activity which is in rst has been converted to Markdown. The conversion was done using pandoc<ref>pandoc [http://johnmacfarlane.net/pandoc/]</ref>. The Markdown files are push at a fork<ref>Markdown files of the current help content [https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content]</ref> of the help-activity-content.		* Help content<ref>Help content of the Help activity [https://git.sugarlabs.org/help-activity-content]</ref> of the Help activity which is in rst has been converted to Markdown. The conversion was done using pandoc<ref>pandoc [http://johnmacfarlane.net/pandoc/]</ref>. The Markdown files are push at a fork<ref>Markdown files of the current help content [https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content]</ref> of the help-activity-content.

			* A python script<ref>HTML to mallard conversion script [https://git.sugarlabs.org/mallardhelp/mallardhelp]</ref> to convert from html to mallard is being developed.

	==To-do==		==To-do==

Callkalpa at 15:05, 13 June 2013

2013-06-13T15:05:25Z

← Older revision		Revision as of 11:05, 13 June 2013
Line 10:		Line 10:

	* Develop a script to convert Markdown source files to Mallard		* Develop a script to convert Markdown source files to Mallard
			** Up to now the current plan is to use html as an intermediate format. It will be easy to convert markdown or rst to html, it is straight forward with pandoc. Next a xml parser will be used and the mallard file will be written. At the moment I am reading about xml parsing in python.
	* Implement a mechanism to show help in each activity		* Implement a mechanism to show help in each activity
			* Extract strings from the help docs and feed them to pootle for l10n
			* Write help for activities for which help is not there yet

	==Reference==		==Reference==
	<references />		<references />

Callkalpa: Initiation of the page

2013-06-10T14:20:56Z

Initiation of the page

New page

==Introduction==

This page presents the status of the project "Implement help mechanism for activities using Mallard" <ref>Implement help mechanism for activities using Mallard [http://wiki.sugarlabs.org/go/Summer_of_Code/2013#Implement_help_mechanism_for_activities_using_Mallard]</ref>. This project is being implemented as a GSoC 2013 project.

==Work so far==

* Help content<ref>Help content of the Help activity [https://git.sugarlabs.org/help-activity-content]</ref> of the Help activity which is in rst has been converted to Markdown. The conversion was done using pandoc<ref>pandoc [http://johnmacfarlane.net/pandoc/]</ref>. The Markdown files are push at a fork<ref>Markdown files of the current help content [https://git.sugarlabs.org/~callkalpa/help-activity-content/callkalpa-help-activity-content]</ref> of the help-activity-content.

==To-do==

* Develop a script to convert Markdown source files to Mallard
* Implement a mechanism to show help in each activity

==Reference==
<references />