Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

cómo imprimimos el tutorial en PDF con este nuevo formato? #67

Open
gilgamezh opened this issue May 5, 2020 · 8 comments
Open

cómo imprimimos el tutorial en PDF con este nuevo formato? #67

gilgamezh opened this issue May 5, 2020 · 8 comments

Comments

@gilgamezh
Copy link
Collaborator

@gilgamezh gilgamezh commented May 5, 2020

históricamente PyAr imprime el tutorial para repartirlo en eventos. Podemos seguir haciendolo? cómo?

@humitos
Copy link
Collaborator

@humitos humitos commented May 5, 2020

sphinx-build -b latex ...
latexmk ...

Le podríamos decir a RTD que lo haga por nosotros, también.

Lo que teníamos en PyAr de diferente son los estilos personalizados y el tamaños. Habría que revisar qué leía rst2pdf --si leía una hoja de estilos de latex, podríamos usar lo mismo.

Edit: https://github.com/PyAr/tutorial/blob/master/traducidos/conf.py#L209

Edit: acá explica como se hace https://github.com/PyAr/tutorial/blob/master/traducidos/handcrafted/proceso.txt

@humitos
Copy link
Collaborator

@humitos humitos commented May 6, 2020

Acá compilé una versión en PDF de la branch 3.8: https://python-docs-es.readthedocs.io/_/downloads/es/3.8/pdf/ --se ve bien.

@gilgamezh
Copy link
Collaborator Author

@gilgamezh gilgamezh commented May 6, 2020

@facundobatista
Copy link
Member

@facundobatista facundobatista commented May 6, 2020

Está bueno ese PDF (aunque tiene el "whats new in python 2.6, no tiene sentido).

Puntualmente para imprimrlo: está bueno que deja las páginas en blanco para que los capítulos arranquen "del lado izquierdo".

Podría tener margen extra "del lado del abrochado" de cada página.

Lo que sí habría que tocarle son los colores, ya que en general para abaratar costos la impresión es en B&N.

@humitos
Copy link
Collaborator

@humitos humitos commented May 6, 2020

Está bueno ese PDF (aunque tiene el "whats new in python 2.6, no tiene sentido).

Esto se puede eliminar cambiando el contents.rst, o bien, dándole un contents.rst específico con lo único que nos interesa que esté en el PDF.

Read the Docs no soporta múltiples PDF como output así de una, pero se podría hacer (medio hacky teniendo varias ramas) y construir el Tutorial por un lado y el resto por otro.

Puntualmente para imprimrlo: está bueno que deja las páginas en blanco para que los capítulos arranquen "del lado izquierdo".
Podría tener margen extra "del lado del abrochado" de cada página.
Lo que sí habría que tocarle son los colores, ya que en general para abaratar costos la impresión es en B&N.

Esto se puede cambiar con hojas de estilo de LaTeX, pero yo no tengo mucha experiencia ahí.

@humitos
Copy link
Collaborator

@humitos humitos commented May 7, 2020

Read the Docs no soporta múltiples PDF como output así de una, pero se podría hacer (medio hacky teniendo varias ramas) y construir el Tutorial por un lado y el resto por otro.

Referencia para mi yo del futuro: https://github.com/readthedocs/readthedocs.org/blob/d45ad2b07c9f0577da86d2f76724b6469ad79b3e/readthedocs/doc_builder/backends/sphinx.py#L603-L626 --ahí es donde se decide qué output de los N PDFs se van a copiar.

@humitos
Copy link
Collaborator

@humitos humitos commented May 10, 2020

Algo que no mencioné, pero es interesante. Esta versión y la anterior, ambas usan Sphinx, así que si quisieramos seguir utilizando el mismo proceso lo podríamos hacer a mano.

Sin embargo, algunos PageBreak que se agregaron a mano en el tutorial para hacer que rst2pdf haga un salto de página, no van a poder ser posible fácilmente. Igual, creo que rst2pdf no está mantenido.

@humitos
Copy link
Collaborator

@humitos humitos commented May 23, 2020

Ahora que estamos bajo la documentación oficial, veo que ellos están construyendo todos los PDF para la versión en español también: https://docs.python.org/es/3.8/download.html

Supongo, igualmente, que no es exactamente lo que queremos, pero no quería dejar de mencionarlo en este issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.