Codex

autores (intermediário) PmWiki pode ser configurado para permitir autores a fazerem upload e armazenar arquivos e Imagens (saiba como anexá-los). Estes anexos podem ter referência a partir de qualquer página.

Nota: PmWiki é distribuido com uploads desabilitados por padrão. Veja Uploads Admin? para informações sobre como habilitar e configurar a função de upload.
Nota2: Uploads podem ser configurados para todo o site, por grupo ou por página; veja Uploads Admin? para detalhes. Isso determina se todos os uploads irão a um diretório do site, um diretório individual para cada grupo, ou um diretório individual para cada página. Por padrão os uploads são organizados por grupos?.

Attach: Sintaxe

Para adicionar ou "linkar" para um anexo, o autor edita a página para incluir a sintaxe "Attach:" seguido pelo nome do anexo (e.g., "Attach:resumo.pdf"). Quando a página for mostrada, a sintaxe Attach: virá seguida de:

  • Um link para o nome do anexo (se realizado upload, ie já estará no diretório de upload)
  • Um link para um formulário onde o autor poderá especificar o arquivo para ser enviado e usado em um novo anexo (se não tiver sido enviado ainda, ie não estará no diretório de upload)
  • Se o anexo é uma arquivo de image com extensões como .gif, .jpeg, ou .png, será mostrada como image.

Os comportamentos dos links podem ser modificados para

  • prevenir uma imagem anexada de aparecer como uma imagem, coloque entre colchetes duplos (e.g., [[Attach:imagem.jpg]]).
  • ter um link para um anexo aparecer sem "Attach:" no início do link, use [[(Attach:)arquivo.ext]].

Anexos em outras páginas e grupos

Para gerar um link para anexos em outra página no mesmo grupo use

Attach:/arquivo.ext

Para gerar link para um anexo enviado (imagem ou arquivo) de outro grupo, você simplesmente referenciará o grupo para ele mesmo (certifique-se que o "Groupname" tem o ponto após ele).

Attach:Groupname./nome_arquivo.ext

Se o PmWiki estiver configurado com um diretório individual por página utilizada

Attach:Groupname.Pagename/nome_arquivo.ext

Nomes com espaços

Para "linkar" para um nome de arquivo com espaços utilize colchetes, eg

[[Attach:um nome de arquivo com espaços.txt]]

Para anexar um arquivo de image com espaços no nome de modo que se mostra como uma imagem usar um destes workarounds

[[#blank | Attach:imagem com espaço.jpeg]]
[[#1 | Attach:imagem com espaço.jpeg]]

Listando Arquivo Enviados em uma Página

Para listar arquivos que foram enviados, use o markup: (:attachlist:)

Assim irá listar anexos para o grupo atual ou página, dependendo se os anexos estão organizados por grupo ou por página; cada instância incluir um link para o anexo para visualização ou download. Uma lista de anexos será, além disso, mostrada como uma parte dos uploads da página de formulário.

Formulário de Upload / Substituição de Upload

One can go directly to the upload form by appending "?action=upload" to the URI for any page that has file uploads enabled by the Wiki Administrator. Replace a file by simply uploading a new version of the file with the same name.

  • Be sure to clear your browser cache after replacing an upload. Otherwise, it may appear that the original upload is still on the server.

If you put $EnableUploadVersions=1; in your local/config.php, the old versions of the same files are renamed and not removed.

Type and Size Restrictions

For security reasons, the upload feature is disabled when PmWiki is first installed. When enabled uploads are restricted as to the types and sizes of files that may be uploaded to the server (see UploadsAdmin?). PmWiki's default configuration limits file sizes to 50 kilobytes and file extensions to common types such as ".gif", ".jpeg", ".doc", ".txt", and ".pdf". In addition, the administrator can configure the system to require an upload password--see Passwords? and PasswordsAdmin?.

By default the upload allows the following extensions:

'gif','jpg','jpeg','png','bmp','ico','wbmp', # images

Removal

At present uploaded files can only be deleted from the server by the wiki administrator. Any uploads-authorized user may over-write an existing file by uploading another of the same name and extension to the same location.

The administrator may remove an uploaded file by accessing the server via ftp (or via a control panel, if the host offers such a feature). If it works on your installation, the recipe Cookbook:WebAdmin may enable in-wiki access to the server's files.

<< Índice Mestre de Marcações | Índice da Documentação | Tabelas >>

When I upload a file, how do I make the link look like "file.doc" instead of "Attach:file.doc Δ"?

Use parentheses, as in [[(Attach:)file.doc]]. There is also a configuration change that can eliminate the Attach: -- see Cookbook:AttachLinks.

Why can't I upload files of size more than 50kB to my newly installed PmWiki?

Out of the box PmWiki limits the size of files to be uploaded to 50kB. Add

$UploadMaxSize = 1000000; # limit upload file size to 1 megabyte
to your config.php to increase limit to 1MB (for example). See UploadsAdmin? for how to further customize limits. Note that both PHP and webservers also place their own limits on the size of uploaded files.

Why does my upload exit unexpectedly with "Incomplete file received"?

You may be running out of space in a 'scratch' area, used either by PmWiki or by PHP. On *nix, check that you have sufficient free space in /tmp and /var/tmp.

Como faço para que um link de upload permita que alguémfaça outro upload upload (se alguém quiser substituir a velha versão de um arquivo com uma nova versão, por exemplo). Atualmente você tem somente o link de upload quando não existe um arquivo no diretório de upload.

Use a ação de Attach, e clique no simbolo delta (Δ) mostrado ao lado de cada um dos arquivos listados. Se você também não consegue ver a ação de Attach, uploads não devem estar habilitados, você não está autorizado a fazer upload ou a ação de Attach foi comentada or está faltando. Veja também available actions e veja Test?action=upload.

Como eu previno arquivos sem extensão de serem enviados?

Como posso esconder o "Attach:" de todos os anexos?

Veja Cookbook:AttachLinks

Como evitar problemas com caracteres non-ASCII em nomes de arquivos anexos(i.e. "Zażółć geślą jaźń.doc")?

Veja $UploadNameChars = "-\w. !=+"#; # permite exclamações, igualdade, sinal de soma, e hash

Como eu posso gerar um link para um arquivo que tenha uma extensão de 4 letras como por exemplo 'abc.pptx'? Se eu tentar realizar o download dele, esta extensão de arquivo muda automaticamente como 'abc.zip' ? O que é o problema que você acha?

Como eu posso prevenir outros de usarem url's de minhas imagens em outro site?

Veja Cookbook:Prevent Hotlinking


Essa é possivelmente a tradução do original em : PmWiki.Uploads - Links de retorno
Essa tradução se encontra em : PmWikiPtBr.Uploads - Links de retorno
Últimas modificações da tradução feitas em : 10 de setembro de 2011, às 13:00
Últimas modificações feitas no original em : 19 de outubro de 2014, às 02:05