Git Product home page Git Product logo

awesome-blogdown's Introduction

Awesome Blogdown

An awesome curated list of blogs built using blogdown or hugodown.

You'll find the Awesome Blogdown website at awesome-blogdown.com.

About Blogdown and hugodown

Blogdown and hugodown both allow you to build websites using R, RMarkdown and Hugo, but they work in slightly different ways. Check out their project website for more information on the fifferences. In both cases though, sites are rendered to static files which simplifies publishing and hosting, at the same time as allowing you to easily version control your site.

Contributing to the list

The easiest way to add a site that uses blogdown or hugodown to this list is to create an issue with the relevant information. We'll confirm that it's using one of the packages and add the site. If you're interested in how Awesome Blogdown works, or would prefer to add your site yourself, read on!

The Awesome Blogdown website is driven from a single json file that gets deployed to the website. This file is automatically built from the contents of the json directory.

To add your site, create a new file in the json directory, using the convention '.json', for instance, if your site were hosted at 'rstats.example.com' the filename to use would be 'rstats.example.com.json'.

The new file should contain a short json snippet that describes your site. The structure is as follows:

{
  "name": "the name of the blog",
  "url": "https://the.url.of.the.blog.com",
  "desc": "A brief description of the blog"
}

Have a look at the some of the other files in the json directory to get an idea of the structure and what's been added for other sites, and then create a pull request with your changes.

Using the Awesome Blogdown data

The json file containing all the data is served from http://awesome-blogdown.com/sites.json.

If you do end up using it for something, let me know, I'd love to hear about it!

Site build and deployment

The site is built and deployed by manually trigerring the CI GitHub action.

Site hosting is handled by Netlify.

License

MIT © Mark Sellors

awesome-blogdown's People

Contributors

acolum avatar andrewheiss avatar antoinesoetewey avatar aurora-mareviv avatar bixby96 avatar cyrusyip avatar datastrategist avatar dominiquemakowski avatar dshkol avatar evanodell avatar floresfdev avatar foundinblank avatar gadenbuie avatar guyabel avatar ivelasq avatar jacobkap avatar jennaallen avatar jlacko avatar jlistman avatar joseechave avatar joseper avatar jozefhajnala avatar kelseygonzalez avatar lebebr01 avatar leovan avatar matt-dray avatar mrchypark avatar rpodcast avatar sellorm avatar statnmap avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

awesome-blogdown's Issues

implement a json checker that can run in CI

At the moment, when updates are applied to the main site json file no checks are performed on the structure of the json itself.

This means it's possible for an update to break the site through malformed json.

It should be reasonably straightforward to write something that travis can use to check the validity of the json syntax before updates are accepted, or at least alerts in the event of an error.

fix the favicon

currently shows the default 's' icon from the skeleton css framework

website not available - https://jsonbaik.rbind.io

Hi @jasonbaik94,

Your blogdown site appears to be unavailable.

Is this expected on at your end?

Just checking as it's still listed on awesome-blogdown.com but my checker is throwing an error for it.

Cheers,
Mark

Feature request: Add fields for hugo theme and htmlwidgets

Thanks for doing this.

Just a quick idea, along the lines of my SO question: Would it be possible to add fields for the hugo theme being implemented and whether htmlwidgets are working on the site? I only ask, as this would be really helpful to me (and presumably others) in choosing which hugo theme would work best, given the needs in question.

Thanks again.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.