Appendix C: Text Editors That Understand Mason
However, an editor that helps you manage the details of the document you're creating can be a nice mini-luxury. Several different editors can easily be trained to understand the structure of Mason components, with varying degrees of assistance (or interference, depending on how much help you're looking for). In most cases, this is due to the work of Mason developers who created syntax definitions and offered them to the general public. If you find shortcomings, the polite thing to do is to drop a note to the developer, offering a fix if possible.
Both authors of this book are enthusiastic users of Emacs and its wonderful cperl-mode for editing plain Perl code, courtesy of Ilya Zakharevich. However, while one can just turn cperl-mode on for an entire Mason component and get some basic syntax highlighting, brace matching, and indentation, the result is necessarily clumsy, since large parts of the component aren't Perl code.
Note that since this is a book on Mason and not a book on Emacs and Lisp, we're just going to give you installation and configuration instructions as if they were magical incantations. If you know alternate ways to achieve the same ends, you'll probably be fine using them.
To use mmm-mode's mason-mode, you'll need to download mmm-mode from http://mmm-mode.sourceforge.net/ and install the .el files as described in the README file.1 Create a file called .emacs in your home directory if it doesn't already exist, and add the statement
(require 'mmm-auto) to it. Then you can manually invoke mason-mode while editing a component by
first turning on html-mode (type
html-mode and press Return) for the outer region, then turning on mason-mode for the
Mason sections (type
mmm-ify-by-class, press Return, type
mason, and press Return). mmm-mode will then scan your component to figure out which
sections are which, turning on cperl-mode in the sections that contain Perl
If you want mason-mode to start up automatically whenever you edit files with a
certain suffix, say .mas, you can add a few lines to your .emacs file after the
'mmm-auto) line, as in Example C-1.
(require 'mmm-auto) (setq mmm-global-mode 'maybe) (add-to-list 'auto-mode-alist '("\\.mas\\'" . html-mode)) (mmm-add-mode-ext-class 'html-mode "\\.mas\\'" 'mason)
Alternately, if you'd like to enable mmm-mode for all HTML files in a certain directory, you could use the code in Example C-2.
(require 'mmm-auto) (setq mmm-global-mode 'maybe) (add-to-list 'auto-mode-alist '("/usr/local/apache/htdocs" . sgml-mode)) (mmm-add-mode-ext-class 'sgml-mode "/usr/local/apache/htdocs" 'mason)
As of this writing, mmm-mode doesn't scan your Mason component continually,
so if you type
<& &> in your component, the inside of that tag won't be treated as a cperl-mode
region until you rescan the file. You can rescan by typing
Control-b. If you know of a way to automatically keep the regions current while typing,
be sure to drop a line to Michael. His email address is in the mmm-mode README file.
You can download Emacs from several different places on the Internet, but the original distribution is available at http://www.gnu.org/software/emacs/. Precompiled binaries for your system may also be available from other sources, greatly simplifying the installation process if you're not using Unix.
Not to be outdone in the so-called editor wars, Vim has some pretty slick Mason syntax highlighting of its own. Vim is a widely used variant of the standard Unix editor vi. Vim stands for "vi improved," and syntax highlighting is one of several major improvements offered by Vim.
The Mason syntax module is part of the standard distribution of Vim, so if you
have a fairly modern version of Vim (Version 6.0 or later should be fine), you
should already have all the necessary files. To invoke Mason highlighting while
you're editing a Mason component, you can enter the command
:set syntax=mason. This will turn on Perl syntax for the Perl portions of the component and HTML
syntax for the other parts.
If you want Mason syntax highlighting to start automatically when you edit
Mason components, you have a few options. First, Vim will automatically turn on
Mason highlighting when you begin editing a file that starts with the string
<%args>. This is nice, because it both simplifies configuration and encourages you to
standardize the structure of your components.
Another alternative is to configure Vim to invoke Mason highlighting when you begin editing files ending with a certain suffix like .mas. To do this, you can add the following directives to your own .vimrc file (usually located in your home directory):
au syntax mason so /usr/local/share/vim/vim60ax/syntax/mason.vim au BufNewFile,BufRead *.mas set ft=mason
Alternatively, you could edit Vim's filetype.vim file (usually located in /usr/local/vim60/share/vim/vim60/, though it depends on where Vim is installed on your system) to contain the following line:
au BufNewFile,BufRead *.mas setf mason
For more information on Vim configuration, consult the thorough Vim documentation. If you add something significant to the Vim Mason support, be sure to contact the maintainer of the Mason syntax file to see whether he'd be interested in integrating your changes into the main distribution.3
1. Debian users can find an mmm-mode package in Woody and Sid. -- Return.
2. If you don't know what the Meta key is, you can probably use your keyboard's Escape key instead. -- Return.