Awesome Blogdown

Overview:

Awesome Blogdown is a curated list of blogs that are built using the blogdown or hugodown tools. It allows users to easily discover and explore blogs created with R, RMarkdown, and Hugo. The websites built using these tools are rendered to static files, simplifying the process of publishing and hosting. The Awesome Blogdown website is driven by a JSON file that is automatically updated based on the contents of the JSON directory. Users can contribute to the list by creating an issue or adding their own site through a pull request. The site is hosted on Netlify and is available at awesome-blogdown.com.

Features:

• Curated List of Blogs: Awesome Blogdown provides a curated list of blogs that are built using blogdown or hugodown.
• Easy Contribution: Users can easily add their own sites to the list by creating an issue or submitting a pull request.
• JSON Data Structure: The list of blogs is stored in a JSON file, allowing for easy management and updates.
• Static File Rendering: Both blogdown and hugodown render websites to static files, simplifying the publishing and hosting process.
• Version Control: By rendering sites to static files, users can easily version control their websites.
• CI GitHub Action: The Awesome Blogdown site is built and deployed using a manually triggered CI GitHub action.
• Netlify Hosting: The site is hosted on Netlify, ensuring reliable and scalable hosting for the Awesome Blogdown website.

Installation:

To add your site to the Awesome Blogdown list, follow these steps:

1. Create a new file in the JSON directory using the convention ‘.json’. For example, if your site is hosted at ‘rstats.example.com’, name the file ‘rstats.example.com.json’.
2. In the new file, provide a short JSON snippet describing your site. Refer to the existing files in the JSON directory for guidance on the structure and content.
3. Submit a pull request with your changes to the Awesome Blogdown repository.

Summary:

Awesome Blogdown is a valuable resource for discovering and exploring blogs built using blogdown and hugodown. It provides a curated list of blogs and allows users to easily contribute their own sites. The website is rendered to static files and hosted on Netlify. Adding a site to the list involves creating a JSON file and submitting a pull request. The project is open-source and driven by a single JSON file. Overall, Awesome Blogdown simplifies the process of finding and sharing blogs created with R, RMarkdown, and Hugo.