Edicao de texto e codigo na HP Prime.

PrimeEdit e um editor de texto/codigo: escreva e
edite notas em texto simples (.txt/.md), scripts
MicroPython (.py), arquivos JSON (.json) e
programas reais do catalogo da HP Prime (.hppl)
diretamente na calculadora. Numeros de linha,
quebra de linha com rolagem horizontal, busca e
substituicao, desfazer/refazer, um tema escuro com
realce de sintaxe ao estilo VS Code para
.py/.hppl/.json, autocompletar, um catalogo de
comandos navegavel, paineis de
operadores/simbolos/tabela de caracteres, cores
personalizaveis por tipo de arquivo, e selecao de
texto com copiar/recortar/colar tornam pratico
escrever e corrigir codigo real no dispositivo,
nao apenas visualiza-lo.


PrimeEdit - Tutorial rapido (PT)
=================================

Objetivo
- Editar notas .txt/.md, scripts .py, arquivos
  .json e programas .hppl do catalogo na HP Prime,
  com numeros de linha, busca/substituicao,
  desfazer/refazer, realce de sintaxe,
  autocompletar e suporte a toque.

Inicio e arquivos
- Ao iniciar: primeiro aparece uma tela de
  abertura de 2 segundos (nome do app, versao,
  data), depois reabre o ultimo arquivo se
  save_config_files.txt existir, incluindo um
  programa .hppl do catalogo. Essa tela so pode
  ser desativada editando settings.json
  diretamente.
- O aplicativo bloqueia o desligamento automatico
  da calculadora (tempo de espera ampliado) e
  desativa o escurecimento da tela; ambos sao
  restaurados ao sair (Esc).
- Salvamento automatico ativado por padrao; salva
  a cada N minutos (5 por padrao, ajustavel pelo
  painel de opcoes ou por um icone de menu), mas
  somente se o buffer tiver alteracoes nao salvas:
  salva silenciosamente se o arquivo ja tiver
  nome, ou pergunta caso contrario.
- Icones Novo
  (.txt/.json/.py/.hppl)/Abrir/Salvar/Salvar
  como. Salvar nunca pede um nome de arquivo,
  somente Salvar como pede. Salvar com um nome que
  ja existe pede confirmacao antes de
  sobrescrever.
- Salvar como permite escolher sob qual aplicativo
  instalado um arquivo .txt/.md/.py/.json e salvo
  (padrao: o proprio PrimeEdit); um nome terminado
  em .hppl e escrito em vez disso como um programa
  real do catalogo por meio do mecanismo
  Programs(). Um icone dedicado "abrir um
  programa" permite abrir e modificar diretamente
  um programa existente do catalogo.

Navegacao e visualizacao
- Cursor: setas, Inicio/Fim, pagina
  acima/abaixo. Tocar em qualquer parte do texto
  posiciona o cursor ali; arrastar rola a tela.
- As linhas se dobram em 80 colunas, de
  preferencia apos um espaco; alem disso, a
  rolagem horizontal (arrastar o toque, ou o
  cursor acompanhando automaticamente ao digitar)
  revela o restante da linha. Mesmo comportamento
  para todos os tipos de arquivo.
- A coluna de numeros de linha pode ser ocultada
  no painel de opcoes (veja abaixo) para ganhar
  largura de dobra.
- O cursor pisca de forma constante para que a
  posicao seja sempre encontrada.

Digitar texto
- Os caracteres sao digitados pelo layout fisico
  do teclado ALPHA/Shift, exatamente como nos
  aplicativos nativos da calculadora.
- ALPHA e Shift seguem cada um um ciclo desligado
  -> uma vez -> travado: um toque para um unico
  caractere, dois toques rapidos para travar, um
  terceiro toque para liberar.

Busca, substituicao, ir para linha e
desfazer/refazer
- Plot abre a caixa de busca (ou encontra a
  proxima ocorrencia se um termo ja estiver
  definido); View abre "ir para linha"; Menu/Symb
  abrem o menu e a paleta de cores. Nenhuma dessas
  teclas e uma tecla de digitacao, entao todas as
  teclas do teclado ficam livres para edicao.
- Cas desfaz a ultima alteracao, Num a refaz (32
  niveis por padrao, ajustavel pelo painel de
  opcoes) - as mesmas acoes das linhas
  "Desfazer"/"Refazer" do painel de opcoes.

Tipos de arquivo: .txt, .md, .py, .json e .hppl
- Os arquivos .txt/.md sao exibidos por padrao em
  texto preto simples sobre branco (tema claro);
  os arquivos .py/.hppl/.json mudam por padrao
  para um tema escuro (fundo preto, texto branco)
  com realce de sintaxe completo. Essas cores sao
  totalmente personalizaveis, veja "Painel de
  cores" abaixo.
- Abriu um arquivo .hppl diretamente do catalogo
  de programas da calculadora? Ele e exibido com a
  mesma visualizacao realcada de um arquivo .hppl
  local, e recarrega automaticamente na proxima
  inicializacao.

Painel de cores
- Um icone dedicado no banner, logo a direita do
  icone de hamburguer (dois pequenos quadrados
  mostrando as cores atuais de texto/fundo), abre
  um painel que agrupa 10 ajustes, distribuidos em
  varias paginas: cor de fundo e de texto do
  buffer, do banner, da barra de status, dos
  paineis e da coluna de numeros de linha.
- Cada linha reabre a roda de cores circular para
  escolher uma cor livre (RGB). As 10 cores sao
  ajustadas de forma independente para cada tipo
  de arquivo (.txt/.md compartilham o mesmo
  ajuste, .py/.hppl/.json tem cada um o seu) -
  trocar de arquivo aplica automaticamente as
  cores do tipo correspondente.
- Seta para cima/baixo navegam pelo painel pelo
  teclado, Enter abre a roda de cores na linha
  selecionada (ou muda de pagina nas linhas
  "Proximo"/"Voltar"); tocar fora do painel o
  fecha.

Realce de sintaxe
- O codigo .py/.hppl/.json e desenhado com uma
  fonte bitmap propria de tamanho fixo, de modo
  que palavras-chave, strings, comentarios e
  numeros tem cada um sua propria cor, seguindo o
  esquema "Dark+" do VS Code, amplamente
  reconhecido.

Autocompletar
- Ao digitar um identificador em um arquivo .py ou
  .hppl, um popup de sugestoes se abre
  automaticamente apos 2 caracteres digitados -
  palavras-chave, nomes de biblioteca/API
  embutida, e identificadores ja usados em outra
  parte do arquivo contam todos.
- Seta para cima/baixo movem a selecao dentro do
  popup sem nunca mover o cursor no
  texto. Pressionar Enter apos usar as setas
  insere a sugestao destacada; pressionar Enter
  sem ter navegado na lista apenas inicia uma nova
  linha como de costume, para nunca perder uma
  quebra de linha por acidente.
- Tocar em uma sugestao a aceita diretamente. Uma
  funcao ou metodo real e inserido com seus
  parenteses ja no lugar, cursor entre eles,
  pronto para os argumentos; uma palavra-chave ou
  um identificador simples e inserido como esta.
- O autocompletar pode ser desativado no painel de
  opcoes se for incomodo.
- Ele nunca e acionado dentro de um comentario (#
  ou //) nem de um bloco """ do Python, mesmo que
  abranja varias linhas.

Catalogo de comandos
- Em um arquivo .py ou .hppl, um segundo icone no
  banner superior (mostra "py"/"ppl", a direita)
  abre um catalogo completo e navegavel: comandos
  HPPL agrupados por categoria (grafico, strings,
  listas, estruturas de controle, e mais), ou
  MicroPython agrupado por modulo, com classes e
  seus metodos aninhados um nivel abaixo.
- Navegue com Proximo/Voltar, toque em uma entrada
  para inseri-la no cursor. Isso serve para
  descobrir um comando cujo nome exato voce nao
  lembra, como alternativa a digitar um prefixo no
  popup de autocompletar.

Paineis de operadores, simbolos e tabela de
caracteres
- Shift+6 abre uma grade de operadores de
  comparacao/logicos (<= >= != AND OR NOT...) de
  acordo com a linguagem do arquivo aberto;
  Shift+9 abre uma grade de simbolos e letras
  gregas (-> infinito ° ' " & Å alfa beta
  gama...). Ambos estao disponiveis em todos os
  tipos de arquivo, toque em uma entrada para
  inseri-la no cursor.
- Shift+Vars (ou a linha "Tabela de caracteres" no
  painel de opcoes) abre um navegador de blocos
  Unicode comuns (latim, grego, cirilico,
  simbolos...) com acesso rapido as letras
  acentuadas fixado no topo da lista, para inserir
  um caractere ausente do teclado fisico.

Painel de opcoes
- Tocar no icone de hamburguer (tres barras, no
  canto superior esquerdo do banner) ou a tecla
  Apps abre um painel compacto de ajustes e acoes:
  - Numeros de linha: mostrar ou ocultar a coluna.
  - Autocompletar: ativar ou desativar o popup de
    sugestoes.
  - Salvamento: intervalo do salvamento
    automatico, em minutos.
  - Niveis de desfazer/refazer: quantos niveis sao
    mantidos (32 por padrao).
  - Selecao: armar ou desarmar uma selecao de
    texto ancorada na posicao atual do cursor.
  - Copiar / Recortar / Colar, agindo sobre a
    selecao atual e uma area de transferencia em
    memoria que sobrevive a troca de arquivo.
  - Desfazer / Refazer: as mesmas acoes das teclas
    Cas/Num.
  - Tabela de caracteres: abre o painel de
    caracteres Unicode descrito acima.
- Tocar fora do painel o fecha.

Selecao de texto
- Uma vez armada pelo painel de opcoes, qualquer
  movimento do cursor - setas, Inicio/Fim, saltos
  de pagina, ou um toque em outra parte do texto -
  estende a selecao, exibida como uma faixa
  destacada. Nenhuma combinacao de teclas
  adicional e necessaria.
- Copiar mantem a selecao no lugar apos copiar;
  Colar substitui uma selecao ativa pelo conteudo
  da area de transferencia, como na maioria dos
  editores.

Atalhos (teclas HP Prime)
- Menu: abrir menu. Symb: paleta de cores. Plot:
  buscar / proxima ocorrencia. View: ir para
  linha. Cas: desfazer. Num: refazer. Shift+6:
  operadores. Shift+9: simbolos. Shift+Vars:
  tabela de caracteres. Apps: painel de
  opcoes. Esc: fecha um popup/painel aberto, ou
  sai do aplicativo se nada estiver aberto
  (oferece salvar antes, se houver alteracoes nao
  salvas).
