summaryrefslogtreecommitdiff
path: root/README.md
blob: 6833fcdf8c24feb1af82fefbc07a0e5794e093c1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# flpsed


flpsed is a PostScript annotator. You can't actually 
edit existing PostScript documents, but you can add arbitrary text lines to
existing documents.
It is useful for filling in forms etc. 

## Quick Start:
- Open an existing PostScript document.
- Click anywhere on the document and type a text line.
- The frame around the text shows, which text line has the focus.
- Click on the lower left corner of a text line to focus it or use the 
  Tab-key to cycle through the text lines on the current page. 
- Remove text, by hitting BackSpace.
- Move text lines by dragging them with the mouse or using the arrow keys.
- Navigate within the document with the Page->Next or Page->First menu buttons.
- Save your document and preview it with ghostview or something similar.
- If you reopen the document with flpsed, you can edit the added text lines.

## Features:
- Add arbitrary text to existing PostScript documents.
- Reedit text, that has been added with flpsed.
- The overall structure of the PostScript document is not
  modified. flpsed only adds the additional text.
- Lines can be given names ("tags"). The text of these lines can
  be replaced in batch mode (no X11 required).
 
## Restrictions:
- flpsed probably does not work on all existing PostScript documents.
  You simply have to test it for your documents.
- Zooming depends on the availability of scalable fonts on your X11 system.
  Font sizes might be wrong with zoom values other than 100% if these are 
  missing.
- flpsed is alpha software, so please backup your files, before trying to 
  modify them.

## Building:
- flpsed only works on X11-based systems.
- You need to have ghostscript installed.
- You need to have fltk-1.3.x from www.fltk.org installed.
- Unpack the tarball and type "./configure", "make", and "make install".



## Tags and Batch Mode:

To use batch mode, add text lines to your PostScript document as usual. 
Give all or some of the lines tag names (Tags->Edit Tag). 
Save the document. Now you can replace the text of the tagged line in batch
mode using the -t flag (see usage).
Example:
Lets assume you have added text lines with tags "name", and "street"
to your document letter.ps with flpsed in interactive mode and saved the
result in letter-templ.ps.
You can now call flpsed in batch mode to set the actual values:

flpsed -b -t name="Hans Meier" -t street="Haupstr. 14" letter-templ.ps out.ps