🇪🇸 Este post está escrito en inglés y español. Puedes encontrar el texto en español más abajo.
🇺🇸 After you create a few documents in R Markdown or Quarto, you’ll start noticing that the output format is way more important to your audience than the content itself. Why? Because if the format is not user friendly or is not appropriate for the decision making process, your audience won’t read your insights. If this happens, then your document has lost its purpose.
Have you ever been in this position? Do you keep wondering why people don’t read your reports, slides, or papers?
Do not even try blaming your audience. It’s easy for a researcher or data scientist to feel like our audience should be excited about our findings. However, this feeling is a psychological obstacle in our way. WE are responsible for packaging and talking about findings in ways that create interest and engagement in our audience.
Paged HTML documents: Create a bridge between you and your audience
A good challenge to take on early in your learning process is to learn how to create documents that people will want to read. Enter paged HTML documents.
Broadly, these documents are created as websites (at least their skeleton is HTML code) and you can style them as really cool documents. This is possible thanks to two amazing libraries: {pagedown} and paged.js. You’ll learn more about these libraries as we explore paged HTML documents in the next few posts, but if you are eager to know more about them, start here and here.
Why should you learn about paged HTML documents?
You can have more control over what your document looks like. Therefore, you can use fonts, layout, and many more tools to communicate successfully.
You will be forced to learn a bit of
CSSandHTML. This is especially useful if your work involves building digital products, whereCSSandHTMLare languages commonly used to communicate more effectively. Learning a bit ofCSSandHTMLwill help you think differently about how you structure a document and communicate findings.You will create trust in
Ras a tool. Others will see your document and realize thatRis much more than a fancy calculator.You will develop a foundation of knowledge that you can use to build fancier products in the future. For example, learning how to build
Shinydashboards will be much easier after you practice usingR,CSS, andHTML.
Side Note: Quarto vs R Markdown
Many of you are probably wondering whether paged HTML documents are created using Quarto or R Markdown. As of today, these documents can only be created in R Markdown based on the Quarto FAQs. However, Posit is planning to support paged HTML documents in the future. So, depending on your goals and needs, you may try paged HTML documents as a proof of concept or as a final product. Regardless, trying to build paged HTML documents will help you learn many foundational skills that you can apply to your next big project.
🇪🇸 Después de crear algunos documentos en R Markdown o Quarto, comenzarás a notar que el formato de salida es mucho más importante para tu audiencia que el contenido en sí. ¿Por qué? Porque si el formato no es fácil de usar o no es apropiado para el proceso de toma de decisiones, tu audiencia no leerá tus resultados. Si esto sucede, entonces tu documento ha perdido su propósito.
¿Alguna vez has estado en esta posición? ¿Sigues preguntándote por qué la gente no lee tus informes, diapositivas o artículos?
Ni siquiera intentes culpar a tu audiencia. Es fácil para un investigador o científico de datos sentir que nuestra audiencia debería estar emocionada con nuestros hallazgos. Sin embargo, este sentimiento es un obstáculo psicológico en nuestro camino. NOSOTROS somos responsables de empaquetar y hablar sobre los hallazgos de maneras que creen interés y compromiso en nuestra audiencia.
Documentos HTML paginados: crea un puente entre tú y tu audiencia
Un buen desafío para asumir al principio de tu proceso de aprendizaje es aprender a crear documentos que la gente querrá leer. Por eso quiero que aprendas sobre documentos HTML paginados.
En términos generales, estos documentos se crean como sitios web (al menos su esqueleto es código HTML) y puedes diseñarlos como documentos realmente geniales. Esto es posible gracias a dos increíbles bibliotecas: {pagedown} y paged.js. Aprenderás más sobre estas bibliotecas a medida que exploremos los documentos HTML paginados en las próximas publicaciones, pero si estás ansioso por saber más sobre ellos, comienza aquí y aquí.
¿Por qué deberías aprender sobre documentos HTML paginados?
Puedes tener más control sobre cómo se ve tu documento. Por lo tanto, puedes usar fuentes, diseño y muchas más herramientas para comunicarte con éxito.
Te verás obligado a aprender un poco de
CSSyHTML. Esto es especialmente útil si tu trabajo implica construir productos digitales, dondeCSSyHTMLson lenguajes comúnmente utilizados para comunicar de manera más efectiva. Aprender un poco deCSSyHTMLte ayudará a pensar de manera diferente sobre cómo estructuras un documento y comunicas hallazgos.Crearás confianza en
Rcomo herramienta. Otros verán tu documento y se darán cuenta de queRes mucho más que una calculadora elegante.Desarrollarás una base de conocimientos que puedes usar para construir productos más sofisticados en el futuro. Por ejemplo, aprender a construir tableros
Shinyserá mucho más fácil después de practicar conR,CSSyHTML.
Nota al margen: Quarto vs R Markdown
Muchos de ustedes probablemente se preguntan si los documentos HTML paginados se crean usando Quarto o R Markdown. Hasta el día de hoy, estos documentos solo pueden ser creados en R Markdown según las preguntas frecuentes de Quarto. Sin embargo, Posit planea admitir documentos HTML paginados en el futuro. Entonces, dependiendo de tus metas y necesidades, puedes probar los documentos HTML paginados como una prueba de concepto o como un producto final. Independientemente, intentar construir documentos HTML paginados te ayudará a aprender muchas habilidades fundamentales que puedes aplicar a tu próximo gran proyecto.