tilburgsciencehub / website

Learn to work more efficiently on empirical research projects.
https://tilburgsciencehub.com
38 stars 46 forks source link

[Content Request] Quarto tutorial #1144

Open Fernando-Iscar opened 3 months ago

Fernando-Iscar commented 3 months ago

@alexandervossen and I had a meeting few days ago to talk about Quarto. He showed me with a practical example how easy it is with Quarto to automate reporting tasks, like making a presentation or a pdf showing the analysis results. We could use music-to-scrape website data to showcase how to build this reports with Quarto. But also, showcase its ability to easily build static websites. Here's a bit more context:

Context

Quarto is a powerful tool that enables users to create a variety of content types, from static websites to interactive reports, with ease. Its versatility makes it an invaluable resource for data analysts, professors, researchers, and students who wish to present their findings in a structured and visually appealing manner. Quarto allows for the integration of streaming data, supports automation of reports through scripting, and offers export options in multiple formats including PDF, HTML, and more. This flexibility is crucial for tailoring outputs to specific audiences and purposes. Given the potential of Quarto to enhance data presentation and facilitate content sharing online, there is a significant opportunity to empower our audience with the knowledge to leverage Quarto in their projects.

Deliverables

The goal is to create a comprehensive tutorial that introduces Quarto to our audience, covering its key capabilities and applications in a way that is accessible to beginners while also providing valuable insights for more experienced users. The tutorial should include:

  1. Introduction to Quarto: A brief overview of what Quarto is and its primary features.
  2. Installation Guide: Step-by-step instructions on installing Quarto and setting up the necessary environment.
  3. Creating Your First Document: A simple starter project to get users familiar with Quarto's syntax and basic functionalities.
  4. Integrating Data: How to incorporate both static and streaming data into Quarto documents.
  5. Automating Reports: Demonstrating the process of scraping data from websites, analyzing it, and automating the generation of reports with tables, graphs, and other visualizations.
  6. Exporting Documents: Instructions on how to export Quarto documents to various formats (PDF, HTML, etc.) for different purposes.
  7. Advanced Tips and Tricks: A section dedicated to more sophisticated techniques and best practices to enhance the quality and efficiency of content creation with Quarto.
Fernando-Iscar commented 3 months ago

@alexandervossen what do you think of the proposed structure? would you maybe split it in two topics, one for guiding on how to use Quarto for building websites and another one on how to use it to automate reporting tasks?

alexandervossen commented 2 months ago

Yes - I think splitting makes sense 👍