Making Your Stata Program Ready for stata2htm

These notes show how to make your Stata program ready for running through the tool stata2htm that ATS has developed to make it easy to convert a SAS program into a web page.  We assume you have downloaded stata2htm.

It is probably easiest to show how to prepare your program by using an example.  This is the program sample.do that creates sample.log .

Sample Program

set more off
capture log close
log using sample.log , replace

*T Page Title 

*H Heading for First Section 

* This module will show how to read a small
* raw data file within a Stata program.
* Consider the sample program below. 

clear
input str3 make mpg rep78 weight foreign 
AMC 22 3 2930 0
AMC 17 3 3350 0
AMC 22 . 2640 0
end

* We can use the list command to see that the data was 
* read properly.
list

*H Heading for Second Section 

* Now that we have read the data, let's do some
* summary statistics.
summarize

* and lets tabulate mpg
tab mpg

log close

Web page created from sample progrm

The program sample.do is run in Stata by typing

do sample

and this creates sample.log.  You can then run, from the Command Prompt

stata2htm sample 

creating the web page sample.htm .

Explanation of sample program

• set more off
  capture log close
  log using sample.log , replace
  
  This is a standard header you would want at the top of any program you would run through stata2htm. This section tells Stata that we want to save the results to sample.log.  The set more off tells Stata to run the whole program without stopping.  The capture log close tells Stata to close the log, and to continue even if the log was already closed.  Finally, the log using sample.log, replace tells Stata to store the results in sample.log and to overwrite it if it already exists.  
  
• The tag *T is used to create a title for the web page.  This tag is optional.
• The tag *H is used to create headers for the web page.  The headers are used not only to create headings for each section, but also create a hyperlinked table of contents for the page, useful for navigating longer pages. The *H tags are optional.

• log close is the final command in the page.  This closes the log (sample.log) .  You want this command at the end of any Stata .do file you would run through stata2htm.