User:Richajain1912/GSOC2014/

Personal Information

Name: Richa Jain
E-Mail: richa.jain1912@gmail.com
IRC Nick: richa (#brlcad on freenode)

Background Information

Hi, I am Richa Jain, a third year Undergraduate student from Indian Institute of Technology Roorkee. I am currently a developer at Software Development Section of my institute. I was also a GSoC 2013 student under Wikimedia Foundation and now I am looking forward to work with BRL-CAD.

Project Information

Project Title

Synchronize wiki with Docbook

Brief project summary

BRL-CAD’s documentation is available in a variety of formats but the best way of maintaining documentation is docbook XML. However, as we know that a general user finds it easier to edit a wiki page rather than a docbook. Conversion between XML markup (docbook) and wiki syntax is not that easy. Using tools like pandoc for this, some markups are lost and ultimately the data is ruined. So, the main aim of this project is to Synchronize wiki and docbook so that any changes made to the wiki appears in the docbook and vice-versa without any loss of data. The project will be implemented as a separate mediawiki extension which shows the docbook XML in the edit window and after they have edited it, the XML is processed to produce the HTML web output. If a user prefers to edit wiki markup, then after the editing, the docbook XML can be downloaded.

Detailed project description

There are basically two approaches for this project:
1. Since mediawiki's Collection extension[1] converts wiki markup to Docbook XML and for the vice-versa, projects like Beacon[2] converts Docbook to weboutput. So, in order to have a synchronization between the two edits we must use both the technologies in a combined way.
2. Instead of using both of these technologies, we can define our own mediawiki extension which intelligently maps wiki markup to docbook markup and serves both the purposes simultaneously. This can be done with mediawiki parser functions.

This needs some research regarding which approach will be more beneficial, so I will utilize my time during the community bonding period in finding out a reliable method.

Workflowy

1. Fetching of XML- Once the user chooses “edit via docbook format”, the backend will fetch XML and display it in the editing window.
2. Mapping of XML to wiki markup and vice-versa- Making a directory which maps the XML markup to wiki markup and vice-versa using mediawiki parser functions.
3. Processing of XML- Once the user chooses “save”, the entire XML is processed, compiled into wikitext and the HTML output is displayed.

Time availability

• Time Zone: UTC+5:30 (IST-India)
• Typical working hours: 12 noon to 1 am before July, 6pm to 3am after July

I am quite flexible with the timings and will try to dedicate most of my time to this project.

Past Experiences

• I was a Google Summer of Code 2013 student under Wikimedia Foundation. I worked on making a mediawiki extension (Annotator) which allows user to make inline comments on a wiki article. This project was based on PHP, JavaScript. The source code can be seen here
• My open source projects can be seen on github.

Why me

I will work hard and bring this project to completion. I am always logged in to IRC (#brlcad) whenever I work. I will be making frequent commits and giving information to my mentors and the community and taking help from people around whenever I am stuck.

References

[1] https://www.mediawiki.org/wiki/Extension:Collection
[2] http://fedoraproject.org/wiki/DocBook_Editor_Documentation