File: BUILDING.md

package info (click to toggle)
libitext5-java 5.5.13.1-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 183,364 kB
  • sloc: xml: 255,662; java: 151,222; makefile: 7
file content (40 lines) | stat: -rw-r--r-- 1,323 bytes parent folder | download | duplicates (2)
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
To build iText, [Maven][1] must be installed.

Running install without a profile will generate the itextpdf jar:
```bash
$ mvn clean install -Dmaven.test.skip=true | tee mvn.log
```

When using the profile `all` also the source and javadoc jars will be generated:
```bash
$ mvn clean install -P all -Dmaven.test.skip=true | tee mvn.log
```

If you are in need of the Asian font jars, you can run one of the following commands:
```bash
$ mvn clean install -f itextpdf/itext-asian.pom | tee mvn.log
```

If you need the hyphenation jar, execute:
```bash
$ mvn clean install -f itextpdf/itext-hyph-xml.pom | tee mvn.log
```

To run the tests, [Ghostscript][2] and [Imagemagick][3] must be installed.
```bash
$ mvn clean install -Dmaven.test.failure.ignore=false -DgsExec=$(which gs) -DcompareExec=$(which compare) | tee mvn.log
```

You can use the `Vagrantfile` to get a [Vagrant][4] VM ([Ubuntu][5] 14.04 LTS - Trusty Tahr, with [VirtualBox][6]) with all the required software installed.
```bash
$ vagrant box add ubuntu/trusty64
$ vagrant up
$ vagrant ssh -- 'cd /vagrant ; mvn clean install -Dmaven.test.skip=true' | tee mvn.log
```

[1]: http://maven.apache.org/
[2]: http://www.ghostscript.com/
[3]: http://www.imagemagick.org/
[4]: https://www.vagrantup.com/
[5]: http://www.ubuntu.com/
[6]: https://www.virtualbox.org/