Seus arquivos e dados
Saiba o que acompanha um projeto e como fazer backup do código-fonte, do histórico e dos dados do aplicativo.
O seu manuscrito é uma pasta de arquivos de origem comuns. Você pode abrir esses arquivos com outro editor, fazer backup deles ou tirá-los do Oleafly.
Arquivos do projeto
Seção intitulada “Arquivos do projeto”Os projetos da biblioteca normalmente ficam em ~/.oleafly/projects/. Um projeto pode conter um documento principal em LaTeX, Typst ou Markdown, uma bibliografia, figuras e material de pesquisa.
O project.json registra a identidade e as configurações do projeto, incluindo o documento principal, o motor e a versão fixada do Typst. Um diretório .git guarda o histórico do Git. Um projeto que o Oleafly cria ou importa normalmente começa com um commit dos arquivos dele, chamado “Criar projeto” (veja Git e controle de versão). O diretório .oleafly/build/ contém a saída de compilação gerada e pode ser recriado compilando.
Um projeto Typst pode guardar cópias dos pacotes que importa em uma pasta typst-packages, e assim compila sem conexão e em outros computadores. O Typst também usa as fontes da pasta fonts de um projeto. As duas pastas acompanham o projeto.
Uma pasta que você abre no próprio lugar continua onde está. O Oleafly guarda as compilações, as configurações, os pontos de verificação e os chats dessa pasta na própria pasta de dados dele, então nada é acrescentado à sua.
Dados guardados fora do projeto
Seção intitulada “Dados guardados fora do projeto”As preferências do aplicativo, as credenciais criptografadas dos provedores, os registros de chat e de uso, as ferramentas baixadas, como versões extras do Typst, e os pontos de verificação salvos pertencem ao armazenamento local do aplicativo. Também pertencem a ele as cópias de um projeto que o Oleafly guarda de antes de cada turno do assistente ou de agente, que permitem desfazer os arquivos que esse turno alterou. A cópia da sua biblioteca do Zotero que a busca com @ lê também fica lá, e não no projeto. Copiar a pasta de um manuscrito não copia todos esses dados do aplicativo.
As pastas vinculadas permanecem nos locais originais delas. Um pacote do código-fonte não inclui o conteúdo delas só porque você as vinculou.
Onde ficam as notas
Seção intitulada “Onde ficam as notas”As Notas são arquivos Markdown no seu computador. Cada nota pessoal é uma pasta dentro da pasta de projetos, ao lado dos projetos da sua biblioteca. Uma nota de projeto é um arquivo .md na pasta notes do projeto, então viaja com o projeto. Veja Onde as notas ficam armazenadas para a pasta no Windows, no macOS e no Linux e para o que a pasta de uma nota contém.
Onde fica o TinyTeX
Seção intitulada “Onde fica o TinyTeX”Quando você instala o TinyTeX em Configurações → Motores → LaTeX, o Oleafly o coloca em ~/.oleafly/tinytex. O Windows é a exceção quando o nome da sua pasta de usuário tem letras acentuadas ou não latinas, como um nome coreano ou chinês, porque o TeX Live não roda a partir de uma pasta assim. O TinyTeX então vai para uma pasta chamada Oleafly- mais um código curto dentro de ProgramData, que costuma ser C:\ProgramData. Não é preciso acesso de administrador. Se o Oleafly também não conseguir preparar essa pasta, ele avisa. Você pode continuar compilando com o Tectonic, ou instalar o TeX Live por conta própria em C:\texlive.
A linha do TinyTeX em Gerenciar as distribuições TeX mostra a pasta; passe o mouse sobre o caminho borrado para lê-lo. Remova o TinyTeX por essa linha, em vez de apagar a pasta à mão.
Faça backup do seu trabalho
Seção intitulada “Faça backup do seu trabalho”| O que você quer manter | Como manter |
|---|---|
| Código-fonte do manuscrito e recursos do projeto | Copie a pasta do projeto ou exporte um ZIP do código-fonte |
| Commits do Git | Faça backup do repositório ou envie (push) ao remoto configurado |
| Pontos de verificação salvos | Exporte um arquivo de histórico criptografado no Versionamento |
| Preferências do aplicativo e registros locais | Inclua o diretório de dados do Oleafly no seu backup normal do computador |
| Dados e referências vinculados | Faça backup das pastas originais deles |
| Projetos e configurações da biblioteca, fora deste computador | Ative a sincronização na nuvem para manter uma cópia no seu Dropbox |
Um ZIP do código-fonte exclui caches de compilação e o Git. Use a sincronização com o GitHub para um repositório remoto e os arquivos de histórico de pontos de verificação para o histórico de pontos de verificação.
Mude para outro computador
Seção intitulada “Mude para outro computador”Instale o Oleafly e copie ou clone o projeto do manuscrito. Reconecte as pastas vinculadas e os provedores de modelos nessa máquina. O projeto carrega a escolha de compilador e os metadados dele; ferramentas ou pacotes adicionais podem precisar de instalação. Um projeto Typst que fixa uma versão que este computador não tem oferece baixá-la antes de compilar.
Caminhos na tela
Seção intitulada “Caminhos na tela”Caminhos dentro da sua pasta pessoal aparecem como ~/… nas Configurações, no histórico de versões, nos detalhes de motores e de agentes e no chat. Nas Configurações, os caminhos de arquivos e pastas também ficam borrados até você passar o mouse sobre eles ou alcançá-los com Tab, para que uma captura de tela não mostre onde os seus arquivos estão.
Acesso à rede
Seção intitulada “Acesso à rede”A escrita e a revisão local acontecem na sua máquina. A IA hospedada recebe o contexto fornecido ao provedor selecionado. As ferramentas que leem imagens e PDFs digitalizados usam um modelo local do Ollama, a menos que você escolha um modelo hospedado ou o Mathpix para elas, e então o arquivo vai para esse serviço. As citações do Zotero conversam com o aplicativo do Zotero no seu computador, ou com o zotero.org quando você conecta uma conta. A busca de citações, a importação do Zotero, as ferramentas do alphaXiv, a sincronização com o GitHub, os downloads de pacotes e de versões do Typst, outros downloads e as verificações de atualização contactam os respectivos serviços. A colaboração em tempo real envia cada projeto compartilhado ao servidor de colaboração em que ele está compartilhado. A sincronização na nuvem envia os seus projetos e configurações da biblioteca para o seu próprio Dropbox. Abrir Configurações → Ajuda e sobre busca números públicos: as contagens de estrelas e de forks do projeto no GitHub e quantos membros estão online na comunidade do Discord. As requisições não carregam informação de conta, projeto ou uso, e o modo offline pula a do Discord. O Tectonic e o Typst dão suporte à compilação com cache pelo modo offline.