01 · Visão geral
O que é o Ovenbird
O Ovenbird é um aplicativo para Linux com ambiente GNOME que reúne um editor de documentos LaTeX e uma biblioteca local de referências BibTeX. Os arquivos do projeto continuam em formatos comuns, como .tex e .bib, e permanecem na pasta escolhida pela pessoa que os utiliza.
O aplicativo oferece modos Código (Code) e Visual para editar documentos LaTeX. A biblioteca de referências não depende de um projeto específico: é possível cadastrar referências, pesquisar, filtrar, importar arquivos .bib e exportar uma cópia BibTeX.
02 · Instalação
Requisitos e instalação
- O arquivo publicado é um pacote Flatpak para Linux x86_64.
- É necessário ter Flatpak instalado e configurado. O pacote usa o runtime
org.gnome.Platformversão 51; o arquivo de instalação não inclui esse runtime e o Flatpak pode precisar obtê-lo de uma origem configurada no sistema. - A versão Flatpak 0.2.0 inclui Tectonic para compilar documentos. A primeira compilação pode precisar baixar arquivos de suporte do mecanismo LaTeX.
Se o Flatpak ainda não estiver configurado, consulte as instruções para preparar o sistema. A documentação oficial sobre pacotes Flatpak de arquivo único explica a instalação direta e informa que esse tipo de pacote não inclui suas dependências.
Baixar Ovenbird 0.2.0 para Linux x86_64
- Baixe o arquivo Ovenbird-0.2.0-x86_64.flatpak.
- Se ele estiver na pasta Downloads, abra um terminal e execute:
flatpak install --user "$HOME/Downloads/Ovenbird-0.2.0-x86_64.flatpak"- Confirme a instalação quando solicitado. Depois, abra Ovenbird pelo menu de aplicativos do sistema.
Se o arquivo estiver em outra pasta, substitua o caminho do comando pelo local onde você o salvou. Para abrir pelo terminal após a instalação, use flatpak run io.github.diegopn.ovenbird.
03 · Projetos
Primeira abertura e projetos
Na primeira abertura, o Ovenbird inicia no editor sem um projeto selecionado. Por padrão, nas próximas aberturas ele tenta reabrir o último projeto utilizado. Você pode alterar esse comportamento nas preferências.
Criar um projeto
- Escolha Novo projeto (New project) no menu do aplicativo ou use Ctrl+Alt+N.
- Selecione um documento em branco ou um dos modelos incluídos: ABNT, IEEE, ACM, Elsevier ou Springer Nature.
- Escolha a pasta onde o projeto será criado, informe um nome e confirme em Criar (Create).
O aplicativo prepara uma pasta de projeto com os arquivos do ponto de partida escolhido. Os modelos são uma estrutura inicial; confira as instruções atuais da instituição ou publicação a que o documento se destina.
Abrir um projeto ou documento
Para abrir uma pasta de projeto, use Abrir projeto (Open project) ou Ctrl+Alt+O. Para abrir um único arquivo, escolha Abrir documento (Open document) ou use Ctrl+O.
Preferências de abertura
Abra o menu principal do aplicativo e escolha Preferências (Preferences). Em Abrir ao iniciar, escolha entre o editor LaTeX e a biblioteca de referências. A opção Reabrir o último projeto ao iniciar vem ativada; desative-a se preferir começar sem restaurar o projeto anterior.
As preferências também permitem escolher o tema Automático, Claro ou Escuro e definir a pasta inicial dos diálogos de arquivos. Por padrão, eles começam em Downloads. Use Escolher pasta para selecionar outra pasta ou Redefinir para voltar ao padrão.
04 · Edição
Edite e compile seu documento
Abra um arquivo .tex pela lista de arquivos do projeto. Os modos Código (Code) e Visual trabalham sobre o mesmo documento. Use Ctrl+S para salvar e Ctrl+F para localizar texto no documento.
O modo Visual reconhece um subconjunto dos comandos e ambientes LaTeX. Trechos que não são representados visualmente permanecem disponíveis como código-fonte; volte ao modo Código para editá-los diretamente. Para entrar no modo Visual, o documento precisa conter \begin{document} e \end{document}.
As ferramentas do editor incluem inserção e formatação de elementos como listas, tabelas, equações, imagens, links, notas e citações. A disponibilidade da representação Visual depende do elemento e da estrutura LaTeX usada.
Compilar e ver o PDF
Use Compilar (Compile) ou o atalho Ctrl+Shift+R. O Ovenbird procura latexmk, pdflatex ou Tectonic; a versão Flatpak 0.2.0 inclui Tectonic. Após uma compilação bem-sucedida, o PDF aparece na área de visualização. Consulte o status da compilação para identificar mensagens de erro.
05 · Referências
Organize a biblioteca BibTeX
Abra Referências (References) na navegação lateral para acessar a biblioteca local. Use Adicionar referência (Add reference) para cadastrar uma obra e preencher seus dados bibliográficos. A busca e os filtros permitem localizar registros por autor, ano, etiqueta ou tipo. Na versão 0.2.0, as listas de referências, etiquetas e autores também foram ajustadas para navegar melhor por bibliotecas grandes.
Importar, exportar e citar
- Importar BibTeX (Import BibTeX): selecione um arquivo .bib; as referências importadas passam a fazer parte da biblioteca local.
- Exportar BibTeX (Export BibTeX): escolha onde salvar uma cópia .bib das referências da biblioteca.
- Inserir citação (Insert citation): abra e salve um documento LaTeX, depois use essa ação ou Ctrl+Shift+C para escolher uma referência da biblioteca. A opção Citação insere a chave BibTeX no documento; a opção Referência bibliográfica insere uma referência formatada no próprio documento.
A biblioteca local é independente dos arquivos de cada projeto. Para que uma citação por chave seja encontrada na compilação, a entrada correspondente precisa estar em um arquivo .bib do projeto declarado no documento principal com \bibliography{...} ou \addbibresource{...}. A biblioteca local, por si só, não é incluída automaticamente na compilação. Você pode abrir um arquivo .bib do projeto e usar Adicionar referência bibliográfica (Add bibliographic reference) para copiar uma entrada da biblioteca local para esse arquivo.
06 · Dados
Onde ficam os arquivos e como fazer cópias
Os documentos e arquivos de cada projeto ficam na pasta escolhida quando o projeto é criado ou aberto. A biblioteca e as configurações do aplicativo ficam separadas dos arquivos do projeto.
Na instalação Flatpak padrão, os dados locais ficam sob ~/.var/app/io.github.diegopn.ovenbird/data/ovenbird/. Essa pasta contém a biblioteca library.bib e arquivos auxiliares de etiquetas e autores, como tags.json, authors.json e author_profiles.json. As configurações ficam em ~/.var/app/io.github.diegopn.ovenbird/config/ovenbird/settings.json.
Para uma cópia de segurança completa, feche o Ovenbird e copie a pasta inteira do projeto, além das pastas data/ovenbird/ e config/ovenbird/ desses caminhos. Para guardar apenas uma cópia portátil das referências bibliográficas, use Exportar BibTeX e salve o arquivo .bib em outro local.
O Flatpak usa diretórios de dados e configuração próprios para cada aplicativo. Veja a documentação sobre os diretórios XDG no Flatpak.
07 · Solução de problemas
Problemas comuns
O último projeto não pode ser reaberto
Se a pasta do projeto foi movida ou removida, o Ovenbird não consegue restaurá-la ao iniciar. Abra a pasta novamente com Abrir projeto ou Ctrl+Alt+O. Você também pode desativar Reabrir o último projeto ao iniciar em Preferências.
O pacote não instala
Confirme que o Flatpak está instalado e configurado e que o sistema pode obter o runtime GNOME Platform 51 solicitado pelo pacote. O arquivo .flatpak não inclui dependências; por isso, a instalação pode precisar baixá-las de uma origem Flatpak configurada.
A compilação informa que não encontrou um mecanismo LaTeX
O pacote publicado inclui Tectonic. Se estiver usando uma compilação instalada de outra forma, o Ovenbird também procura latexmk e pdflatex. A primeira compilação com Tectonic pode precisar baixar arquivos de suporte.
O modo Visual não abre o documento
Use o modo Visual em um arquivo .tex que contenha \begin{document} e \end{document}. Para trabalhar com macros ou estruturas que não são representadas nesse modo, volte ao modo Código.
A bibliografia não compila ou a citação não é inserida
Salve o documento LaTeX antes de inserir uma citação. Em erros de bibliografia, confira a mensagem de compilação e se o mecanismo necessário está disponível: documentos que usam BibTeX precisam desse suporte; documentos com biblatex podem precisar de Biber, latexmk ou Tectonic.
Se o problema continuar, registre o sistema utilizado, o passo que falhou e a mensagem exibida no formulário de problemas do projeto.
08 · Identificação
Ficha do software e deste manual
Software documentado
- Nome
- Ovenbird
- Desenvolvedor do software
- Diego Pereira do Nascimento
- Versão documentada
- 0.2.0
- Plataforma e pacote
- Linux · GNOME Platform 51 · Flatpak x86_64
- Licença do aplicativo
- GNU GPL versão 3 ou posterior (GPL-3.0-or-later)
- Tecnologias
- Rust · GTK 4 · Libadwaita · GtkSourceView
Autoria e edição do manual
- Autoria do manual
- Diego Pereira do Nascimento · ORCID 0009-0008-6487-9890
- Edição do manual
- 1ª edição
- Versão do aplicativo descrita
- 0.2.0
- Atualização desta edição
- Primeiro registro no repositório
- 9 de outubro de 2026
- Publicação original no site
- Data não confirmada; o primeiro registro no histórico do repositório não comprova quando a página foi publicada.
Links do projeto
Para salvar este manual em PDF, use a opção de impressão do navegador e escolha “Salvar como PDF”.