O Manual do &kdvi;

Exportar para &PostScript; Tal como na impressão, o programa externo dvips é usado para gerar o ficheiro &PostScript;. Se o ficheiro &DVI; contiver hiperligações, estas também serão incluídas no ficheiro &PostScript;. Se você for um perito e se desejar gerar resultados optimizados para uma impressora específica, deverá querer iniciar o dvips manualmente e escolher o modo de MetaFont você mesmo.

Exportar para <acronym>PDF</acronym> Para produzir ficheiros PDF com alta qualidade, o &kdvi; converte o &DVI; para PDF usando o programa externo dvipdfm. Se você estiver a trabalhar numa máquina com uma versão antiga do sistema de publicação TeX, pode acontecer que o programa dvipdfm não esteja instalado. Neste caso, você terá de usar a função de impressão para gerar os resultados em PDF. Se você usa uma instalação mais antiga do TeX, e se estiver a ver o ficheiro gerado no Acrobat reader da Adobe, você irá reparar que alguns dos tipos de letra parecem bastante maus, ainda que a impressão fique óptima, apesar de o documentação também parecer em condições no kghostview. Isto é um problema conhecido com o Acrobat Reader e com os tipos de letra de imagens. Na altura em que isto foi escrito, a única solução prática era evitar os tipos de letra com imagens ou actualizar para uma instalação mais recente do TeX. Embora o dvipdfm produza ficheiros PDF de alta qualidade, o dvipdfm ignora de momento o &PostScript; que vem incorporado no ficheiro &DVI;. O PostScript incorporado é gerado p.ex. pelo pacote de macros xy ou pela função de "Incorporar os ficheiros PostScript" que o &kdvi; descreve em baixo. Se você achar que faltam dados gráficos ao PDF gerado, use a função de impressão do &kdvi; em alternativa.

Exportar para ficheiros de texto O &kdvi; também pode gravar os seus ficheiros &DVI; no formato de texto. A norma do &DVI; não foi desenhada com este tipo de funcionalidade em vista. Esta função, deste modo, só funciona bem com os caracteres ASCII normais. Não irá funcionar com as línguas não-Europeias. Dependendo dos tipos de letra usados nos ficheiros, poderão também ocorrer problemas com os caracteres acentuados ou com outros símbolos, e algumas vezes mesmo com as ligações.

Produzir os ficheiros TeX para a pesquisa inversa Existem essencialmente duas formas de produzir ficheiros &DVI; que contenham informações de pesquisa inversa: você tanto poderá usar um ficheiro binário de TeX/LaTeX que gera e inclui a informação necessária automaticamente ou poderá incluir um pacote extra escrito em TeX/LaTeX. Um ficheiro binário em TeX que gera e inclui a informação necessária é com certeza o método preferido para incluir a informação da pesquisa inversa. Se você usar a versão 2 ou posterior da distribuição de TeX TeTeX, você poderá usar a opção 'src-specials' da linha de comandos do comando 'tex' ou 'latex', tal como se segue. tex --src-specials o_meu_ficheiro.tex ou latex --src-specials o_meu_ficheiro.tex Se você não tiver um ficheiro TeX binário que inclua nativamente a informação de pesquisa inversa, copie os ficheiros srcltx.sty e srctex.sty para a pasta onde o seu ficheiro TeX está guardado (você poderá fazê-lo se carregar na tecla &Shift; e no &LMB; enquanto o cursor do rato se encontra sobre uma hiperligação). Se usar o LaTeX, adicione a linha \usepackage[active]{srcltx} ao preâmbulo do seu ficheiro LaTeX. Se usar o TeX simples a linha \include{srctex} fará o truque. Embora a pesquisa inversa seja bastante útil quando você está a escrever um documento, poderá ser uma boa ideia remover a informação de pesquisa inversa antes de enviar o ficheiro &DVI; para outra pessoa.

Configurar o seu editor para a pesquisa normal Ainda que a pesquisa inversa funcione de modo geral bem na maioria dos editores, alguns deles necessitam de alguns cuidados especiais extra. Esta secção explica como configurar o seu editor.

<application>Emacs</application> O Emacs funciona bem com o &kdvi;. O comportamento actual do Emacs depende em grande medida da configuração. Como de costume, você poderá personalizar por completo o Emacs, se estiver disposto a enfrentar algum código de Lisp. O &kdvi; usa o programa emacsclient para controlar remotamente o Emacs. O programa emacsclient necessita que o Emacs esteja em execução e que o programa Emacs Server (servidor do Emacs) tenha sido iniciado dentro do Emacs. A pesquisa inversa não irá funcionar convenientemente a menos que tenha iniciado tanto o Emacs como o Emacs Server. Para iniciar o Emacs Server, você poderá fazer uma das coisas seguintes: No Emacs, inicie o Emacs Server escrevendo MX server-start Adicione a linha (server-start) ao seu ficheiro .emacs file. Reinicie o Emacs Certifique-se que o Emacs está instalado. Tente iniciar o emacs a partir da linha de comandos. O &kdvi; usa o comando emacsclient para controlar remotamente o Emacs. Certifique-se que o emacsclient está disponível na linha de comandos ao escrever o comando emacsclient Nome de um ficheiro de texto. Isto deverá abrir um texto novo no editor Emacs. Se o emacsclient falhar com uma mensagem do erro do tipo unable to connect to local (não foi possível ligar ao local), certifique-se que o Emacs está a correr. De seguida, certifique-se que o Emacs Server está a correr escrevendo Mx server-start. Se você quiser que a janela se auto-eleve, adicione a função raise-frame ao server-switch-hook (faça Mx customize-variable RET server-switch-hook e indique o nome da função no campo de texto. Se você alterou o documento desde a sua última gravação, o Emacs irá perguntar-lhe: Revert buffer from file ...? (yes or no) (reverter o documento a partir do ficheiro ...? (sim ou não). Você provavelmente irá dizer no (não) aqui, dado que a reversão significa que o ficheiro será lido de novo a partir do disco, fazendo com que todas as suas alterações desde a última gravação sejam perdidas! O comportamento do gnuclient ao reler silenciosamente o documento alterado é provavelmente preferível — adicione as seguintes linhas ao seu ficheiro .emacs para emular o comportamento do gnuclient com o emacsclient: (defadvice server-visit-files (around save-buffers last activate) "Try to emulate gnuclient behavior with emacsclient. Works only for visiting one buffer at a time." (let* ((filen (car (car (ad-get-arg 0)))) (buf (get-file-buffer filen)) (this-buf-modified-p nil)) ;;; the following is copied from server-visit-files, with ;;; a modification for the `verify-visited-file-modtime' test (if (and buf (set-buffer buf)) (if (file-exists-p filen) ;;; if the file has changed on disk, reload it ;;; using `find-file-noselect' (if (not (verify-visited-file-modtime buf)) (progn (find-file-noselect filen) ;;; if user answered `no', reset modtime anyway ;;; so that server-visit-files doesn't realize the ;;; difference: (set-visited-file-modtime))) ;;; if file exists no longer, we let server-visit-files ;;; deal with that t) (set buf (find-file-noselect filen))) (set this-buf-modified-p (buffer-modified-p buf)) (set-buffer buf) (set-buffer-modified-p nil) ad-do-it (set-buffer-modified-p this-buf-modified-p)))

&kate; O editor &kate; do &kde; suporta bastante bem a pesquisa inversa. Não é necessária nenhuma configuração extra.

<application>Kile</application> O sistema de edição de LaTeX Kile suporta o KDVI bastante bem. Não é precisa nenhuma configuração extra. Para mais informações sobre o Kile vá à página pessoal do Kile.

<application>NEdit</application> O NEdit funciona de um modo geral bastante bem. Se carregar no ficheiro &DVI; irá abrir uma janela nova. Se o ficheiro TeX já estiver a ser usado noutra janela do NEdit, a nova janela que é aberta mostrará outra vista sobre o ficheiro. Caso contrário, o ficheiro TeX é carregado. Depois de abrir a janela, o NEdit realça a primeira linha do parágrafo apropriado. O &kdvi; usa o comando ncl para controlar remotamente o NEdit. Certifique-se que o ncl está disponível na linha de comandos, tentando o comando ncl -noask. Isto deverá abrir uma instância do editor NEdit. Se o ncl não estiver disponível, você poderá estar a usar uma versão antiga do NEdit. Nesse caso, você deverá mudar para uma versão mais recente ou então terá de usar a opção Editor definido pelo utilizador da janela de Opções.

<application>XEmacs</application> O XEmacs funciona bem com o &kdvi;. O comportamento actual do XEmacs depende em grande medida da configuração. Como de costume, você pode personalizar o XEmacs por completo, se estiver disposto a debater-se com algum código em Lisp. O &kdvi; usa o gnuclient para controlar remotamente o XEmacs. O programa gnuclient necessita que o XEmacs esteja a correr, assim como o programa gnuserv seja iniciado dentro do XEmacs. A pesquisa inversa não irá funcionar a menos que tenha iniciado tanto o XEmacs como o gnuserv. Para iniciar o programa gnuserv, você poderá fazer uma das seguintes coisas: No XEmacs, inicie o gnuserv escrevendo MX gnuserv-start Adicione a linha (gnuserv-start) ao seu ficheiro .xemacs. Se você usar uma versão mais recente do XEmacs, o .xemacs será uma pasta. Nesse caso, você deverá adicionar a linha ao ficheiro .xemacs/init.el. Reinicie o XEmacs Se não desejar abrir uma nova janela por cada chamada do editor, e quiser que a mesma janela se auto-eleve, defina a opção Gnuserv Frame (Janela do Gnuserv) para Use selected frame (usar a janela seleccionada) e adicione a função raise-frame a Visit Hook (Chamada de Visita). Faça Mx customize-group RET gnuserv para efectuar estas configurações. Certifique-se que o XEmacs está instalado. Tente iniciar o xemacs a partir da linha de comandos. O &kdvi; usa o comando gnuserv para controlar remotamente o XEmacs. Certifique-se que o gnuclient está disponível na linha de comando, tentando o comando gnuclient Nome de um ficheiro de texto. Isto deverá abrir uma nova janela no editor XEmacs. Se o gnuserv falhar com uma mensagem de erro do tipo unable to connect to local (incapaz de ligar ao local), certifique-se que o XEmacs está a correr. Para além disso, confirme se o gnuserv é iniciado, escrevendo MX gnuserv-start. Se não desejar abrir uma nova janela por cada chamada do editor, e quiser que a mesma janela se auto-eleve, defina a opção Gnuserv Frame (Janela do Gnuserv) para Use selected frame (usar a janela seleccionada) e adicione a função raise-frame a Visit Hook (Chamada de Visita). Faça MX customize-group RET gnuserv para efectuar estas configurações.

<application>VI iMproved</application> / &GUI; A variante gvim do editor vi suporta muito bem a pesquisa inversa. Não é necessária nenhuma configuração extra.

Configurar o seu editor para a pesquisa normal

<application>Emacs</application> Para poder usar a pesquisa normal no Emacs, siga estes passos: Obtenha o seguinte programa do Emacs script, kdvi-search.el (carregue em &Shift; e no &LMB; sobre o ficheiro a obter) e guarde-o num local onde o Emacs lhe possa aceder — nós recomendamos uma pasta do tipo emacs-scripts. Adicione as linhas (add-to-list 'load-path (expand-file-name "~/emacs-scripts/")) (require 'kdvi-search) (add-hook 'LaTeX-mode-hook (lambda () (local-set-key "\C-x\C-j" 'kdvi-jump-to-line))) (add-hook 'tex-mode-hook (lambda () (local-set-key "\C-x\C-j" 'kdvi-jump-to-line))) ao seu ficheiro .emacs. Reinicie o Emacs. Abra o Emacs, carregue um ficheiro de TeX, produza o ficheiro &DVI; correspondente e introduza o comando Mx kdvi-jump-to-line ou carregue em &Ctrl;X &Ctrl;J . Poderá acontecer que o Emacs lhe peça o nome de um master file (ficheiro-mestre). Isto é útil se você usar um ficheiro do TeX que inclua outros ficheiros: o ficheiro-mestre é o ficheiro do nível de topo que inclui os outros. O Emacs irá provavelmente pedir também para gravar o nome do ficheiro-mestre como uma variável local, &ie; como um comentário no fim do ficheiro. Basta dizer yes (sim) ou no (não) para continuar. Certifique-se que o Emacs está instalado. Tente iniciar o emacs a partir da linha de comandos. Se o Emacs não conseguir iniciar o &kdvi;, você poderá ver o seu resultado no documento kdvi-output.

<application>Kile</application> Se você usar o Kile, não é necessária mais nenhuma configuração.

<application>XEmacs</application> Para configurar o XEmacs, siga os passos para o Emacs descritos acima, mas altere o seu ficheiro .xemacs em vez do seu .emacs. Se usar uma versão muito recente do XEmacs, o .xemacs poderá ser uma pasta. Nesse caso, adicione as linhas ao ficheiro .xemacs/init.el.