Text Converter putrans

List of Supported Formats

The text converter putrans transforms documents from one text processing format into another, while maintaining most formatting attributes. The full version currently converts between the following formats:

Installation

The software is installed by a simple copy from the distribution diskette to an empty directory on your harddisk. For MS-DOS this may (for example) be accomplished by the commands:

      c:
      mkdir \putrans
      cd \putrans
      copy a:*.*

For Unix you use a command like:

      tar xvf /dev/rfd0

The device name of the floppy disk drive may be different on your system. After copying you should make the program executable for Unix:

      chmod 111 putrans

and its directory should be a member of $PATH.

The sample files *.hit on the distribution diskette were transformed by putrans in *.dca. For a test of the installation you can repeat the conversion and compare the the results:

      putrans -hit -rtf gourmet.hit gourmet.rt2
      fc/b gourmet.rtf gourmet.rt2     (MS-DOS)
      cmp -l gourmet.rtf gourmet.rt2   (Unix)

Activation

The converter is activated with the following command:

    putrans  [-sourceformat [-targetformat]] [inputfile [outputfile]]
              -ascii         -ascii           CON/stdin  CON/stdout

The specifications in square brackets may be left out. In this case, the defaults of the 2nd line apply. The target format may also be specified behind the input file.

Die Formatkennungen werden mit einem Bindestrich angegeben und können abgekürzt werden, solange sie eindeutig bleiben, z.B. The format codes are specified with an initial hyphen, they may be abbreviated as long as they remain unique, for example -dca for DCA-RFT. The filenames may have a drive and/or path specification. Format codes and filenames can be written in any order as long as input specifications preceede output specifications.

Under Unix you have to write normal slashes '/' instead of the backslashes '\' in the following examples.

For the conversion of a Hit file into ASCII (PC character set) you call:

      putrans -hit bilanz bilanz.asc

From Uniplex to Hit you may use:

      putrans -uni -hit \usr\gfi\texts\manual.doc \usr\tmp\manual.hit

You may want to convert all Hit documents in a directory to RTF for MS-Word. On the MS-DOS prompt you write:

      mkdir temp
      for %x in (*.hit) do \putrans\putrans -hit -rtf %x temp\%x > nul
      ren temp\*.hit *.rtf

The title message of the program is suppressed in this case. Please note that you have to duplicate all % characters in the FOR command if you include the FOR command in a BATch file!

The activation for a CLOU conversion has a slightly different form:

      putrans -hit baustein.hit -wbasic makro.wba -clou -clou=2

A series of generated WordBasic files may be loaded automatically into the current template (NORMAL.DOT) by a macro which is included in the distribution.

Integration with Word For Windows

In the full version the converter may be installed in the converter menue of MS-Word. Only a single format is supported by a converter DLL in this case. After the installation you may open a foreign format document in MS-Word. The conversion will take place in the background without user interaction, and the converted text will be placed in the editing window. Likewise you may store the document in the foreign format with the "Save as, Options" menues. Please perform the following steps:

1. Copy 3 files:

   copy a:putrans.dll c:\MS-Word
   copy a:putrans.par c:\windows
   copy a:putrans.msg c:\windows

   
   Please note that you may have to specifiy different paths for the MS-Word resp. Windows directory on your computer.

2. Switch to the Windows installation directory, and add a line to the file WIN.INI (until MS-Word V2.0) or MS-Word6.INI (for V6.0):

   cd \windows
   edit win.ini resp.
   edit MS-Word6.ini

3. The modification differs for MS-Word V1.1, MS-Word V2.0/V6.0. Starting with V2.0 you have to add the following line to the section [MSWord Text Converters]:

   Hit V4.0=Hit V4.0, C:\MS-Word\PUTRANS.DLL, hit

   
   or

   TEX-ASS=TEX-ASS, C:\MS-Word\ptdatex.dll, tat

   
   You specify the code for the foreign text processing system, our converter DLL and the file extension which shall lead to the activation of the converter.

   Until V1.1 you specifiy the new converter in the section [Microsoft Word], and you have to correct the numbering:

   [Microsoft Word]
   CONVNUM=2 <--- current number of converters
   CONV1="Microsoft Word (DOS)" C:\MS-Word\CONV-WRD.DLL ^.DOC
   CONV2="Hit V4.0" C:\MS-Word\PUTRANS.DLL ^.HIT
   Conversion=Yes

   
   You may have to adapt the path for MS-Word again.

4. For MS-Word 7.0 and upwards under Windows 95 resp. Windows NT we deliver a special Setup program which installs all files automatically, and which edits the neccessary IMPORT and EXPORT entries in the registry.

Parameter File

The converter can be parameterized for special purposes in a number of ways. The parameters are written one per line in the parameter file putrans.par. Alternatively or in addition you may specify parameters in the form "-name=value" on the command line.

Numerical parameters normally have 0 as default, while string parameters default to the empty string.

The following table lists all possible parameters. The last column indicates for which formats the parameter takes effect. (A = AS/400, H = Hit, T = TEX-ASS).                                                                               

name	value	description	format(s)
fehl	=0 =1	no error message when .TAF file is missing print error message when .TAF file is missing	T
komm	=0 =1	suppress functions which are not converted generate comments for functions which are not converted	T
lnum1 lnum2 ... lnum9	=n1 =n2 =... =n9	starting values for running numbering	T
text1 ... text4	=text ... =text	text parameters	T
form	=name	name of the format file	T
ersatz	=pfad	search .TAF in this directory	T
breite	=mm	paper width in mm, default 210	H,T
n1 n2 n3	=old1#new1 =old2#new2 =...	translation of 1st field name translation of 2nd field name ...	T
feld	=0 =1	remove field definitions take DATEV TEXT field names	H,T
font0 font1 font2 font3	=name =name =name =name	mappping of fonts	H,T
fs0 fs1 fs2 fs3	=10,8,7 =11,9,8 =12,10,9 =12,10,9	font sizes for 10,12,15 cpi for font 0 same for font 1 same for font 2 same for font 3	H,T
bau	=0 =1	generate reference to include file insert contents of include file	A,T
box	=0 =1 =2	replace box characters by spaces replace box characters by + - | generate box characters for font "MS LineDraw"	T
ref	=0 =1 =2	field references without "REF" field references with "REF" field references without "MERGEFIELD"	T
stop	=0 =1	replace stop codes by bookmarks replace stop codes by empty bookmarks	H,T
vorz	=text	prefix for numerical field names, default 'U'	T
zeile	=0 =1	floating text generate hard line ends	A
align	=0	ignore alignment in Hit ruler lines, default: 1 = do not ignore	H
datum	=dd.MM.yyyy	format for print date	H
clou	=0 =1 =2	ignore CLOU commands convert CLOU commands to hidden text convert CLOU commands in WordBasic	H
fonts	=C10,C12,LP	mapping between Hit fonts and RTF fonts (1st font <-> RTF font 1, 2nd <-> RTF font 2 etc.)	H
hitmark	=32000	max. number of Hit markup lines to be output	H
hitlin	=32000	max. number of Hit ruler lines to be output	H
hnzeil	=0 =1 =2	floating text instead of Hit line endings hard newlines instead of Hit line endings paragraphs instead of Hit line endings	H
tabex	=0 =1	do not expand tab codes expand tab codes to spaces	H
warn	=10	width of the warning zone at right margin	H

Error Message File

      p u n c t m P U N C T M 0 2 9