Edicion de texto y codigo en HP Prime.

PrimeEdit es un editor de texto/codigo: escribe y
edita notas de texto plano (.txt/.md), scripts
MicroPython (.py), archivos JSON (.json) y
programas reales del catalogo de HP Prime (.hppl)
directamente en la calculadora. Numeros de linea,
ajuste de linea con desplazamiento horizontal,
busqueda y reemplazo, deshacer/rehacer, un tema
oscuro con resaltado de sintaxis al estilo VS Code
para .py/.hppl/.json, autocompletado, un catalogo
de comandos navegable, paneles de
operadores/simbolos/tabla de caracteres, colores
personalizables por tipo de archivo, y seleccion
de texto con copiar/cortar/pegar hacen practico
escribir y corregir codigo real en el dispositivo,
no solo verlo.


PrimeEdit - Tutorial rapido (ES)
================================

Objetivo
- Editar notas .txt/.md, scripts .py, archivos
  .json y programas .hppl del catalogo en HP
  Prime, con numeros de linea, busqueda/reemplazo,
  deshacer/rehacer, resaltado de sintaxis,
  autocompletado y soporte tactil.

Inicio y archivos
- Al iniciar: primero aparece una pantalla de
  bienvenida de 2 segundos (nombre de la app,
  version, fecha), luego reabre el ultimo archivo
  si existe save_config_files.txt, incluido un
  programa .hppl del catalogo. Esta pantalla solo
  se puede desactivar editando settings.json
  directamente.
- La aplicacion bloquea el apagado automatico de
  la calculadora (tiempo de espera ampliado) y
  desactiva el atenuado de pantalla; ambos se
  restauran al salir (Esc).
- Autoguardado activado por defecto; guarda cada N
  minutos (5 por defecto, ajustable desde el panel
  de opciones o un icono de menu), pero solo si el
  buffer tiene cambios sin guardar: guarda en
  silencio si el archivo ya tiene nombre, o
  pregunta en caso contrario.
- Iconos Nuevo
  (.txt/.json/.py/.hppl)/Abrir/Guardar/Guardar
  como. Guardar nunca pide un nombre de archivo,
  solo Guardar como lo hace. Guardar con un nombre
  que ya existe pide confirmar antes de
  sobrescribir.
- Guardar como permite elegir bajo que aplicacion
  instalada se guarda un archivo
  .txt/.md/.py/.json (por defecto: el propio
  PrimeEdit); un nombre terminado en .hppl se
  escribe en cambio como un programa real del
  catalogo mediante el mecanismo Programs(). Un
  icono dedicado "abrir un programa" permite abrir
  y modificar directamente un programa del
  catalogo existente.

Navegacion y vista
- Cursor: flechas, Inicio/Fin, avance/retroceso de
  pagina. Tocar en cualquier parte del texto
  coloca el cursor alli; arrastrar hace scroll.
- Las lineas se pliegan a las 80 columnas, de
  preferencia tras un espacio; mas alla, un
  desplazamiento horizontal (arrastre tactil, o el
  cursor siguiendo automaticamente al escribir)
  muestra el resto de la linea. Mismo
  comportamiento para todos los tipos de archivo.
- La columna de numeros de linea se puede ocultar
  desde el panel de opciones (ver mas abajo) para
  ganar ancho de pliegue.
- El cursor parpadea de forma constante para
  encontrar siempre la posicion.

Escribir texto
- Los caracteres se escriben mediante la
  disposicion fisica del teclado ALPHA/Shift,
  exactamente igual que en las aplicaciones
  nativas de la calculadora.
- ALPHA y Shift siguen cada uno un ciclo apagado
  -> una vez -> bloqueado: un toque para un solo
  caracter, dos toques rapidos para bloquear, un
  tercer toque para liberar.

Busqueda, reemplazo, ir a linea y deshacer/rehacer
- Plot abre el cuadro de busqueda (o busca la
  siguiente coincidencia si ya hay un termino
  definido); View abre "ir a linea"; Menu/Symb
  abren el menu y la paleta de colores. Ninguna de
  estas teclas es una tecla de escritura, asi que
  todas las teclas del teclado quedan libres para
  editar.
- Cas deshace el ultimo cambio, Num lo rehace (32
  niveles por defecto, ajustable desde el panel de
  opciones) - las mismas acciones que las lineas
  "Deshacer"/"Rehacer" del panel de opciones.

Tipos de archivo: .txt, .md, .py, .json y .hppl
- Los archivos .txt/.md se muestran por defecto en
  texto negro simple sobre blanco (tema claro);
  los archivos .py/.hppl/.json cambian por defecto
  a un tema oscuro (fondo negro, texto blanco) con
  resaltado de sintaxis completo. Estos colores
  son totalmente personalizables, ver "Panel de
  colores" mas abajo.
- Se abrio un archivo .hppl directamente desde el
  catalogo de programas de la calculadora? Se
  muestra con la misma vista resaltada que un
  archivo .hppl local, y se recarga
  automaticamente en el siguiente inicio.

Panel de colores
- Un icono dedicado en el banner, justo a la
  derecha del icono de hamburguesa (dos pequenos
  cuadrados que muestran los colores actuales de
  texto/fondo), abre un panel que agrupa 10
  ajustes, repartidos en varias paginas: color de
  fondo y de texto del buffer, del banner, de la
  barra de estado, de los paneles y de la columna
  de numeros de linea.
- Cada linea vuelve a abrir la rueda de color
  circular para elegir un color libre (RGB). Los
  10 colores se ajustan de forma independiente
  para cada tipo de archivo (.txt/.md comparten el
  mismo ajuste, .py/.hppl/.json tienen cada uno el
  suyo) - cambiar de archivo aplica
  automaticamente los colores del tipo
  correspondiente.
- Arriba/Abajo navegan por el panel desde el
  teclado, Enter abre la rueda de color en la
  linea seleccionada (o cambia de pagina en las
  lineas "Siguiente"/"Atras"); tocar fuera del
  panel lo cierra.

Resaltado de sintaxis
- El codigo .py/.hppl/.json se dibuja con una
  fuente bitmap propia de tamano fijo, de modo que
  palabras clave, cadenas, comentarios y numeros
  tienen cada uno su propio color, siguiendo el
  esquema "Dark+" de VS Code, ampliamente
  reconocido.

Autocompletado
- Al escribir un identificador en un archivo .py o
  .hppl, se abre automaticamente una ventana de
  sugerencias tras 2 caracteres escritos - cuentan
  palabras clave, nombres de biblioteca/API
  integrada, e identificadores ya usados en otra
  parte del archivo.
- Arriba/Abajo mueven la seleccion dentro de la
  ventana emergente sin mover nunca el cursor en
  el texto. Pulsar Enter tras usar Arriba/Abajo
  inserta la sugerencia resaltada; pulsar Enter
  sin haber navegado la lista simplemente inicia
  una nueva linea como de costumbre, para no
  perder nunca un salto de linea por accidente.
- Tocar una sugerencia la acepta directamente. Una
  funcion o metodo real se inserta con sus
  parentesis ya colocados, cursor entre ambos,
  listo para los argumentos; una palabra clave o
  un identificador simple se inserta tal cual.
- El autocompletado se puede desactivar desde el
  panel de opciones si resulta molesto.
- Nunca se activa dentro de un comentario (# o //)
  ni de un bloque """ de Python, incluso si abarca
  varias lineas.

Catalogo de comandos
- En un archivo .py o .hppl, un segundo icono en
  el banner superior (muestra "py"/"ppl", a la
  derecha) abre un catalogo completo y navegable:
  comandos HPPL agrupados por categoria (grafico,
  cadenas, listas, estructuras de control, y mas),
  o MicroPython agrupado por modulo, con las
  clases y sus metodos anidados un nivel mas
  abajo.
- Navegar con Siguiente/Atras, tocar una entrada
  la inserta en el cursor. Esto esta pensado para
  descubrir un comando cuyo nombre exacto no se
  recuerda, como alternativa a escribir un prefijo
  en la ventana de autocompletado.

Paneles de operadores, simbolos y tabla de
caracteres
- Shift+6 abre una cuadricula de operadores de
  comparacion/logicos (<= >= != AND OR NOT...)
  adaptada al lenguaje del archivo abierto;
  Shift+9 abre una cuadricula de simbolos y letras
  griegas (-> infinito ° ' " & Å alfa beta
  gamma...). Ambos estan disponibles en todos los
  tipos de archivo, tocar una entrada la inserta
  en el cursor.
- Shift+Vars (o la linea "Tabla de caracteres" del
  panel de opciones) abre un navegador de bloques
  Unicode habituales (latin, griego, cirilico,
  simbolos...) con acceso rapido a las letras
  acentuadas fijado al principio de la lista, para
  insertar un caracter ausente del teclado fisico.

Panel de opciones
- Tocar el icono de hamburguesa (tres barras,
  arriba a la izquierda del banner) o la tecla
  Apps abre un panel compacto de ajustes y
  acciones:
  - Numeros de linea: mostrar u ocultar la
    columna.
  - Autocompletado: activar o desactivar la
    ventana de sugerencias.
  - Guardado: intervalo del autoguardado, en
    minutos.
  - Niveles deshacer/rehacer: cuantos niveles se
    conservan (32 por defecto).
  - Seleccion: armar o desarmar una seleccion de
    texto anclada en la posicion actual del
    cursor.
  - Copiar / Cortar / Pegar, actuando sobre la
    seleccion actual y un portapapeles en memoria
    que sobrevive al cambiar de archivo.
  - Deshacer / Rehacer: las mismas acciones que
    las teclas Cas/Num.
  - Tabla de caracteres: abre el panel de
    caracteres Unicode descrito arriba.
- Tocar fuera del panel lo cierra.

Seleccion de texto
- Una vez armada desde el panel de opciones,
  cualquier movimiento del cursor - flechas,
  Inicio/Fin, saltos de pagina, o un toque en otra
  parte del texto - extiende la seleccion,
  mostrada como una banda resaltada. No se
  necesita ninguna combinacion de teclas
  adicional.
- Copiar deja la seleccion en su sitio despues de
  copiar; Pegar reemplaza una seleccion activa con
  el contenido del portapapeles, igual que en la
  mayoria de los editores.

Atajos (teclas HP Prime)
- Menu: abrir menu. Symb: paleta de colores. Plot:
  buscar / siguiente coincidencia. View: ir a
  linea. Cas: deshacer. Num: rehacer. Shift+6:
  operadores. Shift+9: simbolos. Shift+Vars: tabla
  de caracteres. Apps: panel de opciones. Esc:
  cierra una ventana/panel abierto, o sale de la
  aplicacion si nada esta abierto (ofrece guardar
  primero si hay cambios sin guardar).
