Next: Tag definition   Previous: Tag option conventions   Contents: Contents

Writing a tag module

Now when your tags are designed, you need to define them by a module in the PerlPoint::Tags namespace and make it a subclass of PerlPoint::Tags:


  # declare a tag declaration package
  package PerlPoint::Tags::New;

  # declare base "class"
  use base qw(PerlPoint::Tags);

The base module PerlPoint::Tags contains a special import() method which arranges that the parser learns new tag definitions when a tag module is loaded by use. PerlPoint::Tags is provided as part of the converter framework PerlPoint::Package.

It is recommended to have a "top level" tag declaration module for each PerlPoint converter, so there could be a PerlPoint::Tags::HTML, a PerlPoint::Tags::Latex, PerlPoint::Tags::SDF, a PerlPoint::Tags::XML and so on. (These modules of course may simply invoke lower level declarations if appropriate.)

To complete the intro, configure variable handling:


  # pragmata
  use strict;
  use vars qw(%tags %sets);

%tags and %sets are important variables used by convention. They will be explained in the next sections.

Next: Tag definition   Previous: Tag option conventions   Contents: Contents