Sioyek, visor de PDF especializado en libros de texto y artículos de investigación

 (github.com/ahrm)
1 puntos por GN⁺ 2024-05-11 | 1 comentarios | Compartir por WhatsApp
  • Sioyek es un visor de PDF enfocado en la lectura de libros de texto y artículos de investigación, y ofrece funciones para encontrar rápidamente archivos abiertos anteriormente y moverse dentro de la estructura de un artículo
  • Incluso en PDF sin enlaces, permite saltar a figuras y entradas bibliográficas, y admite buscar nombres de referencias en Google Scholar o Libgen
  • Está centrado en funciones de navegación necesarias para leer documentos largos, como búsqueda en la tabla de contenido, vista general rápida, marcas, marcadores y búsqueda de resaltados
  • Los usuarios con varios monitores pueden usar Portals para conectar una ubicación del texto con la ubicación de una figura y ver automáticamente el destino del portal más cercano en una ventana separada
  • Ofrece instaladores oficiales para Windows, macOS y Linux, además de Homebrew Cask y paquetes de terceros para varias distribuciones de Linux; las compilaciones de la rama de desarrollo requieren Qt 6.7 o 6.8

Resumen del proyecto

Opciones de instalación

Funciones de navegación de documentos

  • Quick Open permite buscar y abrir rápidamente archivos con los que antes se interactuó en Sioyek
  • La función Table of Contents permite buscar entradas de la tabla de contenido y moverse a esa ubicación
  • Smart Jump permite ir a figuras referenciadas o entradas bibliográficas aunque el archivo PDF no ofrezca enlaces
    • Al hacer clic central o Shift+clic central sobre el nombre de una referencia, se puede buscar en Google Scholar o Libgen
  • Overview permite abrir figuras, referencias, tablas y otros elementos con una vista general rápida al hacer clic derecho
    • Al igual que Smart Jump, funciona aunque el documento no ofrezca enlaces

Funciones de apoyo para leer documentos largos

  • Mark permite guardar ubicaciones con nombre dentro del PDF y volver rápidamente más tarde usando ese nombre
    • Cada marca tiene un nombre de un solo carácter como a o m
    • Las marcas en minúscula son locales al documento y las mayúsculas son globales
    • Es una forma familiar para quienes han usado Vim
  • Bookmarks son similares a las marcas, pero usan nombres de texto y todos son globales
  • Highlights permiten marcar texto con varios tipos de resaltado y buscar entre todos los resaltados
  • Portals permiten conectar el párrafo actual con una ubicación distante, como una figura
    • Muestran el destino del portal más cercano en una ventana separada
    • Esta ventana normalmente se coloca en un segundo monitor
    • A medida que el usuario navega por el documento, se actualiza automáticamente al destino de portal más cercano

Configuración y compilación

  • Configuration permite personalizar todas las combinaciones de teclas y algunos elementos de la interfaz editando keys_user.config y prefs_user.config
    • La configuración predeterminada está en keys.config y prefs.config
  • Si al compilar la rama de desarrollo aparecen errores de compilación con Qt 5.*, se debe usar Qt 6.7 o 6.8
  • Si en macOS aparece el mensaje "sioyek is damaged and cannot be opened. It is recommended to eject the image.", se trata de un problema relacionado con la cuarentena de macOS, y se indica una discusión relacionada
  • Para compilar en Linux se ofrecen comandos para Fedora y un procedimiento para distribuciones generales
    • Se incluye un procedimiento probado en Fedora Workstation 36
    • El procedimiento general para distribuciones indica instalar Qt 5, qmake y libharfbuzz, y luego ejecutar ./build_linux.sh
  • La compilación para Windows fue probada en Visual Studio 2019, y versiones relativamente recientes también podrían funcionar
    • Tras preparar Qt 5 y qmake, se ejecuta build_windows.bat desde el 64-bit Visual Studio Developer Command Prompt
  • La compilación para Mac indica instalar Xcode y Qt6, ejecutar build_mac.sh, mover el sioyek.app compilado a /Applications/ y luego realizar el codesign

Lecturas relacionadas

1 comentarios

 
GN⁺ 2024-05-11
Opiniones de Hacker News

  • Me gustó tanto que lo instalé incluso antes de terminar de leer la lista de funciones, pero parece que necesita mejoras, por ejemplo visualización de 2 páginas.
    La interfaz de control con teclado es excelente, pero es una lástima que no haya comandos de menú. También me pareció raro que no haya forma de volver a abrir la ayuda dentro del programa. Al abrirlo por primera vez se ve la ayuda, pero al abrir un archivo desaparece, así que al final tuve que ir a la página de documentación del sitio web.
    Aun así, tiene tantas funciones buenas optimizadas para investigación que vale la pena aguantar esas molestias.

    • Soy el desarrollador de Sioyek. Agregué un modo de 2 páginas en la rama de desarrollo.
    • Con : se puede abrir la paleta de comandos y buscar comandos y atajos.

  • He estado trabajando en integrar mejor el contenido que leo con mis notas. Quiero reunir los lugares de la literatura donde una idea se desarrolla o se refuta, y también recopilar buenas ideas.
    Cahier, que estoy desarrollando (https://getcahier.com), permite crear tarjetas que hacen referencia a pasajes específicos de los PDF leídos.
    Es interesante ver los avances que se están dando en este campo en los últimos años.

    • Cahier parece casi exactamente lo que he querido desde hace mucho tiempo. En los últimos años surgió una corriente que se toma en serio la gestión del conocimiento, y aparecieron muchas herramientas excelentes como Obsidian, Zotero y Anki, pero todavía faltan buenas soluciones para resaltar y anotar documentos adecuadamente, y luego sacar ese contenido del documento original para conectarlo con el contexto más amplio de las notas.
      Al final se crean varios silos: los papers quedan en Zotero y las notas en Obsidian. Cahier definitivamente parece ir en la dirección correcta al ver la gestión del conocimiento como un flujo de trabajo integrado que conecta lectura, toma de notas, organización de notas, generación de nuevas ideas y escritura.
      Pero me preocupa que termine reinventando la rueda en algunas áreas. Por ejemplo, me pregunto si planean integrar también funciones como el recopilador web integrado de Zotero. Eso sería una cantidad enorme de trabajo y, sin eso, sería difícil reemplazar por completo a Zotero como solución de gestión bibliográfica. Me interesa conocer el roadmap, el alcance final de funciones y el flujo de trabajo de los usuarios.
    • Se ve bien. Como otros, creo que seguiré usando Zotero por ahora. La función más importante de Zotero es la sincronización entre dispositivos.
      Normalmente leo papers y los anoto en el iPad, y me gusta que los resaltados y las notas se sincronicen para poder consultarlos de inmediato cuando escribo en mi MacBook o en una desktop con Windows.
      Pero como solución para tomar notas, Cahier parece mucho mejor. A veces pienso que sería genial poder combinar varios programas para crear la herramienta perfecta para cada persona.
    • ¿Podrías explicar un poco más qué avances te parecen interesantes? Tendría que revisar el enlace original, este enlace y las otras herramientas del hilo.
      Hace algunos años que no lo investigo seriamente para uso personal, pero en ese momento las opciones me decepcionaron bastante. Para leer u organizar PDF, Zotero y org-noter estaban entre las mejores alternativas, aunque con enfoques totalmente distintos.
      También usé OneNote durante un año y en ese momento me gustó, pero como no ayuda a buscar, descubrir ni repasar información, era difícil sostenerlo para construir una base de conocimiento o hacer revisión bibliográfica.
      Creo que el software para leer y conectar información documental, ya sea en PDF, HTML, video o cualquier otro formato, podría ser muchísimo mejor que lo que uso a diario hoy.
    • Intenté revisar el sitio web y vi que el certificado SSL venció hoy. Parece que deberían renovarlo :)
    • Se ve bastante interesante. Para mí, una función imprescindible es que los datos, incluidas notas y anotaciones, sigan siendo utilizables incluso dentro de décadas.
      Si no, el trabajo de hoy desaparece. Me pregunto qué pasará si algún día se deja de desarrollar Cahier o si tengo que migrar a otro sistema.

  • Uso esta app todo el tiempo. Es una buena app. Algunas funciones, como saltar a las citas, también existen en la extensión de Google Scholar para Chrome, pero la idea de poder manejar la app como si fuera Vim es realmente buena.
    Antes de Sioyek, configuraba j/k y otras teclas con Karabiner en macOS Preview para moverme con teclas de Vim, pero el proceso era engorroso y no tenía muchas de las funciones que ofrece Sioyek. Además, uso el color de fondo de los PDF en solarized para reducir la fatiga visual, y esta app también admite modo nocturno en los gráficos dentro del PDF.
    También tengo algunas quejas. Hay una extensión para ver un PDF lado a lado en un panel de dos columnas, pero modifica el archivo PDF en sí. En general, instalar plugins es difícil; busqué y reporté una solución alternativa, pero no sé si se incorporó como mejora en la app. Parece que el archivo de configuración se guarda en el directorio Applications de la app; sería mejor que estuviera en ~/.config. La función para abrir rápidamente archivos desde un directorio no funciona en unidades en la nube, incluido iCloud.

    • Soy el desarrollador de Sioyek. Agregué un modo nativo de dos paneles en la rama de desarrollo.
      En cuanto a los plugins, hice que la rama de desarrollo admita extensiones JavaScript nativas. Como usa el motor JavaScript interno de Qt, no tiene dependencias externas y debería ser mucho más fácil de manejar.
      Creo que el archivo de configuración también puede usar ~/.config en la rama de desarrollo, aunque no estoy 100% seguro.
    • Estoy de acuerdo en que instalar extensiones es complicado.
      De verdad no puedo recordar el nombre sioyek, así que lo puse como alias de xpdf.

  • Probé un enfoque más colaborativo para leer y discutir papers de investigación. En https://www.scholars.io o https://app.scholars.io permitimos que la gente anote investigaciones, comente y colabore.

  • Me pregunto si la función de tabla de contenido funciona aunque el PDF no incluya una. Es una función que siempre quise que tuviera un lector de PDF

    • Hasta cierto punto, sí. Sioyek intenta generar una tabla de contenido parseando el texto, pero no modifica el PDF original, y la precisión y utilidad son irregulares
      En papers suele funcionar bastante bien; a veces se salta algunas secciones o mete elementos basura. En libros de texto, sobre todo los que tienen mucha composición de fórmulas, muchas veces había demasiados elementos inútiles u omisiones
      Si solo necesito un paper o una parte de un libro de texto, la tabla de contenido generada automáticamente y los marcadores suelen ser suficientes. Para lo demás, prefiero crear una tabla de contenido precisa de forma semimanual con pdf.tocgen(https://github.com/Krasjet/pdf.tocgen)
    • Sí se puede
      Si el archivo no tiene tabla de contenido y la configuración está activada, la genera mediante un método heurístico. Con max_created_toc_size se puede evitar que cree una tabla de contenido demasiado grande
      https://sioyek-documentation.readthedocs.io/en/latest/config...
    • En el sitio web dicen que sí se puede: https://sioyek.info/
      Creo que lo correcto sería enlazar al sitio web

  • Como solución simple para la función de ir y venir entre dos páginas, que es fácil en un libro de papel pero difícil en la computadora, si el software permite dos instancias, abro el PDF dos veces
    Si es demasiado inteligente y no deja hacerlo, copio el PDF, abro la segunda copia, hago scroll a posiciones distintas y voy alternando con alt-tab
    En el celular se pueden usar Acrobat Reader y Koreader al mismo tiempo

  • Sioyek tiene buenas funciones, pero era bastante buggy. Corregir bugs y escribir tests puede requerir mucho esfuerzo

  • Un poco tangencial, pero me pregunto si alguien conoce un buen lector de PDF con búsqueda basada en LLM integrada. Estaría bueno que, si busco “cities in USA” en un documento, me muestre todas las apariciones, como New York, Los Angeles, Chicago, por ejemplo

    • PDFgear tiene un LLM integrado y por ahora es gratis

  • Estaría bueno que este lector se integrara con Zotero. También parece viable en forma de plugin

  • Me gustaba bastante Sioyek, como una especie de Zathura con más funciones, pero por dos cosas no pude usarlo como lector de PDF predeterminado
    Primero, no se pueden abrir varios PDF al mismo tiempo. Si ya hay un PDF abierto e intento abrir un segundo, ambas instancias crashean
    Segundo, las anotaciones se guardan en un documento separado, no en el propio PDF
    Otros usuarios ya habían mencionado ambas cosas. No encontré una solución fácil para la primera, y para la segunda había una solución parcial usando una extensión, pero según recuerdo igual había que ejecutar manualmente un comando para pasar las anotaciones al propio documento PDF

    • Coincido con el problema de varios PDF. Creo que es algo en lo que se está trabajando. Pero, en cuanto a guardar las anotaciones en un documento separado en vez de incrustarlas en el PDF, en realidad lo prefiero
      Idealmente ofrecería ambas opciones, como Zotero y la extensión mencionada, pero prefiero que las anotaciones queden separadas porque así se puede mantener una copia limpia del PDF para compartirla con otras personas
      Además, cada visor de PDF que actualmente soporta anotaciones las maneja a su manera, y los programas no distinguen bien los resaltados o notas creados por otros programas del original
      Dicho eso, Zotero y algunos lectores empezaron a usar Web Annotation Data Model(https://www.w3.org/TR/annotation-model/) como mecanismo universal para guardar anotaciones. Espero que algún día pueda ver y editar en KOReader, en mi lector de ebooks, los resaltados y notas creados en Sioyek, y luego enviar el archivo de anotaciones a un colega usuario de Zotero u Obsidian/PMK que tenga otra copia del mismo PDF. Todavía está muy verde, pero se está trabajando en eso. https://hypothes.is también funciona un poco así
    • En la versión más reciente, 2.0.0, parece haber una configuración para el punto 1, aunque el comentario del archivo de configuración incluido puede resultar confuso
      Al poner should_launch_new_instance en 1 pude abrir varios PDF al mismo tiempo en Sioyek, pero solo cuando abría los PDF posteriores al primero desde la terminal. Si los abría desde dentro de Sioyek o desde dmenu, reemplazaban el PDF ya abierto. De todos modos, nunca sufrí un crash. Uso dwm en Debian
      El punto 2 me parece deseable
    • Soy desarrollador de Sioyek. Por supuesto debería ser posible abrir varios PDF. Por ejemplo, usando el comando new-window o pasando la opción de línea de comandos --new-window
      Si se produce un crash, agradecería que abran un issue en GitHub