Para programadores
Lee libros de programación y documentación en el móvil. Pregúntale a la IA con el código delante.
Un manual en PDF o una especificación de 600 páginas se lee a una columna, sin hacer zoom y con cada listado intacto, sangrías incluidas. La IA cita los pasajes en que se apoya, código incluido.
Reorganizar el trabajo
Cabe destacar que la instantánea apuntada por la confirmación final, tanto si es producto de una reorganización como de una fusión, es exactamente la misma; lo único diferente es el historial. La reorganización vuelve a aplicar cambios de una rama de trabajo sobre otra rama, en el mismo orden en que fueron introducidos en la primera, mientras que la fusión combina entre sí los dos puntos finales de ambas ramas. Nunca reorganices confirmaciones de cambio (commits) que hayas enviado (push) a un repositorio público.
Un PDF que por fin se lee bien en el móvil.
Sin zoom, sin arrastrar de lado a lado, sin palabras cortadas.
3.3. Composition19
3.4 Adding new functions
So far, we have only been using the functions that come with Python, but it is also possible to add new functions. A function definition specifies the name of a new function and the sequence of statements that run when the function is called. Here is an example:
def print_lyrics():
print("I'm a lumberjack, and I'm okay.")
print("I sleep all night and I work all day.")def is a keyword that indicates that this is a function definition. The name of the function is print_lyrics. The rules for function names are the same as for variable names: letters, numbers and under-
score are legal, but the first character can't be a number. You can't use a keyword as the name of a function, and you should avoid having a variable and a function with the same name.
19
Lo que ves arriba: la página 41 del PDF de Think Python (Allen Downey, CC BY-NC), tal como sale del conversor. La cabecera viva y el folio se quitan, el texto se adapta a tu pantalla y al tamaño de letra que elijas, y el listado queda intacto: sangrías, saltos de línea y colores de Python. Un EPUB con código se ve igual. El texto está recortado para que quepa; lo demás no. La página original sigue ahí. Se cambia cuando quieras.
Leer libros de programación, documentación y papers en el móvil
Lo que cambia entre un libro de 500 páginas, un RFC y un paper a dos columnas es la maqueta; el código, el índice y las preguntas funcionan igual en los tres.
Un libro
Un EPUB de O'Reilly o Manning, o un PDF de LaTeX, se lee sin hacer zoom, con cada listado intacto y coloreado según su lenguaje. Cada bloque tiene botón de copiar. Seleccionas un listado y preguntas qué imprime o qué hace la línea 4.
Documentación y especificaciones
Un RFC, un manual de referencia o una especificación de 600 páginas se abre con su índice y se busca dentro. Preguntas por un comportamiento concreto y la respuesta cita la sección que lo define: un toque y estás en ella.
Un paper
Un paper de arXiv a dos columnas se lee a una en el móvil, con las ecuaciones numeradas y las figuras en su sitio. Tocas una figura y preguntas por ella con el texto al lado (preguntar por una figura pide cuenta).
Lo que un lector de PDF con IA no hace con el código
Lo que Marginalia no hace, y lo que todavía no hace bien, con libros técnicos.
No ejecuta el código
Lo muestra y la IA lo explica con el libro delante, pero nadie lo ejecuta. Si preguntas qué imprime, la IA razona sobre el listado y puede equivocarse: las citas de cada respuesta te llevan al listado para que lo compruebes.
Los colores son una apuesta razonable
Si el libro declara el lenguaje del bloque, se usa ese. Si no, se intenta reconocer en el propio bloque y, si no está claro, se usa el que domina en el libro; si tampoco lo hay, el bloque queda sin color. Un fragmento puede salir con los colores de otro lenguaje. Los colores se pueden apagar en los ajustes.
Páginas densas de figuras
En un paper a dos columnas con tres gráficas y dos tablas en la misma página, algún rótulo de eje puede colarse en el texto. Las páginas de figuras y las tablas complejas quedan como imagen.
Fórmulas: las de línea propia, como imagen
Las ecuaciones en línea propia, como las numeradas de un paper, quedan como imagen con su texto para el chat. Un libro de análisis numérico o de aprendizaje automático con matemáticas en cada línea todavía no está bien resuelto.
Privacidad de un documento técnico interno
El documento, nunca
El PDF o el EPUB se guarda en el almacenamiento privado del navegador y no se sube a ningún servidor. Una especificación interna, un manual de tu empresa o un libro comprado no viajan.
Al preguntar, la pregunta y el pasaje
Viaja tu pregunta con los fragmentos del documento que hacen falta para responderla, incluido el listado que señales. Con cuenta, además, el texto del documento pasa por el servidor para construir el índice de búsqueda, sin guardarse. Con código interno, esa es la línea que se cruza: preguntar, o tener el libro indexado en la cuenta.
Con cuenta, tus notas
Progreso, subrayados, notas y conversaciones se guardan en tu cuenta para seguir en otro aparato. El archivo no se sube, así que hay que abrirlo una vez en cada navegador nuevo.
Probado con Pro Git, un RFC y papers de arXiv
El conversor se prueba con estos documentos, todos de acceso libre, y el orden de lectura se compara con el texto publicado cuando lo hay: el EPUB de Pro Git y la versión HTML de los papers.
Pro Git
Chacon y Straub, 500 páginas, 992 listados: el orden de lectura coincide al 99,8 % con el EPUB.
Think Python
Downey: libro de LaTeX con cabeceras vivas, 244 páginas y 596 listados.
Eloquent JavaScript
Haverbeke, 4.ª ed.: 463 páginas, 651 listados.
RFC 9110 (HTTP)
Todo en monoespaciada: 194 páginas, 15 tablas y 135 bloques de código.
arXiv (CVPR y NeurIPS)
ResNet a dos columnas, 97,5 %; Transformer con ecuaciones, 96,3 %, contra la versión HTML de ar5iv.
RISC-V unprivileged
Especificación de 670 páginas y 268 tablas.
Si tu PDF viene de otra maqueta y sale mal, escríbenos desde «Enviar comentarios»: las maquetas que fallan son las que conviene añadir a las pruebas.
Antes de abrir tu primer libro.
¿Respeta el código al pasar un PDF a texto?
¿Qué lenguajes colorea?
¿Puedo preguntar por un bloque de código concreto?
¿Sirve con los EPUB de O'Reilly y Manning?
¿Puedo abrir documentación interna de mi empresa?
¿Cuánto cuesta, y hay API o versión de escritorio?
Abre un libro, una especificación o un paper
Sin cuenta y sin instalar nada. Pro Git está listo para probar; un PDF con código se convierte una vez y queda guardado en tu navegador. Si lees a menudo, puedes instalarla como app.
Gratis y sin cuenta. El archivo no sale de tu navegador.