Estamos preparando um relatório colaborativo no Framapad, alguém cola um esquema no documento e todo o texto desaparece. Esse cenário, relatado no fórum de ajuda Framacolibri, lembra que Framapad é antes de tudo um editor de texto colaborativo, não uma ferramenta de formatação. Inserir uma imagem, portanto, requer algumas precauções que a documentação oficial nem sempre detalha.
Framapad e as imagens: o que o pad realmente gerencia
Framapad é baseado no motor Etherpad. Sua função principal é a inserção de texto sincronizada entre vários usuários. A inserção de imagens existe, mas funciona como uma camada de integração adicionada ao texto, não como um tratamento de imagem nativo.
Concretamente, podemos adicionar um visual de duas maneiras: fazer o upload de um arquivo do seu dispositivo ou colar a URL de uma imagem já hospedada online. Cada método tem suas limitações, e a escolha depende do contexto de trabalho.
Quando se trabalha com um grupo (associação, turma, equipe de projeto), é melhor entender essas limitações antes de iniciar a redação colaborativa. Aliás, há um guia detalhado no site Digiterio para seus projetos que complementa a documentação oficial da Framasoft.

Inserir uma imagem local no Framapad: o método de upload
A situação clássica: temos uma captura de tela ou uma foto no computador e queremos integrá-la ao pad. Aqui estão os passos a seguir.
- Coloque o cursor no local do texto onde a imagem deve aparecer e clique no botão de inserção de imagem na barra de ferramentas do pad.
- Selecione “Fazer upload” na interface que se abre e escolha o arquivo no seu dispositivo. O arquivo é enviado para os servidores da Framasoft.
- Uma vez que o upload esteja concluído, a imagem aparece no documento. Ela aparece em seu tamanho original, o que significa que um visual de alta resolução pode ultrapassar amplamente a área de texto.
Redimensionar após a inserção
A documentação oficial deixa claro: as imagens inseridas mantêm suas dimensões originais. É necessário redimensioná-las manualmente no pad. Nesse ponto, os retornos variam de acordo com os navegadores e as versões do Etherpad utilizadas pela instância do Framapad.
Para evitar surpresas, podemos reduzir o tamanho da imagem antes de fazer o upload. Uma ferramenta básica de recorte (aquela integrada ao sistema operacional é suficiente) permite passar de uma foto de vários megabytes para um visual adequado a um documento de texto.
Integrar uma imagem por URL no Framapad
Segundo caso: a imagem já está publicada em algum lugar online (um host de imagens, um site, um espaço Nextcloud). Não precisamos baixá-la para transferi-la.
Na interface de inserção de imagem, escolhemos a opção de integração por URL. Colamos o endereço direto do arquivo de imagem (aquele que geralmente termina em .jpg, .png ou .gif), e o pad exibe o visual carregando-o de sua fonte remota.
Quando preferir a URL ao upload
A integração por URL é adequada para várias situações concretas:
- Usamos imagens armazenadas em um serviço como Framaspace ou Nextcloud e queremos evitar duplicar os arquivos.
- Vários pads compartilham os mesmos visuais (logo da organização, esquema recorrente). Modificar a imagem fonte atualiza todos os documentos vinculados.
- Trabalhamos a partir de um dispositivo móvel onde o upload direto é menos prático.
O ponto fraco: se a imagem fonte for excluída ou movida, o pad exibirá um link quebrado. Perdemos o visual sem aviso. É melhor hospedar as imagens em um espaço que controlamos.

Erros frequentes ao inserir imagens no Framapad
O fórum de ajuda Framacolibri menciona um caso em que um usuário tentou inserir um PDF em um pad, causando a aparente destruição do documento. Esse tipo de incidente vem de uma confusão: Framapad aceita formatos de imagem comuns, não documentos PDF.
Outro erro clássico: colar uma imagem da área de transferência (Ctrl+V) sem passar pela interface de inserção. O resultado depende do navegador. Em alguns casos, o pad integra a imagem sob a forma de dados codificados, o que aumenta consideravelmente o tamanho do documento e pode desacelerar a sincronização para os outros usuários conectados.
Boas práticas para um pad colaborativo com imagens
Quando se trabalha em grupo, algumas regras simples evitam a perda de dados. Avisar os colaboradores antes de inserir um visual volumoso ajuda a evitar um conflito de edição. Nomear claramente as imagens ajuda a se localizar caso o pad seja exportado depois.
Para projetos que exigem muitos visuais, um pad não é a melhor ferramenta de formatação. Framapad se destaca na redação colaborativa de texto. Se o documento final deve conter muitas imagens posicionadas precisamente, é melhor redigir o texto no pad e depois montar o documento em uma ferramenta dedicada.
Formatos de imagem e limites técnicos do serviço Framapad
Os formatos aceitos são os padrões da web: PNG, JPEG e GIF. Imagens SVG ou formatos menos comuns nem sempre são suportados dependendo da instância do Etherpad.
O tamanho máximo de um arquivo enviado depende da configuração do servidor. Nas instâncias geridas pela Framasoft, esse limite nem sempre é documentado explicitamente. Na prática, um arquivo de imagem de algumas centenas de kilobytes passa sem dificuldades. Além disso, o upload pode falhar silenciosamente.
Para um guia digital ou um relatório de organização, comprimir suas imagens antes da inserção continua sendo a precaução mais confiável. Mantemos um pad responsivo, uma sincronização fluida entre usuários e evitamos surpresas desagradáveis na exportação.



