Instalação de programas ABC em GNU/Linux

• 1. Pré-requisitos
• 2. Obtenção dos programas ABC
• 2.1. abcm2ps
• 2.2. abcMIDI e runabc
• 3. Instalação dos programas ABC
• 3.1. Instalação de abcm2ps
• 3.2. Instalação de abcMIDI
• 3.3. Instalação de runabc
• 4. Configuração de runabc
• 5. Testando a instalação e a configuração

A instalação dos programas ABC é, por assim dizer, realizada `manualmente'. Como se trata de vários programas de origens diferentes mas que devem trabalhar em conjunto, o procedimento tem várias etapas.

Aqui é apresentado um procedimento de instalação dos programas necessários para editar arquivos ABC, para gerar e visualizar partituras em formato PostScript e para gerar arquivos MIDI.

Os programas serão instalados no diretório /usr/local/bin e no diretório de usuário ~/abc. Páginas de manual de abcMIDI serão instaladas em /usr/share/man/man1. Alguns arquivos usados por abcm2ps serão instalados em /usr/local/share/abcm2ps.

1. Pré-requisitos

Para instalar e utilizar os programas é necessário ter:

• um compilador C, preferencialmente o gcc (GNU C Compiler), que normalmente é parte integrante das distribuições de sistemas GNU/Linux. Algumas distribuições live-CD (tais como Kurumin) talvez possam não conter o gcc. Ele pode ser obtido em:

http://gcc.gnu.org

• um programa para execução de arquivos MIDI. Sugestão: TiMidity++. Ele é executado com o comando

timidity

Se necessário, você pode obtê-lo em:

http://timidity.sourceforge.net

• os programas GhostScript e GhostView. Eles normalmente fazem parte das distribuições GNU/Linux. GhostScript é executado com o comando gs, enquanto GhostView pode ser qualquer um dos programas gv, ggv ou kghostview. Se necessário, aqui está o link para obtenção desses programas:

http://www.cs.wisc.edu/%7Eghost/index.html

• a dupla de pacotes tcl/tk (versão 8.4). Para saber a versão instalada em seu sistema, execute o comando:

tclsh

e então:

info tclversion

(Para sair do programa, digite exit). Se o número mostrado for menor que 8.4, você deve instalar uma nova versão de tcl/tk disponível em:

http://tcl.sourceforge.net

http://www.tcl.tk

2. Obtenção dos programas ABC

Obtenha os códigos-fonte dos programas ABC:

2.1. abcm2ps

http://moinejf.free.fr

Pegue:

abcm2ps-4.8.10.tar.gz

OBS.: A versão pode ser diferente.

2.2. abcMIDI e runabc

http://ifdo.pugmarks.com/%7Eseymour/runabc/top.html

Pegue:

abcMIDI-2005-02-05.zip
runabc.zip

OBS.: A versão/data pode ser diferente.

3. Instalação dos programas ABC

3.1. Instalação de abcm2ps

1. Crie um diretório para os arquivos ABC, sugestão: ~/abc; (Isso pode ser feito com o comando mkdir ~/abc);
2. Copie abcm2ps-4.8.10.tar.gz para lá (cp abcm2ps-4.8.10 ~/abc);
3. Mude para o novo diretório (cd ~/abc);
4. Descomprima o arquivo (tar zxvf abcm2ps-4.8.10.tar.gz);
5. Mude para o diretório do programa (cd abcm2ps-4.8.10);
6. Execute ./configure --enable-a4;
7. Execute make;
8. Execute su -c "make install". A senha de root será pedida.

3.2. Instalação de abcMIDI

1. Copie abcMIDI-2005-02-05.zip para ~/abc e mude para esse diretório;
2. Descomprima o arquivo: unzip abcMIDI-2005-02-05.zip;
3. Copie esse texto para um arquivo (chamado, p.ex.: instala.sh):

#!/bin/bash
set LOCAL=/usr/local/bin/
cd abcmidi
cp makefiles/unix.mak ./makefile
make
cp abc2abc $LOCAL
cp abc2midi $LOCAL
cp yaps $LOCAL
cp mftext $LOCAL
cp midicopy $LOCAL
cp midi2abc $LOCAL
cp abcmatch $LOCAL
cd doc
cp *.1 /usr/share/man/man1

4. Execute o arquivo, com o comando su -c ". instala.sh". Isso irá compilar e instalar os programas. Esse mesmo script poderá ser usado em atualizações futuras de abcMIDI.

3.3. Instalação de runabc

1. Copie o arquivo runabc.zip para ~/abc;
2. Descompacte-o: unzip runabc.zip;
3. Mude para a pasta runabc;
4. Faça um cópia de runabc.tcl sem a extensão: cp runabc.tcl runabc;
5. Torne-a executável: chmod +x runabc;
6. Copie runabc para /usr/local/bin, com o comando: su -c "cp runabc /usr/local/bin";
7. Adicione esta linha a seu arquivo ~/.bashrc:

export RUNABCPATH=~/abc/runabc/

4. Configuração de runabc

1. Execute runabc;
2. Clique em abc2ps, então em psconverter. Clique em abcm2ps;
3. Clique em config e então em player 1; Selecione o caminho para o programa de tocar arquivos MIDI;
4. Clique em config e então em abc executables;
5. Clique nos botões seguintes e selecione os diretórios correspondentes a cada programa:

abcmidi folder

~/abc/abcmidi

abcm2ps

/usr/local/bin/abcm2ps

ghostsview

gv

(Ou ggv, ou kghostview, o de sua escolha)

editor

Selecione o editor de texto para os arquivos ABC. Por exemplo:

gvim

(Ou emacs, ou jed, etc.)

5. Testando a instalação e a configuração

1. Execute o programa runabc;
2. Clique em file;
3. Clique em browse. Navegue até o arquivo: ~/abc/abcm2ps-4.8.10/newfeatures.abc (lembre-se de que o número da versão pode ser diferente);
4. Clique em toc. Você deverá ver uma lista de títulos de músicas. Se isso não ocorrer, clique novamente em toc;
5. Clique em Scotland The Brave;
6. Clique em display. Você deverá ver a partitura. Senão, reconfigure o caminho para gv (config | ghostview) e tente novamente;
7. Clique em play. A música deverá ser tocada no tocador de arquivos MIDI que você selecionou. Senão, reconfigure o caminho e as opções para o player 1 (config | player 1) e tente novamente.

This document was generated using AFT v5.095