Node:chap 12, Next:, Previous:chap 11, Up:Top



How to install

Sgmltexi is made of two Perl executables: sgmltexi and sgmltexi-sp2texi. These files can be placed everywhere they can run without giving the path; that is: inside a directory listed by the environment variable PATH.

It is needed Perl as /usr/bin/perl. If your system is organized differently, you should modify the first line of these executables:

     #!/usr/bin/perl
     #...
     

Sgmltexi expect to find some files:

/usr/share/sgmltexi/sgmltexi.cat
the Sgmltexi SGML catalog;
/usr/share/sgmltexi/sgmltexi.dcl
the Sgmltexi SGML declaration;
/usr/share/sgmltexi/sgmltexi.dtd
the Sgmltexi DTD;
/usr/share/sgmltexi/entities/
the directory containing the standard ISO 8879 entity files.

All these files may be exactly where expected or there may be symbolic links to recreate the expected files.

Gettext

The messages that Sgmltexi shows may be translated. To install the already translated PO files, it is necessary to compile them like this:

     msgfmt -o sgmltexi.mo it.po
     

In this example the file it.po is compiled and it is generated the file sgmltexi.mo. This generated file must be copied inside the right directory; in this case, may be /usr/share/locale/it/LC_MESSAGES/.

If you don't have installed the Perl-gettext module and you don't want to worry about it, you can comment the following instructions:

     # We *don't* want to use gettext.
     #use POSIX;
     #use Locale::gettext;
     #setlocale (LC_MESSAGES, "");
     #textdomain ("sgmltexi");
     

Then you have to introduce a dummy gettext() function:

     sub gettext
     {
         return $_[0];
     }