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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
GladTeX
=======
GladTeX is a preprocessor that enables the use of LaTeX formulas within HTML
files. The formulas, embedded in <eq>...</eq> tags, as if within $$..$$ in LaTeX,
is fed through latex and replaced by images.
Additionally all images get an alt-tag for alternative texts that contains the
LaTeX-equivalent of the image. This is handy for text-mode browsers or blind
screen reader users.
This is a complete rewrite of the old GladTeX which was implemented in Perl and
in C. The old version was not easily portable across platforms. The
new version is purely implemented in Python, gets rid of the Ghostscript
dependency and additionally offers the GladTeX functionality in a Python module
called gleetex. to be embedded in other applications.
Features
--------
- both program and library: GladTeX and GleeTeX (both Python)
- easy-to-adjust font size of formulas through command-line switch
- customisation of commands using a custom LaTeX preamble
- automated replacement of non-ascii characters through LaTeX control
sequences
- usage as Pandoc filter for export in HTML-based formats as for instance Epub
License
-------
- (C) 1999-2010 Martin G. Gulbrandsen
- (C) 2011-2013 Jonathan Daugherty (especially release 1.3)
- (C) 2013-2018 Sebastian Humenda
This program is distributed under the LGPL-3, or at your option, any later
version of the license; for details see the accompanying file COPYING.
The official project homepage is at <http://humenda.github.io/GladTeX>
Installation
============
### Debian/Ubuntu
On all derivatives of Debian (as Ubuntu/Mint, etc.), installing GladTeX is as
easy as
# apt-get install gladtex
### Windows
If you want to use the program without the Python library, you should download a
pre-compiled binary from <https://github.com/humenda/GladTeX/releases>.
Just unzip the archive and move the files to a directory within `%PATH%`.
### From Source
The following is required for installing GladTeX:
- Python >= 3.4
- LaTeX (2e), dvipng
- the LaTeX package preview.sty
#### Debian / Ubuntu
On Debian/Ubuntu systems the following commands will satisfy the dependencies:
# apt-get install python3-all texlive-fonts-recommended texlive-latex-recommended preview-latex-style dvipng
The package can then be installed using
# python3 setup.py install
Note: If your system ships `python` as the command for Python3 you have to use
`python in` the above command instead.
#### OS X
You need to install a LaTeX distribution on your Mac. GladTeX was successfully
run with [MacTex](http://www.tug.org/mactex/).
You can download a zip source archive from
[GitHub](https://github.com/humenda/GladTeX) or use git:
$ git clone https://github.com/humenda/GladTeX.git
Use `cd` to change to the GladTeX source directory and issue
$ python setup.py install
### Compilation On Windows
To compile GladTeX on Windows, yu need a Python3 installation. Assumed is
python3.4, newer versions should work fine as well. Only the paths need to be
adjusted
Install py2exe:
c:\python34\scripts\pip.exe install py2exe
Given that GladTeX is located in c:\users\user\gladtex:
cd c:\users\user\gladtex
c:\python34\python.exe setup.py install
That will install GladTeX as a library to `c:\python34\lib` and the script to
`c:\python34\scripts`. It also allows py2exe to find the gleetex module. Now the
executable can be build:
c:\python34\scripts\build_exe.exe -b 0 -c gladtex.py
That'll create a `dist/` folder containing the executable. If you have other
python applications in your project it is useful to read about the `-b` switch
to share some python components included in the just-built executable.
Documentation
-------------
Please use `man gladtex` for further instructions or have a look at the file
[manpage.md](manpage.md).
|
