Skip to content

Guía oficial del usuario

Jump to bottom Edit New page
Victorhck edited this page Jul 2, 2021 · 2 revisions

Contenido

Introducción

Esta guía te mostrará cómo utilizar de manera eficiente ranger. Puedes utilizar el enlace ^ junto a los encabezados, para regresar al índice de contenidos.

Interfaz de usuario ^

La ventana principal muestra de manera predeterminada tres paneles (por cierto, se les llama columnas Miller):

  • la central con el contenido del directorio actual,
  • el de la izquierda muestra el directorio principal, con el directorio actual resaltado,
  • el de la derecha mostrará varias previsualizaciones, hablaremos más sobre él más adelante.

Si estás familiarizado con Vim, te deberías sentir como en casa con las convenciones utilizada en la interfaz de ranger. ranger utiliza las teclas hjkl para navegar y comparte muchos modismos de vim. Por ejemplo: yy (copiar una línea en vim) copia un archivo, pp lo pega y dd corta el archivo. Las funciones más complejas pueden ser llamadas desde la línea de comandos invocadas con :.

Los atributos del archivo actual se muestran en la parte inferior y la ruta del directorio actual se muestra en la parte superior.

:(dos puntos) abre la consola de ranger, donde de manera manual puedes ejecutar comandos.

Para los usuarios de mc

Si estás familiarizado con mc (Midnight Commander) la primera cosa que puedes notar es la falta de un segundo panel para la navegación de archivo. Puede parecer una limitación pero en la mayoría de los casos, las personas utilizan solo un panel cada vez. ranger te permite crear nuevas pestañas (como en un navegador web) y cambiar entre ellas tanto con Alt-número o Tab. Si solo abres un par de pestañas, las pestañas de ranger se comportan como los paneles de mc. E incluso puedes abrir más si surge la necesidad.

Navegación básica ^

Para los movimientos básicos puedes utilizar las teclas de las flechas o las teclas que se utilizan en vim:
j/k para moverse arriba y abajo l entra en el directorio seleccionado o abre un archivo h regresa al directorio anterior

Las teclas más útiles:
i inspecciona un archivo o sale de la inspección del archivo. Inspeccionar un archivo significa mostrar una previsualización del archivo actual a pantalla completa, disponible la capacidad de desplazar el contenido del archivo para verlo por completo. q salir. Puedes utilizar esta tecla para cerrar la pestaña activa, salir de inspeccionar o salir de ranger si es la última pestaña.

Atajos de teclado y sugerencias ^

Se pueden realizar numerosos comandos utilizando sus atajos de teclado, haciendo uso de las sugerencias para encontrar el mapeado correcto.

Las sugerencias de comandos se muestran cada vez que un mapeado tiene múltiples continuaciones:
g para navegación y pestañas r para el comando :open_with y para copiar (yank) d para cortar/eliminar (delete) p para pegar (paste)
o para ordenar (sort)
. para filter_stack
z para cambiar ajustes u para "deshacer" (undo)
M para linemode
+, -, = para establecer los derechos de acceso a archivos

Las sugerencias de comandos consisten en teclas de la columna de la izquierda y los comandos correspondientes de la columna derecha. Cuando pulsas una tecla el comando correspondiente es invocado o se muestran más sugerencias.

Configuración ^

ranger utiliza 4 archivos de configuración principales:

  • rc.conf es utilizado para varias opciones de configuración y atajos de teclado a funciones.
  • rifle.conf decide qué programa se utiliza para abrir un archivo.
  • scope.sh es un shell script utilizado para generar previsualizaciones para varios tipos de archivos.
  • commands.py contiene varias implementaciones de funciones, escritas en Python, utilizadas para modificar el comportamiento de ranger e implementar tus propios Comandos personalizados.

Utiliza ranger --copy-config=rc o uno de rifle, scope, commands para copiar los archivos de configuración predeterminados a ~/.config/ranger y modificarlos en esa ruta, únicamente copia los archivos que quieras editar. De esta manera ranger no seguirá utilizando archivos de configuraciones desfasadas cuando lo actualices, excepto para aquellos que copies, tu eres responsable de mantenerlos actualizados. Te en cuenta que los archivos rc.conf y commands.py, son leídos por ranger tanto el archivo global como el de la configuración del usuario (y en ese orden). Esto permite al usuario mantener solo una pequeña configuración que establece solo las cosas que no están configuradas en el predeterminado. Para scope.sh y rifle.conf, ranger lee o el archivo del usuario o la configuración global.

Una buena práctica es solo añadir las opciones/atajos de teclado que quieras cambiar en tu rc.conf, en vez de tener una copia completa del archivo predeterminado de rc.conf. Esto elimina la necesidad de actualizar tu configuración manualmente y te da los beneficios de las nuevas opciones/atajos de teclado que futuras versiones de ranger. Si aún así quieres mantener el archivo rc.conf completo, quizás quieras establecer la variable de entorno RANGER_LOAD_DEFAULT_RC a FALSE para evitar cargar ambos archivos, el predeterminado y tu propia copia de rc.conf. En este caso tendrás que actualizar tu configuración de manera manual.

Cambiando configuración sobre la marcha

Puedes cambiar algunos ajustes de ranger sin necesidad de editar los archivos de configuración. Estos cambios son válidos solo para la sesión actual de ranger. Para hacer esto, pulsa la tecla z y utiliza las sugerencias de comandos. Por ejemplo, zh alterna el mostrar/ocultar los archivos ocultos.

Previsualizaciones ^

Todas las previsualizaciones de archivos están ofrecidas por el archivo de configuración scope.sh. Es un shell script normal y su comportamiento está documentado en detalle en los propios comentarios del archivo.

Ten en cuenta que es posible reemplazar scope.sh con un script en otros lenguajes o binarios compilados. Solo debe seguir las convenciones de llamada de scope.sh y sus códigos de retorno.

Previsualizar imágenes

Un caso muy especial de previsualizaciones son las previsualizaciones de imágenes. Sí, ranger puede mostrar imágenes en tu terminal. Se utiliza una utilidad que ofrece el navegador web w3m (a veces empaquetado en un paquete separado, como w3m-img en Debian). Aunque es infalible la mayoría de las veces, por favor ten en cuenta que es un truco y puede tener a veces un comportamiento extraño.

ranger admite previsualizaciones fiables en algunas terminales que las admiten como urxvt, iTerm2, Kitty o Terminology. Para habilitarlo, abre tu archivo rc.conf y establezca preview_images_method a urxvt, iterm2, kitty o terminology, dependiendo de tu terminal. Para que el método urxvt funcione en Arch Linux podría ser necesario instalar el paquete rxvt-unicode-pixbuf en vez del rxvt-unicode.

Para alternar el previsualización de imágenes, utiliza el atajo de teclado zi.

Previsualización de imágenes personalizada

En versiones recientes de ranger, el mecanismo de previsualización de imágenes fue extendido y generalizado. Cuando se llama a scope.sh, ranger establece la variable de entorno $cached que contiene una ruta única al archivo donde la previsualización de imágen podría ser generada si es necesario. scope.sh podría entonces guardar una imagen a la ruta y salir con un código 6 (documentado dentro de scope.sh, consulta el comentario en la parte superior) para decir a ranger que lo use.

En otras palabra si necesitas generar un jpg desde un archivo, ranger es capaz de mostrar una previsualización gráfica para eso. Videos, PDF y toda clase de archivos.

Pestañas, marcadores, desplazamientos ^

Las pestañas y/o marcadores son utilizados para acceder rápidamente a algunos directorios. Puedes ir también a través de directorios utilizando el comando :travel. Ranger también tiene sugerencias de comandos para algunos atajos de navegaciones. Pulsa g para invocarlo.

Pestañas

Quizás quieres crear pestañas para cada directorio al que quieras acceder rápidamente. Las pestañas están numeradas. Para cambiar a la pestaña N, pulsa Alt-N, donde N es el número de la pestaña. Si esa pestaña no existe todavía, será creada. También puedes cambiar entre pestañas, utilizando la tecla Tab o Shift-Tab. Para cerrar una pestaña, pulsa q (si cierrar la última pestaña, se cerrará por completo ranger).

Marcadores

Un marcador es simplemente un caracter que es utilizado para acceder rápidamente a un directorio. Puedes marcar la carpeta actual utilizando m<tecla> y acceder rápidamente a ella desde cualquier otro lugar utilizando '<tecla>. Utiliza '' para regresar. Ranger guarda tus marcadores de manera predeterminada.

Desplazamientos

¿Qué ocurre si necesitar acceder rápidamente a un directorio que no esté en tus marcadores? En ese casom puedes utilizar el comando :travel. Simplemente escribe :travel en la consola de tu ranger y después escribe las primeras letras de un directorio o archivo. :travel encontrará coincidencia en el directorio actual y automáticamente entrará en ellas cuando sea una coincidencia única, esperando el nombre de otro directorio o archivo. Así que puedes desplazarte a travás de múltiples directorios anidados simplemente escribiendo parcialmente sus nombres.

Selección, macros, etiquetas ^

La selección y macros son utilizados en ranger para especificar un archivo o archivos, en los que el comando será ejecutado. Los comandos de manera predeterminada funciona en los archivos en la selección, pero puedes especificar otros archivos utilizando macros. También puedes utilizar :mark_tag para seleccionar todos los archivos etiquetados.

Selección

Los comandos de ranger normalmente funcionan en la selección. La selección son todos los archivos marcados si hubiera alguno, en otro caso sería solo el fichero actual.

Puedes marcar el archivo actual pulsando space, v invierte la selección y V entra en el modo visual donde podrás marcar un rango de archivos utilizando movimientos o búsquedas. Para marcar/desmarcar archivos que coincidan con expresiones regulares, usa :mark REGEX o :unmark REGEX respectivamente. Para marcar/desmarcar archivos con etiquetas, usa :mark_tag ETIQUETA o :unmark_tag ETIQUETA respectivamente. Para desmarcar todos los archivos marcados, utiliza :unmark o uv.

Un símbolo en amarillo Mrk en la parte inferior derecha indica que hay archivos marcados en este directorio.

Macros

Si escribes comandos en la consola de ranger, puedes utilizar una de estas macros que se muestran a continuación para abreviar acciones:

%f el archivo resaltado %d la ruta del directorio actual %s los archivos seleccionados en el directorio actual %t todos los archivos etiquetados del directorio actual %c las rutas completas de los archivos actualmente copiados/cortados %p las rutas completas de los archivos seleccionados

Supongamos, que tienes algunos archivos seleccionados, pero quieres ejecutar el comando :delete en un único archivo. Si simplemente ejecutas :delete esto eliminará todos los archivos que tienes seleccionados, porque los comandos operan de manera predeterminada en la selección. Así que necesitas resaltar el archivo que quieres eliminar y escribir el siguiente comando en la consola: :delete %f.

Etiquetas

Las etiquetas son simples caracteres que se muestran a la izquierda del nombre de archivo. Pulsando t puedes establecer la etiqueta predeterminada (que es un asterisco *) en en un archivo o eliminar una etiqueta del archivo. Para eliminar etiquetas de la selección usa ut. No estás limitado a las etiquetas predeterminadas. Pulsando las comillas dobles " seguidas por otro carácter establece este carácter como una etiqueta para el archivo. Las etiquetas son persistentes y estarán ahí hasta que las elimines de manera manual. Pueden ser utilizadas, por ejemplo, para marcar libros electrónicos que has leído o archivos en los que necesitas hacer alguna acción.

Las etiquetas también pueden ser utilizadas para habilitar algunas opciones en ciertos directorios. Ver la documentación del comando :setintag command.

Filtrar, ordenar, acoplar directorios ^

Si existen demasiados archivos en el directorio actual, puedes utilizar el filtrado (tecla f) para mostrar solo los archivos que coincidan con tu expresión regular. Ejecuta :filter REGEX para mostrar solo los archivos que coinciden con REGEX y :filter para eliminar el filtro

También existe la funcionalidad :filter_stack, tecla .. Puedes añadir filtros a una pila, incluyendo operadores binarios. De manera predeterminada todos los filtros se aplican uno por uno y un archivo tiene que pasar cada uno de ellos. Usando OR, .|, podrás combinar filtros en una relación O así los archivos pasan el filtro si satisfacen alguna de las dos opciones. Por ejemplo, .l.ttext<CR>.|, mostraría únicamente los enlaces simbólicos o archivos con un tipo MIME que contenga "text". Usa .. en cualquier momento para ver tu pila actual de filter_stack.

También puedes ordenar archivos, pulsando o y escogiendo tu manera preferida de ordenar a partir de las sugerencias.

Acoplar directorios

Si estás navegando por un árbol de directorios con varios directorios anidados, puede que encuentre útil :flat N. Esto permite navegar el árbol de directorios en de manera lineal: todos los archivos hasta el nivel N se muestran juntos. Es un poco difícil de explicar, así que simplemente ejecuta :flat 1 y observa qué sucede. El argumento es el número máximo de directorios a acoplar. Ejecútalo con -1 para no limitarlo (utilizar con precaución) y 0 para inhabilitar :flat.

Operaciones con archivos ^

Abrir, mover, copiar-pegar

Para abrir un archivo y permitir que Ranger escoja qué programa utilizar para abrirlo (mediante rifle), simplemente pulsa Enter. Para escoger por ti mismo, pulsa r y escoge de la lista o escribe el programa que quieres utilizar. También puedes utilizar el comando :open_with.

Para añadir un nuevo programa al repertorio de Ranger, ejecuta el comando ranger --copy-config=rifle, después edita el archivo resultante. Por ejemplo, para añadir Kolourpaint como editor de imágenes, podrías añadir:

mime ^image, has kolourpaint, X, flag f = kolourpaint -- "$@"

El orden de opciones en este archivo refleja el orden de los programas que serán utilizados y aparecen listados con r.

Para copiar un archivo, resáltalo, pulsa yy para marcarlo para copiar (de igual manera que se copia una línea en el editor vim con yy), después navega hasta el directorio destino (o abre una pestaña si decides hacerlo a la "manera mc") y después pulsa pp para pegarlo (de nuevo, casi similar a como se hace en vim).

(Para copiar solo el directorio, el nombre de archivo o la ruta del archivo como texto a tu portapapeles, es necesario xclip, xsel o pbcopy (en el caso de macOS) instalado en tu sistema, utiliza yd, yn o yp respectivamente.)

Mover un archivo difiere un poco del proceso de copiarlo: simpelmente usa dd en vez de yy al comienzo.

Para copiar/mover múltiples archivo, simplemente márcalos con la tecla Espacio y después utiliza ddoyy. Si quiere operar en múltiples archivos almacenados en diferentes directorios, podrías utilizar ya/da para añadirlos a la lista de archivos a ser copiados/movidos antes de pegarlos.

(Ten en cuenta que copiar/cortar buffers puede ser utilizado para otras operaciones también, utilizando la macro %c en tus comandos. Por ejemplo, añadiendo archivos al buffer de cortar/copiar utilizando ya/da y después utilizar el comando :shell -w printf %c | xargs rm te permitirá eliminar múltiples archivos en múltiples directorios. Recuerda limpiar el buffer una que que has terminado mediante ud/uy.)

Si quieres copiar archivos de una instancia de Ranger en otra, escribe :save_copy_buffer en uno y :load_copy_buffer en la otra instancia de Ranger. Este método también puede ser utilizado para exportar una lista de archivos. Son almacenado en el archivo ~/.config/ranger/copy_buffer.

Rifle

rifle es una poderosa aplicación para abrir archivos de manera inteligente incluido en ranger. Intenta adivinar con qué programa debería abrir un archivo determinado en función de su tipo MIME, extensión, los programas disponibles y algunos otros factores. Está configurado con el archivo rifle.conf. Ranger lo usa internamente, pero también puede usarse como un programa independiente.

Renombrar

Para renombrar un archivo simplemente resáltalo y pulsa cw como si quisieras cambiar una palabra en Vim, en la parte inferior de la ventana, aparecerá el comando :rename esperando el nuevo nombre del archivo, escríbelo y pulsa Enter. También puedes utilizar %s cuando renombre, por ejemplo, si te gustaría cambiar únicamente la extensión del archivo, puedes ejecutar :rename %s.txt. También existen unos atajos de teclado con I y A que abren la consola con el cursor al comienzo o al final del nombre del archivo, respectivamente.

Renombrado masivo

ranger admite el renombrado masivo de archivos con el comando :bulkrename. Marca los archivos que quieres renombrar y ejecuta :bulkrename. Debería abrirse un archivo que contiene una lista de estos archivos en tu editor de texto (determinado con rifle). Podrás cambiar libremente los nombres en ese archivo. Cuando hayas terminado, guarda el archivo y cierra el editor. ranger te mostrará una vista previa de lo que ocurrirá a continuación.

:bulkrename funciona genial conjuntamente con :flat!

Borrar y crear

Puedes borrar archivos de la selección utilizando el comando :delete. Para crear un archivo o directorio, utiliza los comandos :touch FILENAME y :mkdir DIRNAME respectivamente.

Utilizando la terminal y opciones ^

Ranger te permite utilizar la terminal. Simplemente escribe el comando que quieres ejecutar en la consola de Ranger después de :shell y pulsa Enter para ejecutarlo. Puedes utilizar opciones para ejecutar programas/comandos de una manera especial (con privilegios de root, en una tarea de fondo, etc).

Opciones

Las opciones se utilizan para ejecutar un comando externo de una forma personalizada.

utiliza la opción w si necesitas ver la salida del comando externo, por ejemplo :shell -w free
utiliza la opción t para abrir una consola aparte con el programa (lo ejecuta en una nueva ventana de terminal), por ejemplo :shell -t nano
utiliza la opción f para dividir un programa con interfaz gráfica, por ejemplo :shell -f firefox
utiliza la opción r para ejecutar un programa con derechos de root. Puedes utilizar varias opciones al mismo tiempo, por ejemplo :shell -rw apt update

Para obtener más información sobre estas opciones, echa un vistazo a este enlace

Más trucos ^

Obteniendo ayuda

Puedes obtenerayuda mientras usas Ranger pulsando ?, seguido por:

  • m: abre la página man de Ranger
  • k: abre una lista con los atajos de teclado
  • c: abre una lista de los comandos disponibles y sus descripciones
  • s: abre una lista de ajustes y su valores actuales

Metadatos

Almacenar los metadatos del archivo es una nueva funcionalidad de ranger. It may Puede ser utilizado para añadir datos que deseemos a cualquier archivo. Ejecutando :meta título un título muy interesante establecerá la etiqueta "título" del archivo actual a "un título muy interesante".

:meta es comúnmente utilizando junto con :linemode. Los modos de línea incorporados están vinculados a "M" seguida de alguna letra. En el momento de escribir esta guía, hay 6 modos de línea integrados:

  • filename: sin metadatos, el modo predeterminado de Ranger
  • permissions: los permisos del archivo son mostrados junto al archivo
  • fileinfo: muestra información del tipo de archivo basándose en el comando file
  • mtime: muestra la fecha de modificación de los archivos
  • sizemtime: muestra el tamaño y fecha de modificación
  • metatitle: ver a continuación

El último modo de línea, metatitle, es extremadamente útil para organizar toda clase de documentos: libros, películas, fotografías y más. Muestra los archivos basándose en sus metadatos. El formato actual es: [[year - ]title] alignment [authors]. El contenido entre corchetes es ignorado si está vacío. El campo title es obligatorio para que esto funcione. Para definir un modo de línea personalizado, por favor vea más información en esta página: Custom linemodes.

:meta almacena los metadatos en el archivo ".metadata.json" para cada directorio en el que es utilizado.

Add a custom footer
Add a custom sidebar
Clone this wiki locally