O editor

Salvar e salvamento automático

O que o navegador guarda, o que a conta guarda e quando cada um grava.

Sem sessão

Tudo o que você faz é gravado neste navegador enquanto você trabalha. O documento ao vivo é salvo um quarto de segundo depois que você para de editar, então fechar a aba não perde nada, e reabrir coloca você de volta onde estava.

Apertar Salvar guarda o documento como um projeto neste navegador. Nada sai da máquina, e a dica do botão diz Salvo só neste navegador.

Salvar na minha conta, no menu Salvar, é o único aperto que move o projeto para uma conta grátis.

Conectado

Duas coisas acontecem em vez de uma. A cópia no navegador continua sendo gravada exatamente como acima, e o projeto também é salvo na sua conta cerca de um segundo e meio depois que você para de digitar.

Um projeto inicial, uma aula ou um circuito da galeria que você só abriu ainda não é um projeto da conta. A primeira mudança real no circuito, no código ou no título cria o projeto na sua conta, e toda edição depois disso é salva automaticamente nele. A URL vira /p/<id>, então o link fica estável. Apertar Salvar em um circuito que você não mudou mostra Faça uma mudança, ou aperte Salvar como novo.

Uma exceção: se sua conta ainda não tem projetos, apertar Rodar ou Salvar no primeiro projeto inicial o mantém como seu primeiro projeto, então você tem um mesmo que só tenha rodado o exemplo.

O botão Salvar

É um botão dividido. A metade larga salva. A seta abre o resto:

  • Salvar uma cópia, que bifurca o documento aberto em um segundo projeto.
  • Salvar na minha conta quando você está desconectado.
  • Enviar para a minha turma, quando uma turma passou esse trabalho: salva e entrega.
  • Histórico, para ver e restaurar versões salvas anteriores da conta.
  • Voltar ao meu último projeto, quando abrir um modelo ou um exemplo deixou seu próprio trabalho guardado neste navegador.
  • Baixar JSON, o arquivo de projeto completo do Mokxi (.mokxi.json).
  • Baixar SPICE, um deck .cir do ngspice para a parte analógica do circuito.
  • Abrir JSON ou SPICE…, que abre um projeto do Mokxi ou importa uma netlist SPICE como componentes e fios.
  • Importar um projeto…, para Wokwi, Fritzing, Tinkercad e as outras ferramentas em importar um projeto.
  • Rodar um deck SPICE…, que roda uma netlist sozinha e plota o resultado. Netlists SPICE cobre isso e os dois itens acima.
  • Novo, um projeto vazio.
  • Projetos prontos, os circuitos que vêm com o Mokxi.

Ctrl/Cmd+S faz o que a metade larga faz, de qualquer lugar do editor, inclusive do editor de código.

O estado do salvamento

A própria palavra do botão Salvar mostra como estão as coisas: Salvar enquanto houver mudanças ainda não salvas, Salvando… enquanto uma gravação está em andamento, e Salvo quando terminar. O Salvando fica visível por um instante mesmo quando a gravação não demora nada, assim um salvamento que deu certo continua sendo algo que você viu.

Conectado, Salvo significa que sua conta tem o projeto. Um circuito que você ainda não mudou mostra Salvar, porque ele não está na sua conta.

Quando um salvamento não dá certo

Ele não perde trabalho.

A conexão caiu. Um salvamento automático que não recebe resposta, ou que encontra um erro passageiro do servidor, é reenviado em silêncio, até três vezes ao longo de cerca de um minuto. O botão continua mostrando Salvar nesse meio-tempo. Só se todas falharem o editor mostra Não salvo: não conseguimos falar com o Mokxi. Seu trabalho continua aqui, com Tentar de novo. Ele avisa uma vez, não a cada tecla digitada.

O projeto mudou em outro lugar. Se outra aba ou outro computador salvou este projeto desde que você o abriu, o salvamento automático para e o editor pergunta: Manter o meu salva esta versão por cima (a outra fica no Histórico), e Abrir a outra abre aquela e mantém esta versão neste navegador.

Sua sessão expirou. A conta recusou a gravação, então o documento vai para este navegador e o editor avisa. Entre novamente e aperte Salvar.

Seu plano está cheio. O Grátis salva 10 projetos; o Pro e acima não têm limite, e os projetos que as aulas criam nunca contam. No limite, um projeto novo ou uma cópia fica guardada neste navegador, e um cartão oferece o Pro, um teste de 7 dias dele, ou Liberar espaço. Todos os projetos que você já tem continuam salvando, sejam quantos forem.

Mais sobre o que fazer em um projeto não salvou.

Privado por padrão

Todo projeto salvo começa privado, em qualquer plano: só você pode abri-lo. Para compartilhar, aperte Compartilhar: compartilhar um link é grátis, e Público o coloca na galeria e na sua página de perfil. Alunos em uma turma e crianças menores de 13 anos são sempre privados. Compartilhar um projeto tem os detalhes.

Histórico de versões

Cada projeto na sua conta mantém as últimas duzentas versões salvas, em qualquer plano. Uma versão salva é guardada cada vez que você aperta Salvar (ou Ctrl/Cmd+S) e cada vez que você restaura uma. Os salvamentos automáticos se juntam em uma versão só enquanto você continua editando: uma pausa de mais de um minuto, ou dez minutos de trabalho contínuo, começa a próxima. Assim, a lista é a sua tarde, e não as últimas teclas digitadas. Passadas duzentas, as mais antigas saem.

O plano Grátis abre e restaura as cinco mais recentes, o suficiente para desfazer as últimas mudanças. As mais antigas continuam lá, acinzentadas com um cadeado e Restaurar com o Pro, sob uma nota curta explicando isso; o Pro, o Estudante e o Sala de aula abrem todas, e o mesmo vale para quem é aluno em uma turma paga pelo professor. Voltar de um plano pago para o Grátis não apaga nada: as versões mais antigas ficam bloqueadas, e fazer upgrade de novo as abre.

Abra a lista em Histórico no menu Salvar, ou com Ctrl/Cmd+Shift+H. Ela abre na lateral direita do editor, a versão mais recente no topo, cada linha mostrando há quanto tempo foi e o que aquela versão mudou: "+2 componentes", "Código alterado", ou o nome que recebeu.

Clique em uma linha e aquela versão salva é desenhada no canvas. Você está vendo, não editando: o canvas é somente leitura enquanto ela estiver aberta, nada é gravado na sua conta, e o trabalho que você tinha aberto fica esperando atrás dela.

  • Voltar para agora devolve seu trabalho exatamente como estava. Fechar o painel faz a mesma coisa.

  • Restaurar esta versão torna a versão na tela o projeto de novo. É uma versão salva comum, então o que ela substituiu fica no histórico, então uma restauração sem querer se desfaz restaurando a versão acima dela.

  • Abrir como cópia torna a versão na tela um projeto novo e o editor continua nele. O projeto de origem não é tocado. Todos os planos têm isso; uma cópia é um projeto novo, então o limite de projetos do plano se aplica.

Nomes, estrelas e comparação (Pro)

No Pro, Estudante e Sala de aula, uma versão salva na tela também tem:

  • Nomear esta versão: digite algumas palavras ("Motor funcionando", "Antes de religar") e aperte Salvar nome ou Enter. O nome encabeça aquela linha na lista.
  • Estrela: marca uma versão para encontrar depois. Uma versão nomeada ou com estrela fica guardada para sempre, mesmo passando as duzentas, até vinte por projeto; tire a estrela ou apague o nome para liberar espaço.
  • Comparar com agora (ou Comparar): o que mudou entre esta versão e o seu trabalho, ou entre duas versões quaisquer. As contas vêm primeiro (componentes adicionados, removidos e movidos, fios alterados), depois Componentes e ligações listados antes e depois, e então o código linha por linha. Lado a lado põe a linha antiga à esquerda e a nova à direita; Uma coluna volta tudo a uma lista só com sinais de + e -.

No Grátis, esses três são substituídos por uma nota curta dizendo que vêm com o Pro, e Restaurar e Abrir como cópia funcionam como antes.

O Histórico precisa de um projeto salvo em uma conta. Desconectado, ou em um documento que você nunca salvou, o painel avisa em uma linha: não há nada guardado para listar. O projeto de outra pessoa também tem histórico, e ele é dela, não seu. Faça um remix e o seu próprio histórico começa a partir do remix.

Observando, não editando

Abrir o projeto de outra pessoa, ou entrar em uma sala ao vivo com um link de observação, coloca o editor em estado somente leitura. Apertar Salvar ali faz um remix do projeto como seu, em vez de recusar. Veja compartilhar um projeto.