Blogpost Instructions

A Step by Step Guide

To create a blogpost that will be featured under the Projects tab, follow these steps:

1. Create a Service Request
   Submit a service request so we can help you with the process.

2. Review Documentation
   Check out the Quarto Documentation page—pay particular attention to the section on Markdown basics.

3. Download the Template
   Download the blogTemplate folder from above and customize it to suit your content.

4. Coordinate with the WDH Team
   Communicate with your assigned WDH team member for guidance on how to get your post featured on the website.

---

Making Your Blogpost Work

Our website has some constraints regarding inline code execution and interactive dashboards. To ensure your blogpost displays correctly:

• Code Formatting:
  Use markdown code fences to format any code snippets. This helps maintain readability and prevents execution issues.

• Interactive Content:
  Interactive elements (such as dashboards or widgets) may not render as expected. Consider:

  • Converting interactive content into static images.
  • Hosting interactive elements externally and linking to them.

• Dependencies:
  Minimize external dependencies that could affect load times or display issues on our site.

• Local Testing:
  Preview your post locally using Quarto to confirm that everything renders as expected. Check for any discrepancies in formatting or functionality.

• Assistance:
  If you run into issues with code or interactive elements, reach out to your assigned WDH team member for troubleshooting and support.

---

Submitting Your Blogpost

Once your blogpost is ready:

1. Save Your Work:
   Ensure that all changes are saved and that your file follows any naming conventions provided by the WDH team.

2. Submit for Review:
   Share your customized .qmd file with your assigned WDH team member.

3. Revise if Necessary:
   Incorporate any feedback provided to ensure your post meets the website’s requirements.

4. Post Approval:
   After approval, your blogpost will be scheduled and featured under the Projects tab on our website.

---

Additional Tips

• Version Control:
  If you’re familiar with version control systems (like Git), consider using them to track changes and collaborate with peers.

• Further Resources:
  Besides the Quarto docs, you might find it helpful to review markdown guides and best practices available online.

• Contact:
  For any questions or additional support, do not hesitate to contact your WDH team member.

Happy blogging!