<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY klinkstatus "<application
>KLinkStatus</application
>">
  <!ENTITY kappname "&klinkstatus;"
><!-- Do *not* replace kappname-->
  <!ENTITY package "kdewebdev"
><!-- kdebase, kdeadmin, etc -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Brazilian-Portuguese "INCLUDE"
><!-- change language only here -->
]>

<book id="klinkstatus" lang="&language;">

<bookinfo>
<title
>Manual do &klinkstatus;</title>

<authorgroup>
<author
><firstname
></firstname
> <othername
></othername
> <surname
>Paulo Moura Guedes</surname
> <affiliation
> <address
><email
>moura&#64;kdewebdev&#46;org</email
></address>
</affiliation>
</author>

<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2004</year>

<holder
>Paulo Moura Guedes</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>22/08/2011</date>
<releaseinfo
>0.7.0 (&kde; 4.7)</releaseinfo>

<abstract>
<para
>&klinkstatus; é um verificador de links para o &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KLinkStatus</keyword>
<keyword
>Verificador de links</keyword>
<keyword
>validação</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &klinkstatus; é um verificador de links para o &kde;. Permite-lhe procurar links internos e externos no seu site inteiro, numa única página e escolhendo a profundidade da procura. Você poderá também verificar os arquivos locais, FTP, FISH, &etc;, já que o &klinkstatus; usa o KIO. Para performance, os links poderão ser verificados simultaneamente. </para>
<para
>Os recursos do aplicativo podem ser estendidos com o uso de <ulink url="http://techbase.kde.org/Development/Tutorials/Kross/Introduction"
>programas de script do Kross</ulink
>. </para>
</chapter>

<chapter id="using-klinkstatus">
<title
>Usando o &klinkstatus;</title>

<para
>Para verificar links em uma página Web ou arquivo local insira seu endereço no campo <guilabel
>URL:</guilabel
> e pressione &Enter;. Você pode também usar o ícone de pasta à direita para navegar até o endereço desejado usando uma &GUI;. </para>
<screenshot>
<screeninfo
>Aqui está uma imagem do &klinkstatus;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem</phrase>
	  </textobject>
	  <caption>
	    <para
>O &klinkstatus; está verificando links na página Web do KDevelop. Links quebrados ou mal formados são marcados em vermelho. </para>
	  </caption>
	</mediaobject>
</screenshot>
<para
>Se o acesso aos dados inspecionados for restrito, por favor verifique a opção de <guilabel
>Login</guilabel
>. Após pressionar &Enter; no campo &URL; ou pressionar o botão <guibutton
>Iniciar pesquisa</guibutton
> na barra de ferramentas, a janela a seguir será exibida para inserir as credenciais. </para>
<screenshot>
<screeninfo
>Janela de Credenciais do &klinkstatus;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="login-dialog.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Janela de Credenciais do &klinkstatus;</phrase>
	  </textobject>
	  <caption>
	    <para
>O &klinkstatus; está pedindo que você insira as credenciais. </para>
	  </caption>
	</mediaobject>
</screenshot>
<para
>Insira as credenciais e pressione o botão <guibutton
>OK</guibutton
>. </para>
<para
>Você pode reduzir o intervalo de links a ser verificado desmarcando a opção <guilabel
>Verificar links externos</guilabel
> (se os links externos não precisam ser checados) ou inserindo expressões regulares no campo <guilabel
>Não verificar Expressão Regular</guilabel
>. </para>
<para
>Os resultados da busca podem ser filtrados usando o campo <guilabel
>Pesquisa</guilabel
> ou o menu combinado <guilabel
>Status</guilabel
> (<guimenuitem
>Todos os links</guimenuitem
>, <guimenuitem
>Links bons</guimenuitem
>, <guimenuitem
>Links quebrados</guimenuitem
>, <guimenuitem
>Links mal formados</guimenuitem
> ou <guimenuitem
>Links indeterminados</guimenuitem
>). </para>
<para
>No menu de contexto de cada item nos resultados da pesquisa você pode <guimenuitem
>Verificar novamente</guimenuitem
> o item, <guisubmenu
>Editar referência</guisubmenu
> no editor padrão, <guimenuitem
>Abrir o URL</guimenuitem
>, <guimenuitem
>Abrir a referência do URL</guimenuitem
>, <guimenuitem
>Copiar URL</guimenuitem
>, <guimenuitem
>Copiar referência do URL</guimenuitem
> ou <guimenuitem
>Copiar texto da célula</guimenuitem
>. </para>
<para
>Os resultados verificados podem ser salvos como um mapa da página em &XML; usando o menu <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Criar mapa da página...</guimenuitem
></menuchoice
> ou exportados como &HTML; usando <menuchoice
><guimenu
>Arquivo</guimenu
><guisubmenu
>Exportar para HTML</guisubmenu
></menuchoice
>. Você pode optar por exportar <guimenuitem
>Todos</guimenuitem
> ou apenas os links <guimenuitem
>Quebrados</guimenuitem
>. Uma opção para <guimenuitem
>Baixar novas stylesheets</guimenuitem
> para usar stylesheets para exportação a partir do repositório para Obter novas coisas também está implementada. </para>
<!--kde.org
Support several protocols (allowing fast checking of local documents): http, ftp, ssh (fish or sftp) and file.
Proxy support
Allows authentication when checking restricted documents
Limit the search depth
Pause/Resume of checking session
History of checked URLs
Kross Scripting
  -->
</chapter>
<!--
  How does scheduling auto link check work?
  starting klinkstatus via user crontab? apparently not!
  via a kded service?
  needs a running klinkstatus instance?
  is this unfinished work?

<chapter id="auto-check">
<title
>Automatic Site Checking</title>

<para>
  Using <menuchoice
><guimenu
>Tools</guimenu
><guimenuitem
>Schedule Link Checks...</guimenuitem
></menuchoice>
  opens the <guilabel
>Configure Site Check Automation</guilabel
> dialog.

  Here you can add, remove and edit sessions.
  Scheduling Weekly (how to set day?), Daily, Hourly

</para>

</chapter>
-->

<chapter id="config">
  <title
>Configurando o &klinkstatus;</title>
  <para
>As opções de configuração do &klinkstatus; podem ser acessadas abrindo a janela de configuração ao selecionar <menuchoice
> <guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar o &klinkstatus;...</guimenuitem
> </menuchoice
> no menu.</para>
    <screenshot>
      <screeninfo
>Janela Configurar o &klinkstatus;</screeninfo>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="check-settings.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase
>Verificar</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  <para
>Na página <guilabel
>Verificar</guilabel
>, você pode mudar os parâmetros de verificação padrão. Esta página é dividida em três painéis (<guilabel
>Rede</guilabel
>, <guilabel
>Entrada</guilabel
> e <guilabel
>Quanta</guilabel
>) com a caixa de opção <guilabel
>Lembrar configurações ao sair</guilabel
> adicional. Se isto for marcado, o &klinkstatus; se lembrará das configurações feitas ao sair do &klinkstatus; e irá restaurá-las na próxima execução do aplicativo. </para>
  <para
>O painel <guilabel
>Rede</guilabel
> pode ser usado para selecionar o <guilabel
>Número de conexões simultâneas</guilabel
> e o <guilabel
>Tempo de expiração em segundos</guilabel
>. </para>
  <para
>Você pode mudar o <guilabel
>Número de itens no histórico de &URL;</guilabel
> (o padrão é 50) e a <guilabel
>Profundidade</guilabel
> da verificação (pode ser sobrescrita com a janela principal do &klinkstatus;, 0 para <guilabel
>Ilimitada</guilabel
>). Você pode também definir se &klinkstatus; deve <guilabel
>Verificar as pastas pai</guilabel
> e <guilabel
>Verificar links externos</guilabel
> (pode ser sobrescrita com a janela principal do &klinkstatus;). </para>
  <para
>O painel <guilabel
>Quanta</guilabel
> é usado para controlar a integração com o &quantaplus; do &klinkstatus;. Assinale o <guilabel
>Usar prefixo de visualização</guilabel
> se você deseja usar o prefixo de visualização de projeto do &quantaplus; na &URL; para a verificação. </para>
  <screenshot>
    <screeninfo
>Janela Configurar o &klinkstatus;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="results-settings.png" format="PNG"/>
      </imageobject>
      <textobject>
	<phrase
>Resultados</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  <para
>Usando a página <guilabel
>Resultados</guilabel
> você pode selecionar o formato da lista de resultados da verificação. <guilabel
>Árvore</guilabel
> é a visão em árvore padrão e <guilabel
>Plana</guilabel
> é a lista plana (pode ser mais rápida em máquinas com desempenho inferior). Você pode também fazer com que o &klinkstatus; <guilabel
>Siga o último link verificado</guilabel
> e definir <guilabel
>A folha de estilo preferida</guilabel
> para a lista de verificação. Novas folhas de estilo podem ser baixadas do repositório para Obter coisas novas usando o menu <menuchoice
><guimenu
>Arquivo</guimenu
> <guisubmenu
>Exportar para HTML</guisubmenu
> <guimenuitem
>Baixar novas folhas de estilo</guimenuitem
></menuchoice
>. </para>
  <screenshot>
    <screeninfo
>Janela Configurar o &klinkstatus;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="identification-settings.png" format="PNG"/>
      </imageobject>
      <textobject>
	<phrase
>Identificação</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  <para
>Usando a página <guilabel
>Identificação</guilabel
> você pode configurar a maneira que o &klinkstatus; se reporta ao servidor que armazena a página verificada. Você pode optar por <guilabel
>Enviar identificação</guilabel
>. Use o botão <guibutton
>Padrão</guibutton
> para definir a identificação padrão ou &konqueror;. O painel <guilabel
>Identidade</guilabel
> pode ser usada para selecionar sua identidade para autenticação no servidor. </para>
  <screenshot>
    <screeninfo
>Janela Configurar o &klinkstatus;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="mail-transport-settings.png" format="PNG"/>
      </imageobject>
      <textobject>
	<phrase
>Transporte de mensagens</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  <para
>Usando a página <guilabel
>Transporte de mensagens</guilabel
>, você pode configurar a conta de e-mail que recebe os resultados de verificação agendados pelo &klinkstatus;. </para>
</chapter>

<chapter id="credits">

<title
>Créditos e Licença</title>

<para
>&klinkstatus; </para>
<para
>Direitos autorais do programa 2004 Paulo Moura Guedes <email
>pmg&#64;netcabo&#46;pt</email
> </para>
<para
>Direitos autorais da documentação 2004 Paulo Moura Guedes <email
>pmg&#64;netcabo&#46;pt</email
> </para>

<para
>Tradução de Marcus Gama <email
>marcus.gama@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<chapter id="installation">
  
<title
>Instalação e compilação</title>
&install.intro.documentation; &install.compile.documentation; </chapter>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
-->

