hwriter (version 0.93)

openPage: HTML document/page management

Description

Opens and closes a HTML page/document, allowing a sequential building of an HTML page.

Usage

openPage(filename, dirname=NULL, title=filename, head=NULL)
closePage(page, splash=TRUE)

Arguments

filename

a character string containing the filename or the path of the HTML file to be created.

dirname

an optional character string containing the path of the directory where the file should be written.

title

an optional character string containing the title of the HTML page.

head

an optional character string containing an HTML fragment to be added in the section of the page.

page

a page handle returned by a previous openPage call.

splash

a logical, indicating whether the hwriter splash tag 'generated by...' should be written at the end of the page.

Value

• A connection which is a handle to the current HTML page.

Details

openPage opens a new file for writing and returns a page handle which is used by hwrite to append HTML elements in a current page. A previous existing file will be overwritten.

The argument head is useful to add CSS links or HTML script tags in the page header. Use hmakeTag to easily build HTML tags.

closePage ends the HTML page formatting, flushes the pending writing operations and closes the file.

See Also

hwrite, hmakeTag.

Examples

## Creates a new web page 'test.html' in the R temporary directory
tmpdir <- tempdir()
p <- openPage('test.html', dirname=tmpdir)
hwrite('Iris example', p, center=TRUE, heading=1)
hwrite(iris, p, row.bgcolor='#ffa')
closePage(p)

## Opens a web browser on the web page
if (interactive()) try(browseURL(file.path(tmpdir, 'test.html')))