<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>AjudaNaConfiguração/CorreioElectrónico</title></articleinfo><section><title>Configuração do Correio Electrónico</title><para>Ver também <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/AjudaNaConfigura%C3%A7%C3%A3o#">AjudaNaConfiguração</ulink>. </para><section><title>Mensagens a enviar</title><para>Para activar o suporte de mensagens a enviar, é necessário especificar o endereço <code>De:</code> com &quot;<code>mail_from</code>&quot;. Depois, é necessário activar um transporte, ou por SMTP (utilize &quot;<code>mail_smarthost</code>&quot; para activá-lo) ou por sendmail (utilize &quot;<code>mail_sendmail</code>&quot; para activá-lo). Se utilizar &quot;<code>mail_smarthost</code>&quot; e o servidor necessitar de autenticação, defina o &quot;<code>mail_login</code>&quot; também.  </para><glosslist><glossentry><glossterm>mail_from</glossterm><glossdef><para>Este valor é utilizado para os cabeçalhos dos campo &quot;<code>De:</code>&quot; e &quot;<code>Para:</code>&quot; das mensagens enviadas (o campo &quot;<code>Para:</code>&quot; por motivos de privacidade de endereço de coreio, a mensagem não é realmente enviada para este endereço, mas não queremos divulgar nenhum endereço verdadeiro). </para></glossdef></glossentry><glossentry><glossterm>mail_smarthost</glossterm><glossdef><para>Isto é o IP ou nome de domínio de um servidor FOLDOC:SMTP. Num servidor Unix, pode tentar utilizar <code>localhost</code>; numa máquina Windows será por norma uma máquina na sua LAN ou algum servidor do seu ISP. </para></glossdef></glossentry><glossentry><glossterm>mail_login</glossterm><glossdef><para>Isto só é necessário quando utiliza o <code>mail_smarthost</code> e um servidor que quer SMTP AUTH para enviar mensagens de correio electrónico; em todo o caso, defina o nome de utilizador e a senha separados por um espaço, ou seja, <code>&quot;utilizador senha&quot;</code>. </para></glossdef></glossentry><glossentry><glossterm>mail_sendmail</glossterm><glossdef><para>Isto é um comando local a executar para enviar uma mensagem. Por exemplo, se definir como '/usr/sbin/sendmail -t -i', utilize este comando sendmail para enviar mensagens de correio electrónico.  Isto é apenas útil em máquinas que tenham um agente de transporte de correio electrónico instalado. </para></glossdef></glossentry></glosslist></section><section><title>Mensagens a receber (apenas 1.6)</title><para>Se quiser importar mensagens para o seu <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink>, ou seja, permitir-lhe receber e guardar as mensagens, tem de configurar algumas coisas. </para><para>Em primeiro lugar, tem de configurar o seu servidor de correio electrónico para enviar todas as mensagens novas para o <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink>. O comando é <code>moin xmlrpc mailimport</code>. Repare que pode utilizar o parâmetro <code>--config /path/to/dir</code> para fornecer o caminho para uma directoria de um ficheiro de configuração adequado do <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink>. Depois, verifique que existe um ficheiro chamado <code>mailimportconf.py</code> nessa directoria. Tem de se assemelhar a isto (existe um ficheiro de exemplo no <code>wiki/config</code>): </para><screen><![CDATA[# Esta senha tem de ser do conhecimento do servidor do wiki
mail_import_secret = u"foo"
]]><![CDATA[
# O URL de destino
mail_import_url = u"http://localhost:81/?action=xmlrpc2"]]></screen><para>A senha é utilizada para permitir que o script se autentique no wiki. O URL é o URL do wiki mais <code>?action=xmlrpc2</code>. </para><para>Agora pode configurar o wiki. Existem as seguintes opções de configuração: </para><glosslist><glossentry><glossterm>mail_import_wiki_addrs</glossterm><glossdef><para>Uma lista de endereços de correio electrónico de destino que deve ser incluída no wiki. O <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink> pesquisa nestes endereços para saber o nome da página de destino, deve corresponder ao endereço familiar para o servidor de correio electrónico. Se utilizar algum género de mecanismo de reencaminhamento, por favor coloque o(s) endereço(s) que os seus utilizadores de wiki utilizam para encaminhar o wiki para essa lista <emphasis>em primeiro lugar</emphasis> e para o(s) endereço(s) para onde reencaminha as suas mensagens <emphasis>depois</emphasis>. </para></glossdef></glossentry><glossentry><glossterm>mail_import_secret</glossterm><glossdef><para>A senha que correspondente ao ficheiro de configuração <code>mailimportconf.py</code>. Ver em cima. </para></glossdef></glossentry><glossentry><glossterm>mail_import_subpage_template</glossterm><glossdef><para>Este é o modelo para o nome da página gerado pelo código de importação de mensagens. Ver em baixo, os campos suportados. </para></glossdef></glossentry><glossentry><glossterm>mail_import_pagename_envelope</glossterm><glossdef><para>O valor desta definição por omissão é <code>u&quot;%s&quot;</code> e apenas significa &quot;utilize o nome da página não modificado&quot;. Pode configurá-lo igualmente para <code>u&quot;+ %s/&quot;</code>, que adiciona um sinal de adição e um carácter vazio em frente do que obtermos e uma barra depois do que obtermos a partir do assunto da mensagem ou do endereço de destino. Isto poupará algum trabalho aos utilizadores se quiser que o comportamento seja activado pelo sinal de adição ou pela barra. </para></glossdef></glossentry><glossentry><glossterm>mail_import_pagename_search</glossterm><glossdef><para>Onde (e por que ordem) deseja pesquisar pelo nome da página de destino. Por omissão, <code>['subject', 'to', ]</code> para pesquisar no assunto em primeiro lugar, e só depois (se não obtiver resultados) para pesquisar nos endereços de destino. </para></glossdef></glossentry><glossentry><glossterm>mail_import_pagename_regex</glossterm><glossdef><para>O padrão (regex) de pesquisa na linha do assunto para determinar o nome da página de destino. Por omissão, é <code>r'\[&quot;([^&quot;]*)&quot;\]'</code> o que pesquisa simplesmente por algo como <code>[&quot;Nome da Página de Destino&quot;]</code> (o mesmo que sintaxe de freelink). </para></glossdef></glossentry></glosslist><para>Depois de configurar as definições explicadas anteriormente, deve conseguir enviar mensagens para si mesmo. A utilização real é explicada em baixo. </para></section></section><section><title>Funcionalidades do Correio Electrónico</title><para>Actualmente, o <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink> oferece dois serviços baseados em correio electrónico, que são explicados nas secções seguintes. </para><section><title>Enviar dados de acesso</title><para>Se o correio electrónico estiver disponível, adiciona-se um campo &quot;Your email address&quot; e um botão &quot;Mail me my account data&quot; à caixa de diálogo das <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/Prefer%C3%AAnciasDoUtilizador#">PreferênciasDoUtilizador</ulink>. O utilizador pode inserir o endereço de correio electrónico que forneceu no registo e receber uma mensagem com todos os dados necessários para reentrar, depois de clicar no botão. </para></section><section><title>Aviso de alteração</title><para>Qualquer utilizador pode subscrever alterações das páginas wiki, clicando no ícone de envelope , ou adicionando um regex ao campo de &quot;Páginas de wiki subscritas&quot; nas suas <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/Prefer%C3%AAnciasDeUtilizador#">PreferênciasDeUtilizador</ulink>. Assim, o sistema envia uma mensagem com o autor, uma ligação à página e as diferenças com a alteração, sempre que uma página for modificada e se o autor não desmarcar a caixa de selecção  &quot;Send mail notification&quot;. O autor não é avisado das suas próprias alterações. </para></section><section><title>Receber mensagens (apenas 1.6)</title><para>É possível receber mensagens no <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink>. Essencialmente, precisa de saber qual o endereço de correio electrónico do wiki e de enviar uma mensagem para esse endereço. Se fornecer um nome de página de destino antes do endereço wiki (escrevendo <code>MinhaPáginaDeWiki &lt;wiki@exemplo.com&gt;</code> por exemplo), conseguirá colocar a sua mensagem no wiki muito facilmente. Existem algumas regras para a sua mensagem: </para><section><title>De</title><para>Verificamos se o cabeçalho De: é de um utilizador válido de wiki. Claro que não oferece uma segurança real, mas é talvez melhor do que nada. </para><para>Ao criar uma tabela geral de mensagens, utilizamos a parte De: do endereço de correio electrónico para tentar pesquisar uma conta de utilizador de wiki com esse endereço de correio electrónico. No caso de encontrarmos algum, estabelecemos a ligação à sua página principal a partir da coluna De: da tabela. Se não encontrarmos uma conta de utilizador correspondente, listamos apenas a parte do nome verdadeiro na coluna De:. </para></section><section><title>Para / Cc</title><para>O Para: é (como sempre) constituído por 2 partes, como <code>MODELO &lt;wiki@exemplo.org&gt;</code>. Utilizamos a parte do &quot;nome verdadeiro&quot; para compor o modelo do nome da página de destino (pode conter caracteres especiais, espaços em branco, etc.) e a parte do endereço de correio electrónico para enviar a mensagem para o destino correcto. A forma mais simples de um modelo de nome de página de destino é um nome de página como <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/P%C3%A1ginaDeTestesWiki#">PáginaDeTestesWiki</ulink>. </para><para>Veja o exemplo para os 2 modos de operação diferentes. </para><para>Ao criar uma tabela geral de mensagens, processamos Para: e Cc: para a coluna Para: da mesma forma que para a coluna De: (ver em cima). Não incluímos o endereço do servidor de wiki (e se só tivermos o servidor de correio electrónico do wiki, apresentamos apenas &quot;-&quot;). </para></section><section><title>Assunto</title><para>O modelo do nome da página pode ser igualmente extraído (e igualmente removido) a partir da primeira ocorrência do mail_import_pagename_regex no assunto. </para><para>Exemplos: </para><screen><![CDATA[Subj: ["Nome da página de destino"] funcionará se o colocar no início ou no fim do assunto.
Subject: blá blá blá ["NomeDaPágina/$date"]]]></screen><para>O texto das mensagens com este assunto será adicionado às páginas </para><screen><![CDATA[Nome da página de destino
ou
NomeDaPágina/2006-07-20T14:48:27]]></screen><para>O assunto completo será igualmente utilizado para criar um comentário de alteração, com o prefixo de &quot;<code>Mail: </code>&quot;; as variáveis não serão substituídas. </para></section><section><title>Corpo da mensagem</title><para>O conteúdo da nova página é feito a partir do conteúdo da página antiga (se existir) mais o conteúdo da mensagem anexada no fim. O conteúdo da página nunca será sobreposto. As mensagens enviadas como <code>alternativas</code> serão exibidas com a sua estrutura de HTML na página que é processada por um parser de HTML. </para><para>Os anexos da mensagem serão colocados numa página de anexos, um nível abaixo da página onde se coloca o conteúdo. Os anexos nunca serão sobrepostos. Os anexos estarão ligados à página de conteúdos (ex: a uma lista de anexos no fim). </para></section><section><title>Conteúdo gerado</title><para>O <ulink url="http://research.math.uvt.ro/wiki/AjudaNaConfigura%C3%A7%C3%A3o/CorreioElectr%C3%B3nico/wiki/WikiMoinMoin#">MoinMoin</ulink> adiciona um item da tabela à página-mãe, listando os detalhes sobre a mensagem, se for solicitado com um sinal de adição <code>+</code> antes (ex: <code>+ NomeDaPágina/</code>). </para></section><section><title>Criação do nome da página</title><para>Os campos <code>$from</code> (que contêm o nome do remetente), <code>$date</code> (a data) e <code>$subject</code> (linha de assunto) são suportados. </para><para>O nome da página é gerado da forma que explicamos seguidamente: </para><orderedlist numeration="arabic"><listitem><para>Verifique se um dos endereços de destino da mensagem (para, cc, ...) está no mail_import_wiki_addrs </para></listitem><listitem><para>Processe PARA/ASSUNTO pela mesma ordem do que a indicada pelo mail_import_pagename_search até encontrarmos um nome de página ou desistirmos: </para><itemizedlist><listitem><para>Tente obter o modelo do nome da página a partir dos endereços de destino, ou </para></listitem><listitem><para>Tente extrair o nome da página a partir do assunto (explicado em cima). </para></listitem></itemizedlist></listitem><listitem><para>Se não encontrámos um nome de página, utilize mail_import_subpage_template como último recurso. </para></listitem><listitem><para>Aplique mail_import_pagename_envelope para acrescentar algo (opcionalmente) ao nome da página. </para></listitem><listitem><para>Se o nome da página terminar com uma barra, anexe a opção de configuração <code>email_subpage_template</code> (ver em cima) ao nome da página. </para></listitem><listitem><para>Expanda o modelo do nome da página para obter o nome da página verdadeiro. </para></listitem></orderedlist></section></section></section></article>