mozdev.org

CalendarHelp

resources:
developer:
project:
projects:

This page describes how to build CalendarHelp from its source files.

Viewing individual source files

If you are a writer or translator, you can test an individual source file by viewing it in a Mozilla browser. Use the stylesheet draft.css and the bindings draft.xbl supplied with the English source.

You can customize your view of the source files by modifying draft.css.

Full build—overview

The builder is a tool that runs in Firefox on Windows. You might be able to make it run in a different browser or on a different platform, but these variations are not supported.

The builder requires an external ZIP tool from Info-ZIP.

The builder works on local copies of the source files on your computer. Use a CVS client to get the source files. The builder does not pull them.

For additional information about the builder, see Building help for other projects.

Source files

You must have copies of all the source files that the builder needs, in the same directory structure that you find in CVS. You do not need all the source files for the project—only the files that are required for the parts that you want to build.

Place the source files in any base directory on your computer. This base directory corresponds to the src directory in CVS. You can use any name you like for the base directory—it does not have to be src.

Inside your base directory, keep the directory names and structure the same as in CVS.

You can store additional files and directories in most places in the directory structure without affecting the build, but there are some exceptions:

What the builder does

The builder can build each of CalendarHelp's locales.

For each locale, it can build:

Indexes

There are four indexes. Three of the indexes are built in each locale. They correspond to panels in the Help sidebar:

The fourth is only built in en-US, because it has no translatable content. This index maps user-interface elements to help topics:

Note: If you find copies of the indexes stored in CVS, this is by mistake because they are not source files. If you want to see the indexes, extract them from the jar.

Jar file

There is one jar for each locale. The builder stores it in the install directory for the locale, in the chrome directory there. For example, it stores the English jar as:

base/calendarhelp/install/en-US/chrome/calendarhelp-en-US.jar

The jars are not stored in CVS. If you want to see a jar, either install Calendar Help or extract the jar from the XPI installer.

XPI installers

There is one XPI installer for each locale. Each installer works in all the base products:

The builder stores it in the install directory for the locale, adding the version string and the locale name to the file name. For example, it stores the English XPI for version 0.1 as:

base/calendarhelp/install/en-US/calendarhelp-0.1-en-US.xpi.

The XPIs are stored in CVS, but not in this directory. Instead, they are in the project's downloads directory. You cannot download them directly from this site. You can only download them from a mirror site.

What you need to build

It is likely that you do not need to build everything. You only need to build the parts that you are interested in, and that depend on source that has changed.

For example, if you are a writer or translator, then it is likely that you only need to test the changes that you have made.

If you build more parts than you really need, it does not do any harm. It only forces you to download more source files, and it makes the build process take longer.

What writers need to build

If you are a writer writing English help, then you can use the builder to test the changes you have made.

You only need to build the en-US locale.

You only need to build three of the indexes:

Note: If you are the writer assigned to the glossary, then of course you only need to build the glossary index and the main index.

You need to build the jar.

You do not need to build any installer. You can manually copy the jar, replacing your old version.

What translators need to build

If you are a translator, then you can use the builder to test your translation.

You only need to build the locale that you are working on.

You only need to build three of the indexes:

You need to build the jar.

You do not need to build any installer. You can manually copy the jar, replacing your old version.

Installing the builder

To install the builder:

  1. Download buildhelp.jar into Firefox's chrome directory.
  2. Close Firefox.
  3. In Firefox's chrome directory, delete the file chrome.rdf. (See step 5.)
  4. Edit the file installed-chrome.txt, and at the end add this line (by copying and pasting from here):
    content,install,url,jar:resource:/chrome/buildhelp.jar!/content/buildhelp/
    
  5. Restart Firefox. It automatically rebuilds chrome.rdf.
  6. Open the following URL and bookmark it:
    chrome://buildhelp/content
    

Running the builder

To run the builder, open its bookmarked URL. Specify:

Press the Go button. Look for error messages in the Status area.

Note: The builder is sensitive to tagging errors in source files, but it simply fails to process the files without specifying what is wrong. If this happens, check each source file by viewing it in a Mozilla browser. The browser identifies the errors.

Defaults and options

You can store some builder defaults in buildhelp.ini in Firefox's res directory. For example, the file can contain settings like these, corresponding to fields in the user interface:

proj.1=calendarhelp
proj.1.version=0.1
proj.1.base=F:\\Projects
proj.1.subdir=false

Some builder defaults and options are stored as user preferences. To change them, go to the URL about:config and filter on buildhelp.

The calendarhelp project can be contacted through the mailing list or the member list.
Copyright © 2000-2017. All rights reserved. Terms of Use & Privacy Policy.