docs
Ajustes
Todo lo que hay detrás de ⌘, — cuatro pestañas: General para el comportamiento, Apariencia para el aspecto de PullMark, Teclado para el mapa de teclas y Experimental para las funciones aún por asentar. La ventana reabre en la última pestaña que usaste.
General
¿Lees esto donde PullMark (0.28.1+) está instalado? Abre la pestaña General.
Lectura
| Ajuste | Opciones · por defecto | Qué hace |
|---|---|---|
| Restaurar los archivos y los pull requests de la última sesión | on/off — on | Reabre lo que había en la barra lateral la última vez que PullMark se cerró — archivos, carpetas, PRs, repos navegados y la entrada de vista previa (aún como vista previa). |
| Mostrar los archivos ocultos | on/off — off | Los dotfiles y carpetas ocultas en Ubicaciones — los docs de
.github/ y compañía. También se alterna con
⇧⌘. (la combinación del propio Finder) o Visualización →
Mostrar los archivos ocultos; cada Ubicación abierta se reescanea al cambiarlo. |
| Enlaces Markdown de GitHub | Preguntar en el primer clic · Abrir en PullMark · Abrir en el navegador — Preguntar en el primer clic | Qué hace clicar un enlace a un archivo Markdown en GitHub. Mantén ⌘ al hacer clic para el otro comportamiento. La casilla «Recordar mi elección» del diálogo del primer clic te lo deja configurado. |
| Al hacer clic en archivos de Ubicaciones | Vista previa primero · Abrir del todo — Vista previa primero | Vista previa primero muestra un archivo con un clic sin conservarlo — una entrada en cursiva (en Archivos abiertos, o bajo su repo de GitHub) que la siguiente vista previa reemplaza; doble clic o empezar a editar la conserva. Abrir del todo conserva cada archivo que clicas. Vale igual para carpetas locales y repos de GitHub navegados. Ver Vistas previas. |
Revisión
| Ajuste | Opciones · por defecto | Qué hace |
|---|---|---|
| Disposición del diff por defecto | En línea · Lado a lado — En línea | Cómo se abren los diffs renderizados de PR. Conmutable por archivo con ⌥⌘L. |
| Mostrar las solicitudes de revisión en la barra lateral | on/off — on | El subgrupo Solicitudes de revisión: los PR abiertos donde se solicita tu revisión. Oculto en cualquier caso si no has iniciado sesión. |
| Solo las solicitudes que cambian Markdown | on/off — on | Oculta las solicitudes de revisión sin archivos Markdown — PullMark no tiene nada que mostrar de ellas. |
| Mostrar la discusión de la revisión en el resumen del PR | on/off — on | Los hilos de revisión en línea anidados bajo su revisión en la conversación del resumen — todos los hilos, incluidos los de archivos que PullMark no renderiza, con el pasaje comentado al lado. Desactivado muestra solo veredictos y comentarios. Se graduó de Experimental en la 0.34. |
GitHub
| Ajuste | Qué hace |
|---|---|
| Conexión | Si PullMark puede hablar con GitHub, como quién y por qué fuente
de credenciales («Conectado como tú · GitHub CLI»).
Volver a comprobar vuelve a leer las credenciales — tras
gh auth login conecta sin relanzar — y
Configurar… abre un asistente que detecta qué le falta a
este Mac. Ver
Acceso a GitHub
para la historia completa de las credenciales. |
Actualizaciones
| Ajuste | Qué hace |
|---|---|
| Mostrar Novedades después de una actualización | Activado (por defecto) presenta las notas de la versión cuando llega una actualización; desactivado lo sustituye por un discreto aviso «Actualizado a PullMark X» con las notas a un clic — una actualización siempre se anuncia de algún modo. |
| Actualizaciones | Buscar actualizaciones… a demanda; PullMark también comprueba al abrir y periódicamente. Cuando ya se conoce una actualización, la fila ofrece Novedades, Actualizar ahora y un botón de recomprobar ahí mismo. Novedades muestra las notas de cada versión entre la tuya y la nueva, y Ayuda → Notas de la versión guarda el historial completo en todo momento. |
Sistema
| Ajuste | Qué hace |
|---|---|
| App por defecto para Markdown | Muestra qué app abre ahora mismo los archivos .md;
Hacer que PullMark sea la app por defecto reclama el vínculo con
un clic. Si una actualización posterior hace que macOS lo suelte,
PullMark lo nota y ofrece recuperarlo. |
| Línea de comandos | Instala el comando
pullmark en /usr/local/bin para las
instalaciones por DMG (los usuarios de Homebrew ya lo tienen).
Muestra una marca cuando ya hay un pullmark en tu
PATH. |
| Vistas previas de Quick Look | Renderizado (por defecto) o Código fuente crudo — lo que muestra pulsar espacio en el Finder para archivos Markdown. |
Apariencia
¿Lees esto donde PullMark (0.28.1+) está instalado? Abre la pestaña Apariencia.
El conmutador Claro · Oscuro · Sistema va arriba del todo — toda la app lo sigue, tanto el chrome como las páginas renderizadas (cada tema trae su propio aspecto claro y oscuro). Debajo, las opciones visuales:
Cada opción de aquí es una tarjeta con una vista previa en vivo renderizada por el pipeline real — lo que ves es lo que reciben los documentos.
Tema ↗
| Tema | Aspecto |
|---|---|
| GitHub (por defecto) | El aspecto clásico, exactamente como en github.com. |
| Editorial | Encabezados con serifa de libro sobre papel cálido. |
| Terminal | Monoespaciada con un acento verde fósforo. |
Temas personalizados: suelta archivos
.css en la carpeta Themes (hay un botón en esta pestaña) y
aparecen como tarjetas. Se aplican sobre el aspecto GitHub, siguen la
apariencia Light/Dark y reestilizan también los diffs. Las vistas
previas de Quick Look siguen tu tema (los temas personalizados recurren
ahí a su base GitHub).
Ancho del contenido ↗
| Opción | Significado |
|---|---|
| Standard (por defecto) | La medida de lectura clásica de un libro. |
| Wide | Líneas más largas, más en pantalla — sigue limitando el largo de línea. |
| Full Width | El texto usa toda la ventana — útil en pantalla completa. |
Se aplica en todas partes, en vivo, y se compone con los temas, el blame, los diffs y el zoom. También conmutable en plena lectura desde Visualización → Ancho del contenido.
Números de línea ↗
| Opción | Significado |
|---|---|
| Ocultos (por defecto) | Un margen limpio; números a demanda en la vista Código fuente. |
| Visibles | La línea de origen inicial de cada bloque en el margen de los documentos renderizados y los diffs — pasa el cursor por un número para el rango completo del bloque. La numeración es por bloque, no por línea visual (el texto renderizado fluye libre). La vista de código fuente crudo siempre muestra sus propios números de línea. |
Teclado
¿Lees esto donde PullMark (0.28.1+) está instalado? Abre la pestaña Teclado.
El atajo de cada acción de menú es reasignable — ver Atajos de teclado para el mapa completo y cómo funcionan la grabación, los conflictos y Restablecer valores por defecto.
Experimental
¿Lees esto donde PullMark (0.28.1+) está instalado? Abre la pestaña Experimental.
Funciones que se publican antes de que su diseño esté asentado, cada una etiquetada beta o alfa — el contrato de niveles explica qué promete cada uno. Las funciones alfa permanecen ocultas hasta que activas Mostrar las funciones alfa (antes, un diálogo explica las condiciones del alfa), y cada función tiene su propio interruptor. Las notas al margen viven aquí — en beta desde la 0.35 y activadas por defecto, con su interruptor, el ajuste de autor y un botón Copiar para el fragmento de instrucciones del agente; el primer uso presenta la función y ofrece desactivarla.
Dónde se guarda todo
Todas las preferencias viven en el dominio de defaults
app.pullmark.PullMark. Las sesiones, las posiciones de
lectura y los borradores son solo metadatos — PullMark nunca copia tus
documentos a ningún sitio, y el contenido descargado de GitHub se queda
en memoria.