1
edit
Changes
→Development updates
=Name of Project=
Portable DXR[http://developer.mozilla.org/En/Dehydra Dehydra] Cross Referene (PDXR)
=Description=
=Leaders=
[[User:Samer.Ziadeh|Samer Ziadeh]]
[[User:jtpau|Jerry Pau]]
=Details=
==Related Projects==
* [[Mozilla_Developer_Resource_Kit|Mozilla Developer Resource Kit]]: This is the over-arching project of which the PDXR is but one piece.
* [[Creating_an_MDRK_spin|Creating an MDRK spin]]: This is how this project will eventually be distributed.
* [[Create_Local_MXR|Create a local mxr]]: It is hoped that by solving the more difficult problem of packaging the dxr, the problem of packaging other materials such as an mxr or developer documentation will also be solved.
==Technical Overview==
===Business Rules===
* Must not sell project for profit
* Commit to lowest file size bandwidth
===About The Source Code===
* Backend: Perl
* Database: SQLite
* Interface: XUL
===Perl Interpreter===
Perl will be needed to create pages from database queries. It needs to be able to run from within the extension on Windows, Linux, and Mac. [http://perldoc.perl.org/perlembed.html Perlembed] allows us to use Perl from C, which means that we could compile our program with headers that will be able to alternate between Windows, Linux, and Mac.
===Web Server===
<pre style="font-family:Verdana,Helvetica,sans-serif;border:1px solid #F4C430;font-weight:bold">We are still researching for a light-weight webserver. This section be updated regularly.</pre>
Our picks (so far):
* [http://shttpd.sourceforge.net/ SHTTPD]
* [http://dclib.sourceforge.net/ dlib C++]
* [https://neuro-tech.net/files/ Cheetah Server]
* [http://www.documentroot.com/code/ppcgid Pure Perl CGId]
* [http://nginx.net/ nginx] ([http://wiki.codemongers.com/NginxEmbeddedPerlExample?highlight=(embed) Embedding example code])
List of web servers:
* [http://en.wikipedia.org/wiki/Tiny_web_servers Wikipedia's List]
* [http://www.ibm.com/developerworks/web/library/wa-ltwebserv IBM's List]
===Features===
* Running server side Mozilla code on the local machine. The extension will have an embedded server that will handle the server-side scripting.
* Notify the user that their database may be out-of-date 30 days after last update.
* Option to allow compression of data download.
===Users ===
* Developers with limited or slow internet connection
===Architecture===
<pre style="font-family:Verdana,Helvetica,sans-serif;border:1px solid #F4C430;font-weight:bold">The architecture is still undergoing development and this section will be updated regularly.</pre>
[[Image:PDXR_high_level_diagram.png|thumbnail|right|400px|High level conceptualization]]
====Mozilla-Central====
[https://developer.mozilla.org/en/mozilla-central Mozilla-Central] is the main repository for Mozilla source code. This is the raw fodder out of which documentation will be created. How it is created doesn't really appear on our diagram unless you count the "How does this happen?" note.
Well, how it happens is through a static analysis tool called [https://developer.mozilla.org/en/Dehydra Dehydra]. In layman's terms, Dehydra reads the Mozilla source code and annotates it in a way that can be turned into documentation in an automated fashion. This part is another project entirely and as it relates to our project, the relevant work is being done by David Humphrey. However, our team will need to setup the Dehyra tool to feed our update server.
====Update Server====
Although this project is all about building a tool for browsing documentation off-line, that documentation is in a constant state of flux. It would be useful to be able to refresh it when need be. The update server needn't be terribly complex. A simple Apache server and some CGI work should suffice.
However, it needs to be worked out exactly what kind of update is being pushed. Is it a binary diff of the sqlite database? And if so, will it need to keep a collection of diffs based on a original dataset in order to service users who haven't sync'd for some time. There's also the question of whether the update mechanism build into Mozilla for extensions is useful to us. We need to do some research on how extension updates work.
====Application====
======Web Browser======
The application front-end holder. It provides a way for the application to be accessed.
It is not limited to Firefox web browser only, it can also be run as a Prism application.
======Extention======
Portable DXR (our browsable source code documentation) is an application that lives inside our extension. The CGI tools exist as part of an embeddable web server. When you remove the DXR part, what you are left with is the platform on which it runs. It's also worth pointing out that the SQLite support is available in two ways. Local storage capabilities using SQLite are build into Mozilla applications and can be accessed by an extension using C++, JavaScript, Python. However, SQLite database files can be accessed by any software that understands the format, so SQLite support will also be available through the cgi tools. The DXR application will probably use the CGI tools to access SQLite files if our presentation layer is traditional XHTML. But if we decide to use XUL, we can use the browser's built in functionality directly from JavaScript. In either case, I suspect we will end up leveraging the built in sqlite support for the updates. But we need to do some research on that.
======DXR======
The presentation. The front-end is mostly implemented by [http://vocamus.net/dave/ David Humphrey] on his [http://zenit.senecac.on.ca/wiki/dxr/ DXR]. We need to modify the UI to implement the following functionalities:
* Navigation
* Database querying
* Update services
* Data transaction
======UI======
* Navigation
* Tree:
**Source Code
**Documentation '''(Source code documentation)'''
**Help '''(PDXR Documentation)'''
**Options
*** Automatic updates
*** Prompted updates
*** Session saving
=Roadmap=
* Port [http://zenit.senecac.on.ca/wiki/dxr/ DXR] <small>'''(1 week)'''</small>
* Modify UI <small>'''(4 weeks total)'''</small>
** Left panel:
*** Source Code
*** Documentation <small>(Source code documentation) '''(1 week)'''</small>
*** Help <small>(PDXR Documentation) '''(2 weeks)'''</small>
*** Options <small>'''(1 week)'''</small>
**** Automatic updates
**** Prompted updates
**** Session saving
* Implement the web server <small>'''(1 week)'''</small>
** Test the web server on the different platforms
* Implement the Perl parser <small>'''(1 week)'''</small>
** Test Perl scripts on the different platforms
* Code the CGI tools <small>'''(4 weeks)'''</small>
==Related Projects=News & Updates=
==Meetings (Chronological)==
[[Portable_DXR/meeting_092608|Sept 26, 2008]]: Discussion with David Humphrey about project scope. [[Portable_DXR/meeting_100208|Oct 2, 2008]]: Discussion with David Humphrey about technical details of DXR. Oct 8, 2008: Team meeting to discuss Work Breakdown Structure (coming soonWBS) [[Portable_DXR/meeting_101608|Oct 16, 2008]]: Team meeting to discuss technical details of project [[Portable_DXR/meeting_102908|Oct 29, 2008]]: Further discussions with David Humphrey about documenting the project. [[Portable_DXR/meeting_103008|Oct 30, 2008]]: Group meeting to map out high level design. [[Portable_DXR/meeting_110508|Nov 5, 2008]]: Team meeting with David Humphrey about progress. ==Team Blogs== * [http://jamesboston.ca/cms/taxonomy/term/22 James Boston]: All relevant posts are tagged 'pdxr'.* [http://sameropensource.blogspot.com Samer Ziadeh]* [http://www.jerrypau.ca/?cat=3 Jerry Pau] ==IRC==* [irc://irc.mozilla.org/PDXR #PDXR]* [irc://irc.mozilla.org/seneca #seneca]
=News and updates=TODO==
* Design of the interface of PDXR that will be using [https://developer.mozilla.org/en/Dehydra Dehydra] <small>'''(coming soonby 27/11/08)''' ([[User:Jtpau|Jerry Pau]] & [[User:Samer.Ziadeh|Samer Ziadeh]])</small>.