Difference between revisions of "XULRunner Guide"

From CDOT Wiki
Jump to: navigation, search
(Project News)
(Project News)
Line 82: Line 82:
 
Made updates to setting up the pref.js file.
 
Made updates to setting up the pref.js file.
 
<br>
 
<br>
 
'''October 23, 2006 by mylau'''
 
 
Changed one of the headings in the table of contents "How to an application using XULRunner" to "How to do a Hello World application using XULRunner".  Also finished writing a tutorial on the "Hello World" application.
 
 
'''October 22, 2006 by mylau'''
 
 
Worked on how to create a XULRunner application tutorial.
 
 
'''October 16, 2006 by cbguy1'''
 
 
I have finished entering the XUL Runner install instructions for a Win32 operating system.  Currently I am looking into the XUL Runner 64bit installation instructions.  I am looking for any similarities and differences. 
 
 
'''October 09, 2006 by mylau'''
 
 
I've looked through bsmedberg emails on XULRunner (XR) for this week.  For a starting point, I wanted to start with the simplist task first, creating a "Hello World" application for XR.  I've searched through quite a few websites, mainly from the MDC.  For the first half of the day, I couldn't find any websites which actually guided me step by step on how to create a simple XR application.  The closes website I found was from [http://blogs.acceleration.net/ryan/archive/2005/05/06/1073.aspx Ryan's Blog].  The blog had a tutorial on how to set up a XR application but it missed one important aspect, how to run the application. 
 
 
After this, I realized I've been putting too much time finding tutorial on how to create an intutive XR application.  Perhaps no one has posted any on the web yet.  So I tried to reverse engineer an existing XR application, [http://developer.mozilla.org/en/docs/XULMine_sample_XULRunner_Application_%28external%29 XULMine].  Unfortunately I wasn't very successful.  The code for this application seem too complex for myself to understand. 
 
 
As a result, I started my search all over again.  Fortunately, I missed a link which was on MDC XULRunner, [http://developer.mozilla.org/en/docs/Getting_started_with_XULRunner Getting started with XR].  Thankfully, I was able to create my first "Hello World" application on XR.  I wasn't able to finish writing documentation on this but hopefully by the end of the week, I'll be able to manage some time and have this completed.
 
 
 
'''October 02, 2006 by mylau'''
 
 
We sent an email to bsmerdberg about what we've currently have worked on so far for this project.  Dave Humphrey helped us send another email dria, bsmedberg, and sheppy about our project.  We're currently waiting for their response. Hopefully they will tell us what they want in the XULRunner guide.
 
 
Colin and I have started testing the stable version of XULRunner which is 1.8.0.4.  I'm mainly responsible for the Linux side of XULRunnre while as Colin is responsible for Windows.  We've installed XULRunner and tried installing a few XULRunner application.  We also put the information in the XULRunner Guide outline.
 
 
'''September 25, 2006 by mylau'''
 
 
Moved the outline to have its own heading.  This way when changes are needed to be made, its done on the outline rather than keep updating the project news section.
 
 
'''September 21, 2006 by mylau'''
 
 
The following is outline for XULRunner Guide.  This outline may change.  It needs to be reviewed by BSmedberg and Sheppy.
 
  '''About this guide'''
 
    - New features in this release
 
    - XULRunner versions
 
    - Document conventions
 
  '''XULRunner Overview'''
 
    - What is XULRunner?
 
  '''How Tos'''
 
    - Installation process
 
    - How to do an application using XULRunner
 
    - How to deploy XULRunner
 
    - How to run an extension as an application using XULRunner
 
    - How to update XULRunner
 
 
 
 
'''September 17, 2006 by mylau'''
 
 
I've spoke to Dave about this project and currently the following people to talk to are:
 
 
*dria (owns MDC)
 
*bsmedberg (XUL Runner guy)
 
*sheppy (dev/docs)
 
 
I will speak to these following people along with dave as soon as I get up-to-speed on what XUL Runner actually is.
 
  
 
== Project News Archive ==
 
== Project News Archive ==

Revision as of 00:15, 29 November 2006

Project Name

XUL Runner Guide

Project Description

The XULRunner project provides an "application runner" for building apps -- like Firefox, Thunderbird, and Sunbird -- atop the Mozilla toolkit framework. It needs a guide outlined, high-priority parts written, and examples created to help people get started.

Related tech and skills: XUL, documentation, cross-platform testing.

Project Leader(s)

Michael Lau (mylau)

Colin Guy (Guiness)

Project Contributor(s)

  • Vanessa
  • Paul St-Denis
  • Erin Davey
  • Elichak
  • Helped some comments on the Hello World tutorial

Project Details

XULRunner Guide Outline

XULRunner Guide

Project News

November 27, 2006 by mylau

These were some of the links I found that can potentially convert Wiki's to PDF automatically. I have yet to test these few alternatives but hopefully I'll get around to it next week.

Also, there was one site which I went to whcih said the easiest way of solving the converting between wiki to PDF issue was to save each file as HTML and convert them to PDF using Open Office. This seems like usable alternative since my team only has about 20 pages max. Although this is true, I would still like to automate the converting. Some users in the community might want to know how to do this as well.

On top of converting the pages to PDF, I also need to know if there's a free PDF editor that I can use. I suspect after converting each file to PDF, it won't be formatted properly or at least to not my liking.

November 26, 2006 by mylau

Looked into the PDF recommended by Melz and recommendation by Elichak for the documentation structure


Updated all the doucments in the Tutorial on XULRunner sections. They include:

  • File/Folder Structure
  • application.ini File
  • chrome.manifest File
  • prefs.js File
  • How to run the application


Since there is only one version of XULRunner that this document is discussing currently, I moved Deploying XULRunner 1.8 to Delploying XULRunner. Also, I moved the XULRunner Guide Outline from the main page to XULRunner_Guide_Outline. In the guide, I removed the following:

  • New features in this release
  • Changes made
  • Bug Fixes for each version

There wasn't much information on these topics, if any. To be able to have these sections in the guide would require extensive time to investigate the isuses of XULRunner from day 1 of when it was launched. We don't have that much tine to invest on this. I also rearranged some of the topics in the outline such as XULRunner Version and About this guide.


I've added an introduction and conclusion to the How to do a Hello World application using XULRunner. I also revised the document so its more intuitive for new developers as well as provided a screenshot of the executed program.

November 25, 2006 by cbguy1
Currently working on the different mehods XULRunner is deployed amoung the various operating systems. The page has been setup to accomadate subsequent versions of XULRunner when they will be released. Also any unnecessary or redundant headings were removed.
Working on an Introduction for the XUL Runner guide.
Made updates to setting up the pref.js file.

Project News Archive

Useful Links