Uso del editor de cuadernos de Athena

El editor de cuadernos de Athena es un entorno interactivo para escribir y ejecutar código. En las siguientes secciones, se describen las características del entorno.

Modo de comandos frente a modo de edición

El editor de cuadernos tiene una interfaz de usuario modal: un modo de edición para ingresar texto en una celda y un modo de comandos para enviar comandos al propio editor, como copiar, pegar o ejecutar.

Para utilizar el modo de edición y el modo de comandos, puede realizar las siguientes tareas:

• Para ingresar al modo de edición, pulse ENTER o elija una celda. Cuando una celda está en modo de edición, su margen izquierdo está en verde.

• Para entrar en el modo de comandos, pulse ESC o haga clic fuera de una celda. Tenga en cuenta que, normalmente, los comandos solo se aplican a la celda seleccionada actualmente, no a todas las celdas. Cuando el editor está en modo de comandos, el margen izquierdo de la celda está en azul.

• En el modo de comandos, puede utilizar los atajos de teclado y el menú situado encima del editor, pero no puede ingresar texto en celdas individuales.

• Para seleccionar una celda, elíjala.

• Para seleccionar todas las celdas, pulse Ctrl+A (Windows) o Cmd+A (Mac).

Menú del editor de cuadernos

Los iconos del menú situados en la parte superior del editor de cuadernos ofrecen las siguientes opciones:

• Save (Guardar): guarda el estado actual del cuaderno.

• Insert cell below (Insertar celda debajo): agrega una celda nueva (vacía) debajo de la seleccionada actualmente.

• Cut selected cells (Suprimir celdas seleccionadas): elimina la celda seleccionada de su ubicación actual y la copia en la memoria.

• Copy selected cells (Copiar celdas seleccionadas): copia la celda seleccionada en la memoria.

• Paste cells below (Pegar celdas debajo): pega la celda copiada debajo de la celda actual.

• Move selected cells up (Mover celdas seleccionadas hacia arriba): sitúa la celda actual encima de la celda superior.

• Move selected cells down (Mover celdas seleccionadas hacia abajo): sitúa la celda actual debajo de la celda inferior.

• Run (Ejecutar): ejecuta la celda actual (seleccionada). El resultado se muestra justo debajo de la celda actual.

• Run all (Ejecutar todo): ejecuta todas las celdas del cuaderno. El resultado de cada celda se muestra justo debajo de la celda.

• Stop (Interrupt the kernel) (Detener [interrumpir el kernel]): interrumpe el kernel para detener el cuaderno actual.

• Format option (Opción de formato): selecciona el formato de celda, que puede ser uno de los siguientes:

  • Code: se usa para código Python (predeterminado).

  • Markdown: se usa para ingresar texto en formato Markdown al estilo de GitHub. Para renderizar el Markdown, ejecute la celda.

  • Raw NBConvert: se usa para ingresar texto en forma no modificada. Las celdas marcadas como Raw NBConvert se pueden convertir a un formato diferente, como HTML, mediante la herramienta de línea de comandos nbconvert de Jupyter.

• Heading (Encabezado): se usa para cambiar el nivel del encabezado de la celda.

• Command palette (Paleta de comandos): contiene los comandos del cuaderno de Jupyter y sus atajos de teclado. Para obtener más información acerca de los atajos de teclado, consulte las secciones que aparecen más adelante en este documento.

• Session (Sesión): utilice las opciones de este menú para ver los detalles de una sesión, editar los parámetros de la sesión o terminar la sesión.

Atajos de teclado del modo de comandos

A continuación, se presentan algunos atajos de teclado habituales de un editor de cuadernos en el modo de comandos. Estos atajos están disponibles después de pulsar ESC para ingresar al modo de comandos. Para ver una lista completa de los comandos disponibles en el editor, pulse ESC + H.

Clave	Acción
1 - 6	Cambiar el tipo de celda a Markdown y establecer el nivel del encabezado en el número escrito
a	Crear una celda encima de la celda actual
b	Crear una celda debajo de la celda actual
c	Copiar la celda actual en memoria
d d	Eliminar la celda actual
h	Mostrar la pantalla de ayuda de los atajos de teclado
j	Ir una celda más abajo
k	Ir una celda más arriba
m	Cambiar el formato de celda actual a Markdown
r	Cambiar el formato de celda actual a Raw
s	Guardar el cuaderno
v	Pegar el contenido de la memoria en la celda actual
x	Cortar la celda o las celdas seleccionadas
y	Cambiar el formato de celda a Code
z	Deshacer
Ctrl+Enter	Ejecutar la celda actual e ingresar al modo de comandos
Shift+Enter o Alt+Enter	Ejecutar la celda actual, crear una nueva debajo de la salida y hacer que ingrese al modo de edición
Space	Página siguiente
Shift+Space	Página anterior
Shift + L	Para alternar la visibilidad de los números de línea en las celdas

Edición de atajos del modo de comandos

El editor de cuadernos tiene una opción para personalizar los atajos de teclado del modo de comandos.

Para editar los atajos del modo de comandos

1. En el menú del editor de cuadernos, elija Command palette (Paleta de comandos).

2. En la paleta de comandos, elija el comando Edit command mode keyboard shortcuts (Editar atajos de teclado del modo de comandos).

3. Utilice la interfaz Edit command mode shortcuts (Editar atajos del modo de comandos) para asignar o reasignar los comandos que desee al teclado.

   Para ver las instrucciones sobre cómo editar los atajos del modo de comandos, desplácese hasta la parte inferior de la pantalla Edit command mode shortcuts (Editar atajos del modo de comandos).

Para obtener información sobre el uso de comandos mágicos en Athena para Apache Spark, consulte Uso de comandos mágicos.