From 7f02ad93c789cb40b4cff5f183dca9e4d42cee67 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 30 May 2020 22:43:23 +0000 Subject: tex4ht doc regeneration, from tex4ht r713 git-svn-id: svn://tug.org/texlive/trunk@55350 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/tex4ht/mn37.html | 121 ++++++++++++------------- 1 file changed, 60 insertions(+), 61 deletions(-) (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn37.html') diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn37.html b/Master/texmf-dist/doc/generic/tex4ht/mn37.html index f32d5d31b92..4ba0896af8f 100644 --- a/Master/texmf-dist/doc/generic/tex4ht/mn37.html +++ b/Master/texmf-dist/doc/generic/tex4ht/mn37.html @@ -1,79 +1,78 @@ + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -driver +Compile - - + + - exit driver + href="mn31.html#mn37.html" >exit Compile

Driving the Translation of Pictures and Other Tasks

- TeX4ht outputs a script file (‘.lg’) describing how the dvi file (extension ‘.idv’) of pictures should -be processed, the CSS instructions to be included for the file, and user-initiated requests from the -operating system. In the default setting, the script file holds abstract commands similar to the following -ones. -
--- needs --- source.idv[i] ==> target.gif ---
-

An abstract command of this form requests that the i’th page in the dvi file will be translated into a target file -whose name is provided. -

-
--- characters ---
-

This abstract command is a identifies where the requests for pictorial characters start. + name="QQ1-37-76">Compiling tex4ht.c +

    +
  • You might want to activate some of the options at the start of the file by uncommenting the corresponding +lines. +
    /* **********************************************  +
        Compiler options                            *  +
        (uncommented | command line)                *  +
    ------------------------------------------------*  +
           Classic C (CC)             default  +
    #define ANSI                      ansi-c, c++  +
    #define DOS_C  +
    #define HAVE_STRING_H             <string.h>  +
    #define HAVE_DIRENT_H             <dirent.h>  +
    #define HAVE_SYS_NDIR_H           <sys/ndir.h>  +
    #define HAVE_SYS_DIR_H            <sys/dir.h>  +
    #define HAVE_NDIR_H               <dir.h>  +
    #define WIN32  +
    #define KPATHSEA  +
    #define BCC32                    bordland c++  +
      +
    *************************************************  +
    +

  • +
  • Values may be assigned in the command line or the beginning of the source file, to the environment variables +ENVFILE, HTFDIR, LGPIC, LGSEP, LGTYP, MAXFONTS, and TFMDIR. +

    For instance, +

    gcc -o tex4ht tex4ht.c -DENVFILE=’"path/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’ +-DHAVE_DIRENT_H

    -
-

A manual brute-force execution of the abstract commands can be a tedious job for large number of pictures. -The t4ht is in essence an interpreter for these abstract commands. -

Another possible approach for automating the process is to request lg scripts in the form of shell scripts or -batch files. -

Alternatives to ‘--- needs --- source.idv[i] ==> target.gif --- -

The default setting is made with a request of the form ‘--- needs --- %%1.idv[%%2] ==> %%3.gif ---’, -where the parameters %%1, %%2, and %%3 respectively represent the name of the source file without -its extension, a page number, and a name of the target file. Alternative patterns to these abstract -commands can be requested in the following locations, with the order reflecting on the priority given to the -requests. -

-

- The character ‘%’ can be introduced into a pattern through the entry ‘%%%’. On the other hand, the -parameters ‘%%1’, ‘%%2’, and %%3 can specify, between the first two percentage characters (i.e., ‘%...%1’, -‘%...%2’, and ‘%...%3’), any format for the outcome that is compatible with the print formats of -C. -

Alternatives to ‘--- characters --- -

Substitutions for this abstract command can be requested in the following locations. -

-

+

The switch ‘-DENVFILE’ is optional, if the program can reach the environment file in an alternative +manner. +

+

Compiling t4ht.c

+ The environment variable ENVFILE is available also in ‘t4ht.c’. +

For instance, +

gcc -o t4ht t4ht.c -DENVFILE=’"gold/tex4ht.dir/texmf/tex4ht/base/unix/tex4ht.env"’ +

-- cgit v1.2.3