Hudson Lacerda (2004)
@@		Para acessar o tpico LEIA-ME, digite:
@@		? LEIA-ME
@@
@@		ou
@@
@@		a LEIA-ME
@@		e pressione a tecla <Enter>.
@@
@@
@@LEIA-ME
$
abcAJUDA (Hudson Lacerda/2004)

O objetivo deste programa  servir de referncia para a linguagem abc,
o programa abcm2ps e os comandos bsicos da linguagem PostScript.

A documentao  dividida em diversos arquivos, cada um dos quais
contm vrios tpicos.

Para ver os tpicos disponveis em um arquivo, digite:
	?
Para consultar um tpico, use um comando da forma:
	? <nome do tpico>

Para acessar um outro arquivo, use o comando "arq".
Por exemplo, para acessar o arquivo "ps.txt", use o comando:
	arq ps.txt
Para retornar ao arquivo principal (abcAJUDA.txt), digite:
	arq

SAIBA OS ARQUIVOS DE DOCUMENTAO DISPONVEIS COM UM DOS COMANDOS:
	ls
	? DOC
$


@@DOC
$
Os arquivos de documentao disponveis neste programa so:

abcAJUDA.txt		[O arquivo atual]
abc.txt			Sobre a linguagem abc
ps.txt			Elementos bsicos da linguagem PostScript

DIRETRIO abcm2ps - Sobre o programa abcm2ps
abcm2ps/LEIAME.txt	LEIAME de abcm2ps
abcm2ps/INSTALA.txt	Como instalar abcm2ps
abcm2ps/caracter.txt	Caractersticas de abcm2ps
abcm2ps/formato.txt	Parmetros de formato de abcm2ps
abcm2ps/opcoes.txt	Opes de linha de comando de abcm2ps
abcm2ps/syms.txt	Operadores PostScript gerados por abcm2ps

Para acessar um arquivo, use um comando da forma:

	arq <nome do arquivo>

Por exemplo, para acessar o arquivo abcm2ps/formato.txt, digite:

	arq abcm2ps/formato.txt
$
@@
@@
@@abc
$
abc  uma linguagem computacional para representao de msica.

Eis algumas das finalidades dos diversos programas que
interpretam arquivos abc:

  - Gerao de cdigo em outras linguagens (como MusixTeX ou Lilypond)
  - Gerao de partituras (geralmente em formato PostScript)
  - Gerao de arquivos MIDI
  - Execuo (atravs do sistema de som ou alto-falante do computador)

A linguagem abc  descrita no arquivo "abc.txt". Acesse-o digitando:

	arq abc.txt

Stio de abc:
http://www.gre.ac.uk/~c.walshaw/abc
$

@@abcplus
$
ABC Plus  uma verso ampliada da linguagem abc. Para dar uma idia,
a linguagem padro permite escrever somente melodias a uma voz; com
ABC Plus podem-se escrever msicas com vrios pentagramas e vozes.

Stio de ABC Plus:
http://abcplus.sourceforge.net
$


@@pros/contras
$
Por qu usar uma linguagem de texto como ABC Plus, se existem diversos
programas com interface grfica para edio de partituras?

Existem muitas vantagens em utilizar a linguagem ABC Plus:

- Recursos: ABC Plus  capaz de gerar partituras com diversos nveis
	de sofisticao, desde as mais simples at altamente complexas.
- Qualidade: Programas como abcm2ps geram partituras de alta qualidade;
- Preo: Muitos dos programas para ABC so grtis e possuem cdigo-
	fonte livremente acessvel;
- Leveza: Os programas ABC so muito compactos e podem rodar em
	computadores antigos ou portteis;
- Atualizao: Novas verses dos programas so disponibilizadas com
	freqncia, contendo revises e novos recursos. Como os
	programas so pequenos, as atualizaes podem ser obtidas pela
	Internet em poucos minutos.
- Transportabilidade: Programas ABC so disponveis para diversos
	sistemas operacionais (como Windows e GNU/Linux);
- Compatibilidade: Arquivos-fonte so escritos em formato de texto
	puro, podendo ser lidos em qualquer computador. Alm disso, com
	ABC geram-se arquivos em formatos bastante difundidos, como
	MIDI, PostScript e PDF. As partituras podem ser inseridas em
	pginas da Internet e processadores de texto;
- Facilidade de uso: ABC  muito fcil de aprender e de usar;
- Velocidade: Escrever partituras em ABC  muito mais rpido que
	usar interfaces grficas.
- Valor didtico: Alm de poder ser usada para exercitar conceitos
	musicais, ABC Plus  muito prtica para escrever material
	didtico (mtodos, apostilas, livros de solfejos), mesclando
	texto e msica e possibilitando armazenar centenas de peas em
	um nico arquivo.

Contudo, ABC Plus possui algumas desvantagens:

- Curva de aprendizado: Enquanto um programa grfico pode permitir
	(pelo menos em teoria!) a um usurio iniciante escrever alguma
	partitura j na primeira sesso,  necessrio aprender
	um pouco de ABC antes de realizar algum trabalho;
- Instalao: ABC normalmente utiliza um nmero de programas
	independentes, configurados para trabalhar em conjunto.
	Instalar e configurar os programas pode no ser fcil para
	usurios de computador iniciantes;
- Limitaes: ABC Plus ainda no  capaz de lidar com certos tipos de
	msicas (canto gregoriano, msica para percusso).
	Porm, programas como abcm2ps permitem alto nvel de
	personalizao do resultado, de modo que  possvel escrever
	mesmo partituras pouco convencionais.
$

@@PostScript
$
PostScript  uma linguagem de programao destinada a impresso de
grficos e texto ( uma "linguagem de descrio de pgina"). Os nomes
dos arquivos PostScript terminam normalmente com a extenso "ps".

Uma caracterstica de PostScript  que os grficos podem ser ampliados
ou reduzidos sem perda de qualidade.

Arquivos PostScript podem ser visualizados e manipulados utilizando-se
programas como GhostView e GhostScript (em Linux, gv e gs, que esto
presentes nas principais distribuies).

O QUE  NECESSRIO SABER

Para usurios de abc/ABC Plus, PostScript tem as seguintes finalidades:

USO BSICO: Visualizao e impresso. Para isso, basta saber que um
	arquivo PostScript pode armazenar grficos e texto -- no caso,
	partituras geradas por um programa abc. Arquivos PostScript
	podem ainda ser convertidos a outros formatos, como PDF
	e diversos formatos de arquivos de imagem.

USO AVANADO: Programao. Conhecendo a linguagem PostScript, um
	usurio de ABC Plus pode criar e alterar smbolos gerados por
	abcm2ps e programas similares, alm de fazer alteraes nos
	arquivos gerados por esses programas.

Onde obter GhostScript e GhostView:
http://www.cs.wisc.edu/~ghost
$

*********************************************************************
@@
@@INTRO
$
Como utilizar abc/ABC Plus em trs passos

(1) - Escrever o arquivo-fonte;
(2) - Converter para PostScript;
(3) - Visualizar a partitura gerada.

Para aprender passo a passo, execute o comando:
	? passo1
$

@@passo1
$
Passo a passo

PASSO 1: ESCREVENDO O ARQUIVO-FONTE

Como exemplo, copie o cdigo abaixo para um editor de textos.
Certifique-se de copi-lo exatamente como est:

X: 1 % Msica nmero 1
K: C % Tonalidade: D Maior
C2 D E F G A B | c2 d e f g a b | c'8 |

Salve o arquivo como "teste.abc" em um diretrio de sua escolha (por
exemplo: "C:\Meus Documentos").

OBS.: Se voc estiver usando Bloco de Notas, escreva o nome do arquivo
      *COM* as aspas, seno o arquivo ser salvo como "teste.abc.txt").

-----------------------
Para continuar, digite:
	? passo2
$

@@passo2
$
Passo a passo

PASSO 2: CONVERTENDO PARA POSTSCRIPT

Abra um interpretador de comandos (Prompt do DOS ou terminal Linux) e
mude para o diretrio onde o arquivo-fonte foi salvo. Por exemplo, se
o arquivo-fonte foi salvo em "C:\Meus Documentos", digite:

	cd "C:\Meus Documentos"

Agora execute abcm2ps com o comando:

	abcm2ps teste.abc

O programa dever gerar um arquivo chamado "Out.ps", que contm a
partitura correspondente ao cdigo escrito em "teste.abc".


-----------------------
Para continuar, digite:
	? passo3
$

@@passo3
$
Passo a passo

PASSO 3: VISUALIZANDO A PARTITURA

Para visualizar a partitura gerada, execute o programa GhostView (ou
gv) e abra (atravs do programa) o arquivo "Out.ps".

Isso tambm pode ser feito executando-se Windows Explorer (ou outro
navegador), abrindo o diretrio utilizado ("C:\Meus Documentos", nesse
exemplo) e dando clique duplo no cone do arquivo "Out.ps".

--------------

Veja a partitura gerada e o seu cdigo-fonte. Tente entender as
relaes entre eles, e ento alguns elementos bsicos da linguagem abc
se tornaro claros. Por convenincia, o cdigo-fonte est transcrito
abaixo:

X: 1 % Msica nmero 1
K: C % Tonalidade: D Maior
C2 D E F G A B | c2 d e f g a b | c'8 |
$



**********************************************************************

@@
@@SOFTWARE
@@
$
Alguns programas ligados a abc/ABC Plus:

PROGRAMA	FINALIDADE
abc2ly		Converso abc -> Lilypond
abc2mtex	Converso abc -> MusiXTeX
abc2ps		Converso abc -> PostScript
abc2prt		Extrao de partes de um arquivo abc/ABC Plus
abcm2ps		Converso ABC Plus -> PostScript
abcMIDI		Converso ABC Plus <-> MIDI e outros fins
abcpp		Pr-processamento de arquivos abc/ABC Plus
abctab2ps	Converso ABC Plus -> PostScript [incluindo tablaturas]
emacs		Edio de texto
jcabc2ps	Converso ABC Plus -> PostScript [com microtonalismo]
JedABC		Edio de texto
GhostScript	Interpretao e processamento de arquivos PostScript
GhostView	Visualizao de arquivos PostScript
runabc		Manipulao de arquivos e programas abc/ABC Plus
tcl-tk		Programao e execuo das linguagens tcl e tk
vim		Edio de texto

Digite o comando abaixo para saber o mnimo de programas necessrios:
	? minimo
$

@@minimo
$
Programas estritamente necessrios para editar partituras com abc:

(1) - Editor de arquivos de texto puro
	Ex.: emacs, JedABC, vim, edit, NotePad (Bloco de Notas)

  OBS.: Bons editores (como emacs e vim) tm muitos recursos que
	facilitam a edio e correo de erros, mas demandam algum
	tempo para ser dominados. Para as primeiras experincias, um
	editor simples como NotePad ou KEdit ser suficiente.

(2) - Conversor abc -> PostScript
	Ex.: abcm2ps, abc2ps

(3) - Interpretador e Visualizador de PostScript
	Ex.: GhostScript e GhostView

  OBS.: Distribuies GNU/Linux j vm com gs e gv.
$
(4) - Conversor abc -> MIDI
      (necessrio apenas se o usurio quiser ouvir a msica editada)
	Ex.: abc2midi (integrante do pacote abcMIDI)
$

@@abcm2ps
$
abcm2ps  um programa desenvolvido por Jean-Franois Moine.

abcm2ps gera partituras em formato Postscript a partir
de um arquivo-fonte em linguagem abc (ou ABC Plus).

abcm2ps  um dos programas para ABC Plus com maior nmero de recursos,
permitindo a gerao de partituras de grande complexidade. Pode-se
tambm inserir textos e grficos e acrescentar smbolos personalizados.

Onde encontrar abcm2ps:
http://moinejf.free.fr
http://abcplus.sourceforge.net
$

@@abcMIDI
$
abcMIDI  um pacote de programas contendo conversores abc <-> MIDI.

Onde obter:
http://ifdo.pugmarks.com/~seymour/runabc/top.html
http://abcplus.sourceforge.net
$

@@runabc
$
runabc  uma interface para controlar diversos programas que lidam
com abc/ABC Plus.

 um programa escrito em tcl (necessita de tcl-tk para rodar).

Onde obter runabc:
http://ifdo.pugmarks.com/~seymour/runabc/runabc.html
$

@@abc2prt
$
abc2prt  um programa para extrao de partes de um arquivo abc.
$

@@abcpp
$
abcpp  um pr-processador para arquivos ABC.
$

@@jcabc2ps
$
jcabc2ps  um conversor ABC Plus -> Postscript, escrito por
John Chambris. Atualmente  compilado somente para Unix (no 
disponvel verso para Windows).

Alguns recursos especiais so:
- Suporte a microtonalismo
- Execuo sonora atravs do sistema sox (experimental)
$

@@JedABC
$
JedABC  o nome de uma verso do editor Jed, adaptada para editar
arquivos ABC.  tambm o nome de um pacote de edio de arquivos ABC
para o editor Jed. (A diferena  que o *editor* JedABC  um programa
completo e pr-configurado para editar arquivos ABC, enquanto que
o *pacote* para edio contm apenas os arquivos necessrios para
editar ABC em um editor Jed comum.)

JedABC reconhece a sintaxe de ABC, destacando os elementos do
cdigo-fonte em cores diferentes. Alm disso, integra-se a outros
programas ABC, realizando atravs de comandos do menu (ou do teclado)
tarefas que demandariam linhas de comando.

Outros editores que podem ser usados para editar e processar arquivos
ABC so: vim (que j vem com modo de edio ABC) e emacs. Ambos existem
em verses para GNU/Linux e Windows. runabc tambm contm um editor
embutido.
$
