Apostila Editor WinShell - Latex, Notas de estudo de Matemática

Baixe Apostila Editor WinShell - Latex e outras Notas de estudo em PDF para Matemática, somente na Docsity!

WinShell 3.

Ingo H. de Boer

25 de junho de 2006

Revisão atual deste documento Renato Machnievscz

email: [email protected], url: www.winshell.org

Copyright c© 1998-2006 Ingo H. de Boer. Permission to use, copy and distribute this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice and this permission notice appear in all copies of this software and related documentation. THE SOFTWARE IS PROVIDED "AS-IS"AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WAR- RANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL INGO H. DE BOER OR ANY PERSON OR INSTITUTION RELATED TO INGO H. DE BOER BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CON- SEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POS- SIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

A tradução abaixo é apenas literal, sem quaiquer efeitos legais. Para uma melhor com- preensão recomenda-se a leitura do texto original.

Copyright c© 1998-2006 Ingo H. de Boer. É permitido o uso, a cópia e a distribuição deste software e da sua documentação sem qualquer tipo de pagamento contanto que a observação de copyright acima e esta ob- servação da permissão apareçam em todas as cópias deste software e da documentação relacionada. O SOFTWARE É FORNECIDO "COMO ESTÁ"E SEM NENHUMA GARANTIA DE QUAL- QUER ESPÉCIE, EXPRESSA, IMPLÍCITA OU OUTRA, INCLUINDO SEM LIMITAÇÃO QUALQUER GARANTIA DE QUALIDADE ACEITÁVEL COMERCIALMENTE OU DE SER- VENTIA PARA UMA FINALIDADE QUALQUER. DE NENHUMA FORMA DEVE INGO H. DE BOER OU QUALQUER PESSOA OU INSTITU- IÇÃO RELACIONADA A ELE SER RESPONSÁVEL POR QUAISQUER TIPOS DE DANOS ESPECIAIS, ACIDENTAIS DE QUALQUER NATUREZA OU QUE RESULTEM DA PERDA DE USO, DADOS OU LUCROS, AVISADO OU NÃO DA POSSIBILIDADE DE DANO, E EM QUALQUER TEORIA DE RESPONSABILIDADE, COMO RESULTADO OU EM CONEXÃO COM O USO OU DESEMPENHO DESTE SOFTWARE.

• 1 Introdução
  • 1.1 O que é o WinShell?
  • 1.2 Instalação
    • 1.2.1 Pacotes LATEX
    • 1.2.2 Visualizador PostScript
    • 1.2.3 Visualizador PDF
    • 1.2.4 Corretor ortográfico
    • 1.2.5 WinShell
  • 1.3 O que há de novo no WinShell 3.1?
  • 1.4 Recursos
  • 1.5 Quanto custa tudo isto?
  • 1.6 O que mais...
  • 1.7 Iniciando o WinShell
• 2 Menus
  • 2.1 Arquivo
  • 2.2 Editar
  • 2.3 Executar
  • 2.4 Opções
  • 2.5 Projeto
  • 2.6 Janela
  • 2.7 Ajuda
• 3 Como fazer...
  • 3.1 Usando argumentos na linha de comando
  • 3.2 Usando o assistente de tabela
  • 3.3 Definindo uma ferramenta do usuário
    • 3.3.1 Criando uma ferramenta
    • 3.3.2 Colocando a ferramenta na barra de ferramentas
  • 3.4 Inserir uma macro
    • 3.4.1 Criar uma macro
    • 3.4.2 Inserindo a macro na barra de ferramentas
  • 3.5 Gerenciando as barras de ferramentas
  • 3.6 Gerenciando um projeto
  • 3.7 Corretor ortográfico
  • 3.8 Saltando para as linhas de erro e aviso
• 4 Próximas versões e notificação de bugs ii Sumário
  • 4.1 Próximas versões
  • 4.2 Notificação de bugs
• Índice Remissivo
• História deste documento

1 Introdução

1.1 O que é o WinShell?

WinShell é um ambiente integrado de desenvolvimento (IDE) para LATEX e TEX. O programa inclui um editor de texto com realce de sintaxe, gerenciador de projeto, verificador ortográ- fico, assistente de tabelas, suporte ao BibTEX, várias barras de ferramentas e opções de configuração para o usuário.

1.2 Instalação

1.2.1 Pacotes LATEX

Antes de mais nada, é necessário ter instalado o LATEX. Existem dois pacotes:

MiKTEX: http://www.miktex.org/ TEXLive: http://www.tug.org/texlive/

Estes programas podem ser encontrados em diferentes comunidades TEX :

ftp://ftp.dante.de/ Alemanha ftp://ftp.tex.ac.uk/ Inglaterra ftp://ctan.tug.org/ Estados Unidos

Os pacotes LATEX estão localizados em: /pub/tex/systems/win32/

1.2.2 Visualizador PostScript

Para poder visualizar arquivos .ps, deve-se instalar o GhostScript e o GSViewer:

http://www.cs.wisc.edu/~ghost/index.html

1.2.3 Visualizador PDF

Existem várias possibilidades para visualizar os arquivos .pdf: com Foxit Reader, GSViewer ou Adobe Reader:

Foxit Reader: http://www.foxitsoftware.com/pdf/rd_intro.php GSView: http://www.cs.wisc.edu/~ghost/index.html Adobe Reader: http://www.adobe.com/

Um destes programas deve ser instalado.

1.4 Recursos 3

• Busca nos arquivos;
• Abertura do último projeto ativo na abertura do WinShell ;
• Conversão automática de arquivos UTF-8;
• Salto para a linha que contém o erro por clique duplo no painel de saída ou de forma automática;
• Reprojeto dos menu e barras de ferramentas;
• Reprojeto do painel de projeto;
• Reprojeto do painel de saída;
• Reprojeto do arquivo de log;
• Reprojeto do menu de fontes;
• Reprojeto do menu de realce de sintaxe.

1.4 Recursos

Alguns dos recursos são: Suporte multilingue (Português brasileiro, Catalão, Chinês, Tcheco, Inglês, Francês, Alemão, Húngaro, Italiano, Polonês, Espanhol e Sueco); Ambiente de pro- jeto (Sumário, Figuras, Tabelas, Bibliografia); Corretor ortográfico integrado baseado no Aspell; Suporte a Bibliografia; Busca avançada e inversa; Assistente de tabelas; Programa de uma instância; Múltiplos documentos; Janela de Projete e Saída; Programas definidos pelo usuário; Configuração das barras de ferramentas (símbolos, programas definidos pelo usuário, macros); Definição de macros; Escolha de fonte; Formato de arquivo Windows/Unix; WinShell permite a execução por linha de comando; Realce de sintaxe; Modo wrap; Arraste & Solte.

1.5 Quanto custa tudo isto?

Este software é fornecido em um formato binário (’como está’) gratuitamente - o código fonte não está disponível. No catálogo TEX ele estará na classificação ’nosource’.

Muitas são as despesas que tenho para manter o projeto WinShell que podem não ser visíveis, tais como custos de hospedagem web, custos de novos sistemas operacionais e softwares que tenho de adquirir especialmente para desenvolver e testar o WinShell. Caso deseje, você pode me enviar doações de qualquer quantia ou espécie para me ajudar a manter o projeto WinShell.

Embora as doações recebidas sejam muito apreciadas, aqueles que a fizerem não rece- berão nenhuma espécie de tratamento preferencial sobre os outros.

Por favor, contate-me para maiores esclarecimentos.

4 Introdução

1.6 O que mais...

Notas adicionais:

1. Leia este manual antes de enviar emails, pode ser que você encontre aqui a resposta.
2. Está incluso uma ajuda sobre LATEX.
3. Aprenda fazendo.

1.7 Iniciando o WinShell ...

Se os pacotes LATEX estão corretamente instalados no sistema (veja Instalação), o usuário pode começar imediatamente.

As diferentes barras de controle (veja Visualizar) estão ocultas sob a barra de ferramentas, na parte superior da janela principal. Elas podem ser movidas, modificadas, mostradas ou ocultadas. Estas condições serão gravadas, quando fechando o programa e serão restau- radas no início da próxima sessão.

Os comandos exe- e command-line podem ser configurados no menu Chamadas de Pro- gramas.

Um arquivo de demonstração está incluído no pacote do WinShell , o qual será inicializado na primeira vez que o WinShell for iniciado. O arquivo de demonstração está localizado na pasta demo. Abra o projeto demo. Clique no botão LATEX na barra de ferramentas. Dê uma olhada no arquivo demo com o visualizador de dvi DVIView ou compile um arquivo .pdf ou .ps. Se você obter qualquer mensagem de erro, o LATEX pode não ter sido instalado incorretamente.

6 Menus

Salvar todos

Este comando salva todos os arquivos aberto no projeto. Quando um arquivo é salvo pela primeira vez, o WinShell mostrará a caixa de diálogo ’Salvar como’ para nomear o arquivo.

Configurar impressão

Define a impressora e as propriedades da página. O comando abre a caixa de diálogo ’Configurar impressão’, onde você pode ajustar alguns parâmetros da sua impressora.

Imprimir

O arquivo atual é impresso em formato texto ASCII, note que não é o arquivo .dvi nem também o arquivo .ps!

Sair

Este comando termina a sessão do WinShell. O comando Fechar também pode ser usado. O WinShell avisa que é necessário salvar os arquivos que foram modificados se não for marcada a opção ’Salvar arquivos automaticamente ao sair’ na caixa de diálogo Geral.

Teclas de atalho: Alt + F

2.2 Editar

Desfazer digitação

Este comando irá desfazer a última ação realizada, se possível.

Teclas de atalho: Ctrl + Z

Repetir digitação

Este comando irá refazer uma ação previamente desfeita, se possível.

Teclas de atalho: Ctrl + Y

Recortar

O comando Recortar remove a região selecionada do documento e copia para área de transferência. Este comando somente estará disponível se uma região estiver previamente selecionada. A seleção atual irá substituir a seleção anterior na área de transferência.

Teclas de atalho: Ctrl + X

2.2 Editar 7

Copiar

O comando Copiar copia a região selecionado para a área de transferência. Este comando somente estará disponível se uma região estiver previamente selecionada. Copiar dados para a área de transferência substitui os dados previamente copiados.

Teclas de atalho: Ctrl + C

Colar

Este comando insere uma cópia do conteúdo da área de transferência na posição em que se encontra o cursor. Este comando estará indisponível se a área de transferência estiver vazia.

Teclas de atalho: Ctrl + V

Excluir

Este comando exclui o texto selecionado no documento ativo.

Tecla: Del

Selecionar tudo

Este comando seleciona todo o texto no documento ativo.

Teclas de atalho: Ctrl + A

Localizar e Substituir

Localizar

O comando Localizar busca, no documento ativo, uma dada frase.

Se a opção expressão regular não estiver marcada, você pode fazer uma busca tanto para a frente, como para trás, para localizar a frase (ou conjunto de caracteres) procurada. Se a opção expressão regular estiver marcada, a busca será sempre de uma posição inferior para uma posição superior, mesmo que a região de busca tenha ficado para trás.

O uso das expressões regulares é explicada na tabela 2.1.

Teclas de atalho: Ctrl + F

Localizar próximo

O comando Localizar próximo busca, no documento ativo, a próxima ocorrência procurada, se houver.

Tecla: F

2.3 Executar 9

. Um caracter qualquer. ( Marca o início de um grupo. ) Marca o final de um grupo. \n Onde n vai de 1 até 9 e refere-se do primeiro ao nono grupo da região marcada quando substituindo. Por exemplo, se os caracteres de busca eram Fred([1-9])XXX e os caracteres de de substituição eram Sam\1YYY, quando aplicado a Fred2XXX isto criará Sam2YYY. \x Isto permite o uso do caracter x, que de outra forma tem um significado especial. Por exemplo, [ será interpretado como [ e não como o início de um conjunto de caracteres. [...] Indica um conjunto de caracteres, por exemplo, [abc] significa que qualquer dos caracteres a, b ou c. Você também pode usar faixas, por exemplo, [a-z] para qualquer caracter minúsculo entre a e z. [∧...] Lista de caracteres proibidos. Por exemplo, [∧A-Za-z] significa qualquer caracter, exceto um caracter alfabético. ∧ (^) Marca o início de uma linha (exceto se usado dentro de um conjunto), veja acima. $ Marca o fim de uma linha.

• Significa 0, 1 ou mais. Por exemplo, ca*o retorna co, cao, caao, caaao e assim por diante.

• Significa 1 ou mais. Por exemplo, ca+o retorna cao, caao, caaao e assim por diante.

Tabela 2.1: Expressões regulares para a pesquisa e substituição. Para maiores infor- mações, por favor veja a documentação (http://www.scintilla.org/) Scin- tilla.

10 Menus

BibTEX

Este comando compila a BibTEX. A linha de comando é inserida no menu Chamadas de Programas (normalmente o cmd-line é »"%s"«). A opção DOS marcada indica que isto é um comando DOS (prompt de comando) e que a saída é redirecionada para o Painel de Saída do WinShell.

Existem mais duas opções recomendadas: ’LATEX primeiro’ e ’PDFLATEX primeiro’. Se um arquivo é modificado e não compilado com LATEX ou com PDFLATEX, o BibTEX irá usar a saída do arquivo LATEX anterior. Para evitar isto as duas opções são marcadas: quando modificar um arquivo e pressionar o botão BibTEX , o LATEX ou PDFLATEX irá compilar primeiro.

Teclas de atalho: F

Visualizador de DVI (DVIView)

O comando visualizar DVI é usado para ver o arquivo .dvi do documento TEX- principal. A linha de comando é inserida no menu Chamadas de Programas (normalmente o cmd-line é »"%s.dvi"«).

Existe mais uma opção recomendada: ’LATEX primeiro’. Se um arquivo é modificado e não compilado com LATEX , o DVIView irá mostrar a versão anterior do arquivo .dvi. Esta opção é marcada para assegurar que ao modificar um arquivo e pressionar o botão visualizar DVI, o LATEX seja executado por primeiro.

Teclas de atalho: F

Busca avante e inversa

A busca avante e inversa permite ir do WinShell diretamente à posição correspondente no arquivo .dvi e vice-versa. Para usar a busca avante e inversa no WinShell e no visualizador DVIViewer, o WinShell fornece os seguintes coringas:

%l a linha atual %s o arquivo principal %c o arquivo atual

Para usar a busca avante com o YAP/MikTEX duas modificações foram feitas no WinShell :

• Opções ⇒ Chamadas de Programas ⇒ LATEX cmd-line: -src-specials "%s.tex"
• Opções ⇒ Chamadas de Programas ⇒ DVIView exe-line: yap.exe cmd-line: -1 -s %l"%c.tex%s.dvi"

Para usar a busca inversa com o YAP/MikTEX, o YAP foi modificado da seguinte forma:

12 Menus

Quando o Acrobat Reader é o visualizador escolhido, o PDFLATEX encerra o documento no Adobe Reader por que o mesmo trava o documento.

Teclas de atalho: F

Visualizador de PDF (PDFView)

O comando visualizar PDF é utilizado para a visualização do arquivo .pdf do documento TEX principal. A linha de comando é inserida no menu Chamadas de Programas (normal- mente »"%s.pdf"«).

Se a opção ’PDFLATEX primeiro’ estiver marcada, o documento modificado será primeiro compilado e depois visualizado.

Teclas de atalho: F

Verificador ortográfico

Este comando verifica ortograficamente o arquivo atualmente aberto. Este corretor é baseado no ASpell (http://aspell.net/win32/).

Os arquivos binários e o dicionário devem ser instalados (veja Instalando o ASpell). O uso é descrito na seção Uso do corretor ortográfico.

Teclas de atalho: F

Assistente de tabelas

O usuário será perguntado, em três passos, sobre o layout da tabela. Após isto, a tabela será inserida no texto, na posição atual do cursor. Veja também Uso do assistente de tabelas.

2.4 Opções

Geral

A aba Geral, na caixa de diálogo Opções permite ao usuário definir o idioma, o formato de arquivo e algumas outras opções.

Se a primeira opção estiver ativa, é criado um arquivo de backup (.bak) para guardar a versão antiga do documento.

A segunda opção indica que os arquivos modificados serão salvos ao encerrar a sessão do WinShell. Se não estiver marcada, o usuário é perguntado se deseja que os arquivos sejam salvos ou não. Se a terceira opção estiver ativa, durante a compilação o WinShell saltará para a linha que contém o erro, (veja Indo para as linhas com erro).

Também é possível escolher o formato de arquivo para os documentos. Pode ser no formato windows (terminação da linha \r\n) ou formato unix (terminação da linha \n).

2.4 Opções 13

O idioma do WinShell também pode ser definido aqui (veja Idioma).

Chamadas de Programas e programas do usuário

Use este comando para definir a linha de comando para os diferentes programas, como por exemplo: LATEX, BibTEX , etc. É muito importante adicionar os sufixos para os diferentes tipos de programas.

Os parâmetros %

[s, p, c]<.xxx, .%ex> têm o seguinte significado:

%s use o documento como especificado na barra de status. %ps use o documento como especificado na barra de status com o caminho completo. %pp use o caminho do projeto. %c use o documento atual. %pc use o documento atual como caminho completo. xxx extensão do arquivo, por ex. »tex«, »bib«, etc. %ex a extensão do arquivo atual.

A opção DOS marcada indica que isto é um comando DOS (prompt de comando) e que a saída é redirecionada para o Painel de Saída do WinShell.

Exemplo de um programa do usuário

Para adicionar o programa makeindex no WinShell , digite o nome do programa no campo nome »MakeIndex« e no campo Arquivo exe »makeindex«. Na linha cmd »-s "%s.ist-o "%s.ind%s.idx"«. Não marque as opções ’LATEX primeiro’, ’PDFLATEX primeiro’ e ’DVIPS primeiro’. Marque a opção ’DOS’ para redirecionar a saída para o WinShell Painel de Saída.

Próximo passo: Vá ao menu Visualizar e coloque um botão na barra de ferramentas (veja Definindo uma ferramenta do usuário).

Macros

Define as macros. Existem dez macros que podem ser definidas pelo usuário. Através do teclado ou do botão na barra de macros, uma dada macro será inserida na posição atual

2.4 Opções 15

Modo Wrap

Alterna o modo Wrap, isto é, a indentação do texto com relação às margens do editor. Quando este modo está ativo, uma marca aparece próximo ao texto, no menu.

Numeração de Linhas

Alterna a presença dos números de linhas. Os números são visualizados na margem es- querda do texto. Uma marca aparece ao lado do texto, quando esta opção está ativa.

Umlaute

Modifica o trema (’Umlaute’ em alemão). Esta opção está disponível apenas na versão alemã. Quando pressionando uma das teclas tremadas, ela aparecerá como especificado na caixa de diálogo.

Visualizar

Personalizar

Existem quatro categorias para personalizar a barra de ferramentas e a barra de macros. As duas primeiras categorias são a barra padrão e os botões LATEX. A terceira categoria é para os programas do usuário e a quarta categoria é para as macros. A personalização é simplesmente selecionar uma categoria, clicar em um botão para ver sua descrição e arrastá-lo para a barra de ferramentas.

Quando o ícone do programa do usuário é solto na barra de ferramentas ou na barra de macros, outra caixa de diálogo irá abrir permitindo a personalização do botão (editor de ícones). (veja Criando uma ferramenta do usuário).

Para excluir um ícone da barra de ferramentas, clique no ícone e mova-o para fora da barra de ferramentas (arrastar & soltar) ou use ítem do menu ’Excluir’ no próprio menu de ícones.

16 Menus

Painel de Projeto

Mostra o painel de Projeto ou não. Quando selecionada esta opção, um quadrado azul envolve ícone.

O painel de projeto é o local onde pode-se visualizar rapidamente todas as informações sobre o projeto. Para informações adicionais veja a seção Gerenciamento de Projeto.

Painel de Saída

Mostra ou não as informações da janela de saída. Quando esta opção está ativa, um quadrado azul envolve o ícone.

A janela de saída mostra os resultados da compilação feita pelo LATEX. Esta janela e a transcrição do arquivo .log gerado pelos diferentes programas usados e também a saída dos resultados da Busca nos Arquivos. Este campo não pode ser editado, mas pode ser copiado via janela de transferência.

Um clique duplo em um erro ou aviso do LATEX faz com que o cursor pule imediatamente para a linha onde se encontra o erro, no arquivo correspondente. (Veja Indo para linha com erro).

Barra de Ferramentas

Mostra ou esconde a barra de ferramentas. Quando esta opção está ativa uma marca aparece ao lado da opção.

A barra de ferramentas é visualizada na parte superior da janela, abaixo da barra de aplica- tivos. A barra de ferramentas permite um rápido acesso via mouse a todas as ferramentas usadas no WinShell.

Barra de Status

Mostra ou não a barra de status. Quando esta opção está ativa uma marca aparece ao lado da opção.

A barra de status é visualizada na parte inferior da janela do WinShell. À esquerda temos a ação a ser executada quando passamos o mouse sobre uma opção da barra de ferramentas. À direita, a barra de status mostra a linha e a coluna atual no documento e o documento TEX principal.

Outras barras

Mostra ou não as outras barras. Uma marca será mostrada ao lado do ítem selecionado. Estas barras representam alguns dos comandos mais comuns usados no LATEX.