How to install CBCoptic in Linux

Install LaTeX

We assume you have a working LaTeX-installation before installing the Coptic-package. If this is not the case, read how to install LaTeX on the page about installing HieroTeX.

Install CBCoptic

Download and unpack the CBCoptic-file:

wget ftp://cam.ctan.org/tex-archive/language/coptic/cbcoptic.zip
unzip cbcoptic.zip; rm cbcoptic.zip
cd cbcoptic


You have to copy all files to a directory where LaTeX can find these files. On Ubuntu and most other distributions, it would be this directory:

export TEXPATH="/usr/share/texmf"

On Arch Linux, it is:

export TEXPATH="/opt/texlive/texmf"


Note: you will need root privileges to install CJHebrew. You can switch to the root user in a terminal window by using the command "su". In Ubuntu and other distribution who use "sudo" instead of the root user, you have to add "sudo" before every command below. But it's easier if you switch to the root user, by using the command "sudo su" or "sudo bash".

Create the destination directories and copy all files to the right directory (LaTeX styles, macro's and fonts):

mkdir -p ${TEXPATH}/tex/latex/cbcoptic ${TEXPATH}/doc/latex/cbcoptic ${TEXPATH}/fonts/map/dvips/cbcoptic/
mkdir -p ${TEXPATH}/fonts/source/cbcoptic ${TEXPATH}/fonts/tfm/cbcoptic ${TEXPATH}/fonts/type1/cbcoptic
cp *.sty *.fd testcop.tex testcopOK.pdf ${TEXPATH}/tex/latex/cbcoptic/
cp coptfont.pdf README ${TEXPATH}/doc/latex/cbcoptic/
cp *.mf ${TEXPATH}/fonts/source/cbcoptic/
cp *.tfm ${TEXPATH}/fonts/tfm/cbcoptic/
cp *.pfb ${TEXPATH}/fonts/type1/cbcoptic/
texhash


Create a font-mapping file:

echo "copti TeX-copti <copti.pfb" > cbcoptic.map
echo "copto TeX-copto <copto.pfb" >> cbcoptic.map
cp cbcoptic.map ${TEXPATH}/fonts/map/dvips/cbcoptic/


On Debian-based distros, add the font-mapping files to updmap:

echo "Map cbcoptic.map" > 20local-cbcoptic.cfg
sudo cp 20local-cbcoptic.cfg /etc/texmf/updmap.d/


On other distros, you just need to add:

Map cbcoptic.map

to the file updmap.cfg, which can be found in:
- Slackware(-based distros): /usr/share/texmf/web2c/
- SUSE Linux: /etc/texmf/web2c/
- Arch Linux: /opt/texlive/texmf/web2c/

On Debian-based distros, run:

update-updmap; texhash; updmap-sys


On other distros, run:

updmap; texhash; updmap-sys

Install hyphenation patterns for the Coptic language

Copy the hyphenation patterns for Coptic and update LaTeX's database (this didn't work when we tried it):

cp copthyph.tex ${TEXPATH}/tex/generic/hyphen
"coptic copthyph.tex" > 20cbcoptic.cnf
cp 20cbcoptic.cnf /etc/texmf/language.d/
update-language

Check your installation

If you would like to test the package, you can do this before deleting all temporary files:

pdflatex testcop.tex


This should output a pdf-file testcop.pdf, with some nice Coptic sentences.

Remove temporary files

If the installation was succesful, you can delete the files you downloaded:

cd ../; rm -r cbcoptic/

CBCoptic documentation

The documentation (a readme-file) is copied to the location ${TEXPATH}/doc/latex/cbcoptic/. To view this file, you can use this command (e.g. in Ubuntu):

gedit /usr/share/texmf/doc/latex/cbcoptic/README

Troubleshooting

  • We've tested CBCoptic on a system which already had S. Rosmorduc's Coptic package installed. When we installed CBCoptic on a fresh system with only a basic LaTeX-installation, CBCoptic did not work. This problem was solved after installing S. Rosmorduc's Coptic package, so it seems you need Coptic + CBCoptic if you want to use CBCoptic.
  • If LaTeX gives you an error with "Permission denied" when you're using CBCoptic for the first time, enter the following command in a terminal window and rerun LaTeX: sudo chmod -R 755 $TEXPATH




Tested in:

  • Arch Linux (2007.08-2)
  • Debian (4.0r1)
  • Ubuntu (6.10)
  • Xubuntu (7.04)