Para programadores
Un libro de O'Reilly en PDF, una especificación de 600 páginas o un paper de arXiv se leen como un libro: una columna, tu letra, y cada listado intacto, con sus sangrías y con colores por lenguaje. Y la IA responde con el texto y el código del libro, no con lo que recuerda: cada respuesta trae el pasaje y la página, y un toque te lleva allí. Sin cuenta, sin instalar, sin subir el archivo.
Leer no pide nada. La cuenta se pide solo al preguntar, es gratis y solo lleva el correo.
3.3. Composition19
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 fluye con tu letra, 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.
Para qué sirve
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.
Prueba: pulsa un marcador en la respuesta.
¿En qué se diferencia rebase de merge, y cuándo no debo usarlo?
Las dos integran cambios de una rama en otra. La reorganización vuelve a aplicar los cambios de una rama sobre otra en el mismo orden en que se hicieron; la fusión combina los dos puntos finales. La instantánea final es la misma, solo cambia el historial. Y la regla del libro es una: nunca reorganices confirmaciones que ya hayas enviado a un repositorio público.
«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.»
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.
Lo que no hace
Este es el público que detecta el humo. Esto es lo que Marginalia no es y lo que todavía no hace bien con libros técnicos.
Privacidad
Con qué se ha probado
El conversor se prueba con estos documentos, todos de licencia abierta, y el orden de lectura se compara con el texto publicado cuando lo hay. Los listados de código se comprueban a mano: sangrías, saltos y nada de prosa dentro.
Si tu PDF viene de otra maqueta y sale mal, mándalo: cada maqueta nueva entra en las pruebas.
Preguntas
Sí. Los bloques monoespaciados se detectan por la fuente y por la geometría, se conservan sangrías y saltos de línea, y no se mezclan con la prosa. Si un listado sale mal, es un fallo del conversor y se agradece el PDF.
Treinta y dos gramáticas: JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Rust, Kotlin, Swift, Ruby, PHP, SQL, shell, HTML, CSS, JSON, YAML y otras. El libro puede declarar cualquiera; sin declaración, se usa el lenguaje dominante del libro.
Sí. Selecciónalo y pregunta: la IA recibe ese bloque y responde sobre él, citando el libro. Las acciones directas sobre selección (explicar línea a línea, qué imprime) están en camino.
Sí, es un lector de EPUB completo: índice, búsqueda, subrayados y notas. Los listados de esos libros declaran el lenguaje y salen coloreados con él.
Leerla, sí: el archivo no sale del navegador. Al preguntar viaja la pregunta con los pasajes necesarios para responderla, así que con código o especificaciones que no deban salir conviene no preguntar.
Hoy no se cobra: leer no pide cuenta; preguntar sí, y es gratis con un tope diario y mensual holgado. No hay API ni app de escritorio; es una web que se instala como app.
Empezar
Sin cuenta y sin instalar nada. Pro Git se abre al momento; un PDF con código se convierte una vez y queda guardado. Si lees a menudo, se instala como app.