# Notas em projetos e notas compartilhadas

Vincule uma nota a um projeto, guarde notas na pasta de notas de um projeto e escreva uma nota com outras pessoas por um servidor de colaboração.

As Notas são um experimento e ficam desligadas até você ativá-las. Veja [Ative as Notas](/docs/notes/#turn-on-notes).

Uma nota pode pertencer a um projeto de duas maneiras. Uma nota pessoal vive nas Notas, e você pode vinculá-la a um projeto. Só você a vê. Uma nota de projeto é um arquivo na pasta `notes` do projeto, então viaja com o projeto, e todos com quem o projeto é compartilhado também a têm.

## Vincule uma nota a um projeto

O cabeçalho de uma nota nas Notas mostra onde ela está: um ícone de casa para o **Início das Notas**, depois o projeto dela, depois o título.

![O cabeçalho de Long-context LLMs: thesis hub mostra onde ela está, do ícone de casa ao projeto LLaMA e ao título dela, e a barra lateral a lista sob esse projeto.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-workspace-dark-window-v2.png#view=0,0,1060,930)

1. Abra a nota nas Notas.
2. No cabeçalho, selecione o nome do projeto. Uma nota sem projeto mostra **Escolher projeto** ali.
3. Escolha um projeto na lista. **Nenhum projeto** remove o vínculo.

**Vincular a um projeto**, no menu **Mais** da nota, faz o mesmo, e o menu que você abre clicando com o botão direito na nota na barra lateral das Notas também. Para vincular a nota a um projeto que ainda não existe, selecione **Novo projeto** no cabeçalho da nota. O projeto que você cria fica vinculado à nota.

Uma nota vinculada continua sendo uma nota pessoal. Ela fica nas Notas, e ninguém com quem você compartilha o projeto a recebe. O vínculo é guardado só neste computador.

Depois que uma nota está vinculada:

- As citações na nota podem vir da bibliografia do projeto.
- O assistente na nota pode ler os arquivos do projeto, e o assistente no projeto recebe o título da nota e um resumo curto. [Notas com IA](/docs/notes/ai/) tem os detalhes.

## O painel Notas em um projeto

Com um projeto aberto, selecione **Notas** no trilho lateral do projeto, ou execute **Abrir as notas deste projeto** na paleta de comandos. O painel tem duas listas:

- **Notas do projeto** são arquivos na pasta `notes` do projeto. Todos que têm o projeto as têm.
- **Minhas notas** são as suas notas pessoais vinculadas a este projeto. Elas ficam nas Notas.

![No projeto LLaMA, o painel Notas tem uma lista Notas do projeto vazia e quatro notas pessoais em Minhas notas, vinculadas ao projeto só neste computador.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-project-panel-dark-window-v2.png#view=0,0,700,580)

Quando as duas listas juntas têm mais de oito notas, um campo de busca aparece acima delas.

### Notas pessoais em um projeto

Selecione **Nova nota pessoal** (**+**) ao lado de **Minhas notas**, ou execute **Nova nota pessoal para este projeto**, para começar uma nota pessoal vinculada ao projeto. Ela abre em uma aba ao lado dos seus arquivos. A aba diz **Nota pessoal** e **Só você pode ver esta nota**, ou **Compartilhada a partir de Notas** se você compartilhou a nota. **Abrir em Notas** abre a mesma nota nas Notas.

Cada linha em **Minhas notas** mostra quando você editou a nota pela última vez. O menu dela tem **Mover para o projeto**, **Abrir em Notas**, **Renomear**, **Desvincular deste projeto** e **Mover para a Lixeira**. Depois que você desvincula uma nota, a mensagem oferece **Desfazer**.

## Notas de projeto

Uma nota de projeto é um arquivo Markdown em `notes/<Title>.md` no projeto. O front matter dela diz `kind: note`, o que faz o Oleafly abri-la como uma nota. Um arquivo Markdown em `notes` sem essa linha não aparece em **Notas do projeto** e abre como qualquer outro arquivo Markdown.

### Crie uma nota de projeto

1. Selecione **Notas** no trilho lateral do projeto.
2. Selecione **Nova nota do projeto** (**+**) ao lado de **Notas do projeto**. O Oleafly cria `notes/Untitled.md` e o abre.
3. Digite um título no campo que aparece na lista e pressione Enter. O Oleafly renomeia o arquivo para `notes/<Title>.md`.

Se você sair do campo sem digitar um título, a nota continua Untitled. **Nova nota do projeto**, na paleta de comandos, também começa uma nota Untitled. Digite o título dela no topo da nota.

O nome do arquivo acompanha o título:

- Caracteres que alguns sistemas não permitem em nomes de arquivo, como `/`, `\`, `:`, `*`, `?`, `"`, `<`, `>` e `|`, viram espaços.
- O nome para em 80 caracteres.
- Um nome que o Windows reserva para si, como `CON` ou `AUX`, recebe "note" no fim, como em `notes/CON note.md`.
- Quando o nome já está em uso, o Oleafly adiciona um número, como em `notes/Methods-2.md`.

### Abra e edite

Selecione uma nota em **Notas do projeto**, ou abra o arquivo dela na pasta `notes` da árvore de arquivos. Ela abre em uma aba marcada com **Nota do projeto** e **Salva com os arquivos deste projeto**.

- **Editar como Markdown** mostra o código-fonte do arquivo. O banner “Você está editando esta nota como Markdown.” tem **Editar como nota** para voltar. Clique com o botão direito na aba para a mesma troca.
- **Copiar para as minhas notas** cria uma nota pessoal a partir dela, vinculada ao projeto, com as imagens e os arquivos que ela usa. A cópia é uma nota separada.

A lista acompanha a pasta no disco, então quando outro programa adiciona, muda ou remove um arquivo de nota, **Notas do projeto** se atualiza. Ela lê até 200 arquivos Markdown da pasta e diz quantos mais não listou.

Com as Notas desativadas, os arquivos continuam no projeto e abrem como Markdown comum.

### Renomeie

Escolha **Renomear** no menu da linha, ou mude o título no topo da nota. O Oleafly atualiza o título no front matter e renomeia o arquivo para combinar, então renomear Draft para Results transforma `notes/Draft.md` em `notes/Results.md`. Quando outro arquivo já tem esse nome, o nome novo recebe um número.

O Oleafly salva primeiro as suas notas abertas. Se uma delas não puder ser salva, nada é renomeado, e você vê “Algumas notas têm alterações não salvas, então a nota não foi renomeada. Salve-as e tente de novo.”

### Exclua

O último item no menu da linha de uma nota remove a nota. O nome do item, e o que ele faz, dependem de onde o projeto está:

- Em um projeto da sua biblioteca, **Excluir** remove o arquivo. Você não pode desfazer isso.
- Em uma [pasta aberta no lugar](/docs/library/#folders-opened-in-place), **Mover para a Lixeira** move o arquivo para a lixeira do sistema, de onde você pode restaurá-lo.

### Mova uma nota pessoal para o projeto

1. Abra a nota pessoal no projeto e selecione **Mover para o projeto**. Ele também está no menu da linha da nota em **Minhas notas** e no menu de clique com o botão direito da aba.
2. O diálogo avisa que todos no projeto poderão ver e editar a nota. Selecione **Mover para o projeto**.

O Oleafly grava a nota em `notes/<Title>.md`, copia as imagens e os arquivos que a nota usa para `notes/assets` e a abre. A sua cópia pessoal vai para a [Lixeira](/docs/settings/storage/#recycle-bin) em **Configurações → Armazenamento de dados**. Se um arquivo diferente em `notes/assets` já tem o mesmo nome, a cópia recebe um número e os links da nota apontam para ela.

## Notas de projeto em um projeto compartilhado

Quando você [compartilha um projeto](/docs/collaboration/sharing/), a pasta `notes` dele vai junto como qualquer outra pasta, e as suas notas pessoais ficam com você. Com as Notas ativadas, o diálogo **Compartilhar** avisa isso: “As notas do projeto são compartilhadas com todos neste projeto. As notas pessoais continuam privadas.” Quando a pasta não tem notas, ele diz “As notas pessoais continuam privadas. Só as notas da pasta de notas do projeto são compartilhadas.”

Em um projeto compartilhado:

- O painel **Notas** diz “As notas do projeto são compartilhadas com todos neste projeto. Suas notas pessoais continuam privadas.”
- A aba de uma nota de projeto diz **Todos neste projeto podem ver e editar esta nota**.
- Vocês escrevem as notas de projeto juntos enquanto digitam, com o cursor e o nome de cada pessoa na nota.
- Só o proprietário e os editores podem mudar uma nota de projeto. Todos os outros podem lê-la, e a nota diz “Você pode ler esta nota, mas não editá-la.”

## Escreva uma nota com outras pessoas

Você pode compartilhar uma nota pessoal sozinha por um servidor de colaboração, sem um projeto. Você precisa de uma conta no servidor. [Primeiros passos](/docs/collaboration/get-started/) mostra como adicionar um servidor e entrar.

### Compartilhe uma nota

1. Abra a nota nas Notas e selecione **Compartilhar** no cabeçalho dela. **Compartilhar** também está no menu da nota na barra lateral das Notas.
2. Na aba **Pessoas**, escolha o **Servidor**.
3. Confira o resumo. Ele mostra os **Arquivos** e o **Tamanho** da nota e nomeia o servidor que pode lê-los.
4. Selecione **Compartilhar**.

As imagens e os outros arquivos da nota são compartilhados com ela. As configurações do Oleafly e o histórico do Git não são. A mesma aba então mostra **Pessoas com acesso**. Adicione pessoas e escolha as funções delas como faria para um projeto. Veja [Adicione pessoas](/docs/collaboration/sharing/#add-people). Uma nota compartilhada tem uma marca **Compartilhado** na barra lateral e no Início das Notas.

Como nas notas de projeto em um projeto compartilhado, só o proprietário e os editores podem escrever na nota. Revisores, comentaristas e visualizadores podem lê-la, e o assistente também não pode alterá-la por eles.

Para encerrar o compartilhamento, o proprietário seleciona **Parar de compartilhar** na mesma aba, e qualquer outra pessoa seleciona **Sair do projeto**. Quando o proprietário para de compartilhar, todos ficam com a cópia da nota, mas ela deixa de sincronizar. Quando você sai, a sua cópia fica neste computador e deixa de sincronizar. Veja [Pare de compartilhar](/docs/collaboration/sharing/#stop-sharing) e [Saia de um projeto](/docs/collaboration/sharing/#leave-a-project).

### O que os seus colaboradores precisam

- Uma conta no mesmo servidor, com login feito no Oleafly.
- As Notas ativadas.

A nota aparece em **Compartilhados com você** na biblioteca deles, como um projeto compartilhado. **Abrir** a baixa e a abre nas Notas. [Abra um projeto compartilhado com você](/docs/collaboration/get-started/#open-a-project-shared-with-you) cobre a lista e os links.

### Editem juntos

Enquanto outras pessoas estão na nota com você:

- Os avatares delas ficam no cabeçalho da nota. Passe o ponteiro sobre um para ver o nome da pessoa, a função dela e o que ela está fazendo, como **Edição** seguido do título da nota. Selecione um avatar para rolar até o bloco em que essa pessoa está.
- O cursor de cada pessoa aparece na cor dela, com o nome. Uma barra colorida na margem esquerda marca o bloco em que alguém está. Passe o ponteiro sobre ela para ver quem.
- Ao lado dos avatares, o status de sincronização diz se as suas mudanças chegaram a todos, por exemplo **Atualizado** ou **Sincronizando**. [O status de sincronização](/docs/collaboration/working-together/#the-sync-status) lista todos os status.

Uma nota compartilhada fica ativa por vez. Se você passa para outra nota compartilhada enquanto a primeira ainda está aberta na tela, a segunda diz “A edição em tempo real está ativa em outra nota”. Selecione **Editar em tempo real aqui** para levar a edição em tempo real para ela.

### Quando as mudanças não saem

Se o Oleafly não consegue enviar as suas últimas mudanças, um aviso acima da nota diz isso:

- “Suas últimas alterações nesta nota não foram enviadas porque agora você só pode visualizá-la.”
- “O Oleafly não conseguiu enviar suas últimas alterações nesta nota, então elas foram descartadas.”

Selecione **×** para fechar o aviso.

### Sem conexão

Se a conexão cai, continue escrevendo. A nota é salva no seu computador, e o Oleafly se reconecta sozinho e envia as suas mudanças. Enquanto há mudanças esperando, o status de sincronização mostra **Offline. Alterações pendentes:** com um número. [Offline e reconexão](/docs/collaboration/offline/) explica como a reconexão e a mesclagem funcionam.

## Publique uma cópia somente leitura

A aba **Publicar** do mesmo diálogo coloca uma cópia somente leitura de uma nota em um link público. Qualquer pessoa com o link pode lê-la sem fazer login. Você não precisa compartilhar a nota com ninguém antes.

1. Abra a nota nas Notas, selecione **Compartilhar** e depois **Publicar**.
2. Escolha o **Servidor**.
3. Selecione **Publicar**. A aba mostra o **Link público**, com **Copiar link** e **Abrir**.

A página inclui imagens, gráficos, diagramas, matemática, Typst e moléculas. Os blocos HTML, React, CSV, de sequência e de notebook ficam de fora.

A página não acompanha a nota. Depois que você muda a nota, a aba diz “Você alterou esta nota desde a última publicação. Publique de novo para atualizar a página.” Selecione **Publicar de novo** para atualizá-la. **Cancelar publicação** interrompe o link na hora, embora quem salvou uma cópia da página a mantenha. **Notas publicadas**, no cartão de cada servidor em **Configurações → Colaboração**, lista o que você publicou ali.

Alguns limites:

- Só o proprietário da nota pode publicá-la.
- O administrador do servidor precisa ativar **Permitir links públicos de notas** nas configurações do console de administração. Ele fica desligado por padrão.
- Um administrador pode tirar uma página publicada do ar. Até que ele a recoloque, os leitores não conseguem abri-la e você não consegue publicá-la de novo. Você ainda pode cancelar a publicação.
