Prelo para VS Code
Extensão oficial da Prelo para editar no VS Code o rascunho de um site seu na Prelo.
Como funciona
- No editor da Prelo, abra Código → Abrir no VS Code e clique em Aceitar e abrir no VS Code.
- O navegador pergunta se pode abrir o VS Code.
- Na primeira vez, o próprio VS Code pergunta se pode instalar a Prelo para VS Code. Clique em Instalar e abrir.
- A Prelo abre uma tela dentro do VS Code com o nome do projeto e o que vai acontecer. Clique em Conectar e abrir.
- A extensão cria a pasta
~/Prelo/<endereço-do-site>, baixa o rascunho e abre o projeto. Se você já estiver com outro projeto aberto, ele abre numa janela nova.
- Edite e salve. Cada salvamento envia só os arquivos que mudaram para o rascunho, e o editor da Prelo e o "Testar site" se atualizam sozinhos.
Salvar não publica. A publicação continua passando pela revisão da Prelo.
PRELO SECURITY: como você sabe que a conexão está ativa
Enquanto o projeto está conectado, aparecem:
- a faixa magenta "PRELO SECURITY" na primeira linha de cada arquivo do projeto, com a política logo acima;
- o escudo na barra de status, com o nome do projeto e o estado (sincronizado, enviando, conflito, não sincronizado ou desconectado);
- o painel "Prelo Security" na barra lateral, com o aviso completo, o que é monitorado, o histórico e os botões de sincronizar e desconectar.
O que é monitorado (e o que não é)
- Somente a pasta do projeto que a extensão criou. Nenhuma outra pasta, documento pessoal, repositório ou aplicativo.
- O que é enviado:
- ao salvar, os arquivos que mudaram (caminho, conteúdo e hash);
- a cada minuto, um sinal de que a conexão está ativa;
- ao desativar a extensão, um aviso.
- Nunca sobem: arquivos ocultos (
.git, .vscode, .env, .prelo), node_modules, senhas e chaves.
- A Prelo nunca executa nenhum comando no seu computador.
Segurança
Conexão: feita por um código de uso único, que vale 5 minutos.
- O acesso fica guardado no cofre do VS Code e vale só para aquele projeto.
- Cada conexão aparece em Conta → Aparelhos.
Conferência no servidor: a Prelo confere tudo o que chega:
- conflito com o que mudou na Prelo;
- regras do plano;
- análise de segurança;
- segredos esquecidos no código.
Se algo não passar, o aviso aparece em Problemas, no próprio arquivo.
Conflito (o arquivo mudou na Prelo): você escolhe entre ver a diferença, manter o seu ou usar o da Prelo. Nada é sobrescrito em silêncio.
Desconectar: pelo comando "Prelo: Desconectar este projeto", no editor da Prelo ou em Conta → Aparelhos.
Limites honestos
Arquivos no seu computador podem ser copiados por quem tem acesso a ele. A Prelo controla o acesso, registra cada sincronização e valida o que chega, mas não impede cópia local. O uso dos modelos segue a licença da Prelo.
Se aparecer "cannot be installed because it was not found"
O VS Code não encontrou a extensão neste computador e não conseguiu baixá-la. Você pode:
- usar Tentar de novo no editor da Prelo;
- ou instalar pelo arquivo: no painel do editor, Baixar a extensão (.vsix). Depois, no VS Code,
Ctrl+Shift+X → ⋯ → Install from VSIX….
Também é possível conectar sem o link: no editor, clique em Copiar a conexão. Depois, no VS Code, Ctrl+Shift+P → Prelo: Conectar com um código do editor → cole.
| |