Post on 27-Jun-2015
description
El Ferrocarril contra
Los Árboles Muertos
Lleïr Borràs & Fernando Martínez
¿Quiénes?
Lleïr Borràs Metje
Web: lleirborras.blogspot.com
twitter:
@lleirborras
Github:github.com/lleirborras
Trabajo:www.hesperides.cat
Fernando Martínez de la Cueva Web:www.sic-sl.com/fmc twitter: @oinak LinkedIn:www.linkedin.com/in/fernandomc
Trabajo:www.lciberica.es y www.sic-sl.com
Producto:www.lciberica.es/productos/psp
«Rails es un Framework web...No lo decimos nosotros sino ellos
...en un mundo de papel»
Nuestra vida esta rodeada de objetos hechos de papel o relacionados con él y es muy difícil dejarlo atrás de golpe:
Libros
Títulos de propiedad
Contratos
Periódico
Lista de la compra...
Definamos aplicación:
[La cultura del árbol muerto]
¿Por qué?
«You can't grep dead trees...... but you can read them in WC bed»
Los árboles muertos llegan donde aún no llegan las pantallas. Esto puede que mejore en el futuro a medio plazo con la tinta electrónica, o iniciatvas como Google Editions, el Crunchpad, los nuevos dispositivos Android...
Odiosas comparaciones...
Tamaño / formato predecible Tamaño variable
Alta resolución ~300ppp
Márgenes imprescindibles
Predominantemente vertical
Baja resolución ~72ppp
Márgenes opinables
Vista ¿horizontal?
¿To PDF or not To PDF? . . .
. . . that's the question
¿ ?
¿Que tener en cuenta?
Compatibilidad con versiones Rails
Rapidez/facilidad (subjetiva) de desarrolloFacilidad (subjetiva) de modificar, mantener
Precisión de la salida (respecto a esperado/modelo)Soporte de Parciales
Control de rupturas (Saltos de Página)
Soporte/control de tipografías
Posibilidad de validación
Compatibilidad con navegadores
Rendimiento en máquina (aprox.)
Soporte de Imágenes
HTMLDoc Gem
Web: http://www.htmldoc.orgGem: http://htmldoc.rubyforge.org
✔ HTML (plantillas existentes, mantenimiento) ✘ No soporta HTML > 3.2 (maquetación, validación) ✘ Paginación poco ortodoxa (tags especiales) ✘ Ejecutable aparte (rendimiento, deploy) ✘ Licencia doble (uso comercial*)
* IANAL: No somos abogados
RTeX versiones 1 y 2
Versión 1 (Rails 1.x.x) Versión 2 (Rails >= 2.0.1)
✘ Sin partials ✔ Con partials
✘ Sin soporte IDE (¿alguien?) ✘ Sin soporte IDE (¿alguien?)
✘ Congelado (pero opensource) ✔ Activo
Web: http://rtex.rubyforge.org/
✔ Maquetación ortotipográfica ✔ Estilo uniforme ✘ Lenguaje/dominio nuevo (maquetador web)
✘ Posicionamiento difícil de precisar (recortable)
✘ Problemas con las imágenes (PNG, JPEG y GIF)
✘ Ejecutable externo (deploy de extensiones de LaTeX...)
✘ LaTeX pensado para lo contrario (diseño vs contenido)
Jasper Reports
Web: http://jasperforge.org/projects/jasperreportsRails: wiki.rubyonrails.org/rails/pages/HowtoIntegrateJasperReports
✔Diseño por IDE (propio o plugin Eclipse/NetBeans) ✔Posicionamiento/maquetación (muy) preciso ✘ Lenguaje/dominio nuevo ✘ Requiere Java ✘ Funcionalidad limitada (cuando/como lo probamos) ✘ No se puede testear la vista
Prawn & PrawnTo
Web: http://prawn.majesticseacreature.com/Rails: http://www.cracklabs.com/prawnto
✘ Lenguaje/dominio nuevo ✘ Ruby (maquetador) ✔ Ruby (desarrollador) ✔ MVC (ahem ahem sí...) ✘ MVC (...pero no plantilla) ✘ Pesado(servidores x2)
✔ Preciso (el MÁS) ¡hasta recortables!
$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', '..','lib'))require 'prawn' Prawn::Document.generate("bounding_boxes.pdf") do bounding_box [100,600], :width => 200 do move_down 10 text "The rain in spain falls mainly on the plains " * 5 move_down 20 stroke do line bounds.top_left, bounds.top_right line bounds.bottom_left, bounds.bottom_right end end bounding_box [100,cursor], :width => 200, :height => 200 do stroke do circle_at [100,100], :radius => 100 line bounds.top_left, bounds.bottom_right line bounds.top_right, bounds.bottom_left end bounding_box [50,150], :width => 100, :height => 100 do stroke_bounds end endend
Acts as flying saucer
Java: https://xhtmlrenderer.dev.java.net/Rails: http://github.com/dagi3d/acts_as_flying_saucer/ ✘ Requiere Java (rendimiento, deploy) ✔ Requiere Java (en entornos ruby) ✔ Plantillas XHTML Correcto (nativas de rails) ✘ Maquetación (limitado por CSS / Navegadores) ✔ Soporte partials, imágenes... ✔ Plantillas XHTML+CSS (maquetadores)
/app/controllers/ejemplo_controller.rbacts_as_fying_saucerdef metodo #lógica del controlador
respond_to do |format| format.pdf do render_pdf :template => 'ejemplo/metodo', :send_file => { :filename => 'metodo.pdf' } end endend
/app/views/ejemplo/metodo.haml !!!XML!!!strict%html{html_attrs('es-es')} %head %title= @documento.datos[:titulo]
...
(Lleïr's) Render as PDF
PHP: http://html2pdf.frRails: http://github.com/lleirborras/render_as_pdf ☹ Necesita PHP (>=4) en la máquina ☹ Consume mucha RAM en pdf's grandes (>250 pg.) ☹ Algunos tags especiales (<page_header>, <page_footer>, ...) ☺ Admite HTML 4.01 + CSS 2 ☺ Cabeceras y pies de página dinámicos. ☺ Admite muchos formatos de imágen (jpg, png, gif, ...) ☺ Admite códigos de barras ☺ Plantillas y helpers ☺ MUY rápido de maquetar (HTML)
/app/controllers/ejemplo_controller.rbdef metodo respond_to do |format| format.html format.pdf do pdf_data = render_as_pdf :template => "/ejemplo/metodo.html.haml", :layout => false send_data pdf_data, { :type => "application/pdf", :filename => "nombre.pdf" } end endend
/app/views/ejemplo/metodo.haml !!!XML!!!strict%html{html_attrs('es-es')} %head %title= @documento.datos[:titulo]
...
(Oinak's) Fly without the saucer
☑ No requiere Java/PHP/Plugins... (rendimiento, deploy) ☑ Plantillas XHTML Válido (nativas de rails) ☑ helpers, partials, reutilización... ☑ maquetadores web ☒ Renderizado: (limitados por CSS/soporte browsers) ☒ en.wikipedia.org/wiki/Comparison_of_layout_engines_(Cascading_Style_Sheets) ☑ Un modelo no AR (lib/módulo) con todos los datos (hash) ☑ testeos unitarios (thin controller) ☑ eficiencia (sin procesos extra) ☑ mantenimiento (por ejemplo: haml + sass)
/lib/impresos/ejemplo.rbmodule Impresos class Ejemplo attr_accessor :datos def initializer(*params)... #recaba el hash :datos def render_options()... #decide la plantilla /app/controllers/ejemplo_controller.rbdef documento if @documento = Impresos::Ejemplo.new(params) render @documento.render_options else render(:nothing => true,:status => 404) endend /app/views/ejemplo/modelo/variante/documento.haml !!!XML!!!strict%html{html_attrs('es-es')} %head %title= @documento.datos[:titulo]
...
(Lleïr's version) wicked_pdf
wkhtmltopdf: http://code.google.com/p/wkhtmltopdf/Rails: http://github.com/lleirborras/wicked_pdf ☹ Necesita wkhtmltopdf (webkit) ☺ En la web de wkhtmltopdf ya hay versiones compiladas para
GNU/Linux, Mac Os y windows ☺ No require PHP, Java, ... ☺ Plantillas y helpers ☺ MUY rápido de maquetar (HTML, haml, ...) ☺ Admite Javascript ☺ MUY rápido en hacer el render ☺ Soporta para algunos tags de CSS3
/app/controllers/ejemplo_controller.rbdef show respond_to do |format| format.pdf do render :pdf => "name", :show_as_html => !params[:debug].blank? end endend
/config/initializers/wicked_pdf.rbWICKED_PDF = { :exe_path => '/usr/local/bin/wkhtmltopdf', :layout => 'pdf.html'}
/app/views/ejemplo/show.pdf.erb <h1>Hola en pdf!</h1>
$ script/plugin install git://github.com/lleirborras/wicked_pdf.git$ script/generate wicked_pdf
/app/views/layouts/pdf.html.erb<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <%= stylesheet_link_tag "pdf" -%> <%= stylesheet_link_tag "#{RAILS_ROOT}/public/stylesheets/pdf" -%> </head> <body> <div id="content"> <%= yield %> </div> </body></html>
http://localhost:3000/ejemplo/X.pdf?debug=1
En el tintero...
• PrinceXML: (http://www.princexml.com/)o Licencia de pago o Márgenes, paginación complicados
• ¿Público... ?
¿Preguntas?
Créditos (mantener al final)
Licencia del contenido: Creative Commons blabla
Ilustraciones:• [3] Old books: http://commons.wikimedia.org• [5] TUX-WC: Andrés Abad http://andresabad.wordpress.com• [6] 49 hand-drawing: Aleksandra Wolska http://iconfinder.net