Linux Certif

Toute la documentation sur la certification Linux LPI

hxincl

NAME

hxincl - expand included HTML or XML files

SYNOPSIS

hxincl [ -x ] [ -f ] [ -b base ] [ file-or-URL ]

DESCRIPTION

The hxincl command copies an HTML or XML file to standard output, looking for comments with a certain structure. Such a comment is replaced by the file whose name is given as the attribute of the directive. For example:

 ...<!-- include "foo.html" -->...
 
 

will be replaced by the content of the file foo.html. It is important to note that you must quote filenames if they contain white space.

The comment is replaced by

 <!-- begin-include "foo.html" -->
 
 

before the included text and

 <!-- end-include "foo.html" -->
 
 

after it. These comments make it possible to run hxincl on the resulting file again to update the inclusions.

OPTIONS

The following options are supported:

-x

Use XML conventions: empty elements are written with a slash at the end: <IMG />.

-b base

Sets the base URL for resolving relative URLs. By default the file given as argument is the base URL.

-f

Removes the comments after including the files. This means hxincl connot be run on the resulting file later to update the inclusions. (Mnemonic: final or frozen.)

OPERANDS

The following operand is supported:

file-or-URL

The name of an HTML or XML file or the URL of one. If absent, standard input is read instead.

DIAGNOSTICS

The following exit values are returned:

0

Successful completion.

> 0

An error occurred in the parsing of one of the HTML or XML files.

SEE ALSO

asc2xml(1), hxnormalize(1), hxnum(1), hxprune(1), hxtoc(1), hxunent(1), xml2asc(1), UTF-8 (RFC 2279)

BUGS

Assumes UTF-8 as input. Doesn't expand character entities. Instead pipe the input through hxunent(1) and asc2xml(1) to convert it to UTF-8.