Giter VIP home page Giter VIP logo

blog's Introduction

Website and Blog

This is the repository for my personal website and blog. I tend to blog about tech and software, but also include other parts of my life from time to time.

To build the site, simply run

$ grunt build

which will use a combination of grunt tasks and jekyll to build the site. See the _site directory.

To serve the site locally, simply run

$ grunt serve

which will use a combination of grunt tasks and jekyll to locally serve the site and re-serve as changes are made. See localhost:4000.

To deploy the site to production, simply run

$ grunt deploy

which will push to both the GitHub repo (master) and the production server (deploy) that hosts the site.

Deploy with Ansible

$ ansible blog -m synchronize -a "src=/Users/jbranchaud/code/forks/blog/_site/ dest=/home/jbranchaud/www/joshbranchaud.com/public_html/"

Dependencies

  • npm
  • bower
  • grunt
  • jekyll 1.5.1

License

© 2013-2016 Josh Branchaud

Everything is licensed under the MIT License with the exception of the files and content contained within the _posts directory. See LICENSE for the details of the MIT License.

blog's People

Contributors

jbranchaud avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

blog's Issues

Add a Gemfile

Building the contents of the repo relies directly on ruby gems (namely, jekyll), so it should probably have a Gemfile. Get on it!

Display post tags next to post date in post layout

So far I haven't taken advantage of the tags feature provided by jekyll, I think it would be useful to start tagging posts and displaying the tags discretely toward the top, likely right next to the post date.

Move from Jekyll 1.5.1 to Jekyll 2.0

The site is currently using and being built with Jekyll 1.5.1, but that is so last year now. Time to get moved over to 2.0 ASAP. Shouldn't make much of a difference in any of the code, just need to bump the gem.

Add syntax highlighting for code blocks in posts

There are a lot of posts with code blocks, but no syntax highlighting is being applied. This means the code is less fun to read which in turn means the posts are less fun to read. This needs immediate attention!

Move this project to jbranchaud.github.io

Consider moving this repository from blog to jbranchaud.github.io. It is more of a full website than just a blog now and it would be helpful to follow the username.github.io convention for an account related website.

Update version of font awesome

The version of font awesome currently being used on this site is sorely out of date (as in major version numbers out of date). I should update it if I am going to continue to use it.

Add favicons

Add some custom favicon images to this repo so that it doesn't use the default gandi.net ones anymore.

Add markup for twitter cards

Look into adding twitter card markup to the posts so that they look better when linked in a tweet. Not really sure what all this requires at this point.

Rethink assets structure and build stategy

I made a decision the other week to move all the css, js, etc. to the assets directory instead of having Grunt do it. This decision is related to an issue with Jekyll which going all or nothing on excluding the css directory (thus, also excluding the assets/css directory).

The problem now is that my local development environment is crowded with a list of untracked files in the assets whenever I do a git status.

Either go back to the original strategy and see how to get Jekyll to play nicely or try moving the third-party stuff to a vendor directory and ignore just that.

Try setting up gulp

We've had some fun with Grunt, see what Gulp is like by setting it up to automate the same tasks as Grunt is currently automating.

Change post listings from series of divs to unordered lists

All of the places where posts are listed on the site use a series of div tags that are enumerated by liquid templating engine, rather than list items in an unordered list. I think it is a better practice to use an unordered list and it also gives access to css features like :first and :last.

Make the default layout mobile-friendly again

When updating the design of the website, I temporarily ditched the mobile responsiveness of the site (is this mobile-not-first development?). Now that the new design is basically settled, it is time to make it friends with the mobile phone again.

Maruku is experiencing liquid link processing issues

This doesn't seem to impact the html that is generated, but there a bunch of errors/warnings that pop up when Maruku tries to process the links that contain liquid syntax for links to other posts. It would be good to clean these up at some point.

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.