Installing FarsiTeX 1.0pre1 under teTeX/Unix/Linux/...
So you read the manual and release notes, and want to give it a shot on Linux, eh?
Ok, here are the instructions, but, if you have any problems following them,
please do not contact me. Chances are high that I don't know what is wrong
on your system.
Feel free to write to the farsitex-user
Make sure you read this page to the end before starting your install.
These have been tested on Fedora Core 6. They should work on Ubuntu and other
modern systems. Make sure you have teTeX and WINE installed before continuing.
Installing the Engine
Grab and unpack the tarball
(16M) into your home directory (It will create
~/texmf, if it doesn't
tar jxf farsitex-1.0pre1.tar.bz2
Copy or symlink these files into PATH, eg. in
(You may need to rebuild the first two for your architecture. Just change to
their directory and run
make clean all):
mkdir -p ~/bin
ln -f -s ~/texmf/source/farsitex/ftx2tex/ftx2tex ~/bin
ln -f -s ~/texmf/source/farsitex/fmakeidx/fmakeidx ~/bin
ln -f -s ~/texmf/scripts/farsitex/bin/* ~/bin
farsitex.map file into its new location under teTeX 3.0.
After this, it should work with all versions of teTeX (you may get some
warnings. Just ignore them.):
mkdir -p ~/texmf/fonts/map/dvips
cp -r ~/texmf/dvips/farsitex ~/texmf/fonts/map/dvips/
Recent versions of teTeX use pdfeTeX as their default TeX engine, and FarsiTeX
detects that and enables PDF output. To fix this we need to shuffle some bits around.
In short, duplicate
farsitex.ini so we can modify it for DVI output but
not PDF; turn PDF off, by removing the first line of
and create a new
fmtutil.cnf to use the new fadvitex.ini file:
tail -n +2 ~/texmf/tex/farsitex/config/farsitex.ini > ~/texmf/tex/farsitex/config/fadvitex.ini
echo "farsitex etex - *fadvitex.ini" > ~/texmf/tetex/fmtutil.cnf
echo "fapdftex pdfetex - *farsitex.ini" >> ~/texmf/tetex/fmtutil.cnf
Now, update teTeX's file database by running:
Build the formats:
fmtutil --cnffile ~/texmf/tetex/fmtutil.cnf --byfmt farsitex
fmtutil --cnffile ~/texmf/tetex/fmtutil.cnf --byfmt fapdftex
Enable the font mappings:
updmap --enable MixedMap=farsitex.map
That's it. Test your brand new FarsiTeX installation:
# convert FTX to TEX
# create DVI
# create PDF
If everything went as expected, these should create
demonstrating various new features of FarsiTeX, and its PDF version
shiny embedded vector fonts.
features in this FarsiTeX version.
You can use the
ftex script that calls both of
farsitex for you, but note that its
is not implemented and does not work, so you cannot create PDF using the
ftexed editor can be run under WINE.
With older versions of WINE, you needed to install this farsitex.bdf font and tweak
your WINE configuration to make sure it finds and uses it. It was not easy
The good news is, with recent versions of WINE (eg. 0.9.27), it uses the
Windows font installed by the installer and it all Just Works.
Start by downloading and installing the
Windows installer (644K) (Select Next in every step, and finally Finish):
We need to update the font editor uses to one that reflects changes in
farsitex-1.0pre1. This is only necessary if you didn't have to get the
farsitex.bdf font working. This step depends a bit on your
WINE configuration. Move the font manually if it doesn't work.
mv farsitex.fon ~/.wine/*/[Ww]indows/[Ff]onts/
rm -f ~/.wine/*/[Ww]indows/[Ff]onts/FarsiTeX.fon
Create a shell script named
ftexed to launch it.
We need to find where the installer placed
Ftexed.exe, and run it
under WINE. This depends on your WINE configuration. Tweak if this doesn't
echo "wine ~/.wine/*/Program\ Files/MikTeX/miktex/bin/Ftexed.exe" > ~/bin/ftexed
chmod a+x ~/bin/ftexed
That's almost it! You should even find a launch icon on your desktop.
The items in the Run menu don't work yet. Use command-line tools instead.
Making the Run menu launchers work needs some more involved magic.
So I'll don't write it down here. Just grab the script and let it do.
The ftex-to-unicode item still doesn't work as the converter doesn't
quite exist, but the rest should work nicely. Uses xdvi to view DVI:
All in One
The instructions above can also be all run using this shell
If you have already downloaded the tarball, download and tweak the script to
suite your situation.
The editor installer does not start, errs about visuals and libGL
I've seen this on a AIGLX-enabled X with intel graphics card.
Try turning AIGLX off. Probably a driver issue.
Something else doesn't work
Try figuring out what failed. If you can't, you probably shouldn't be running
FarsiTeX on Linux. Anyway, please DON'T MAIL ME. Write to the farsitex-user
May 15, 2007
- Added editor Run menu launcher setup script.
- Initial write-up.