I've always loved to read blogs, hackernews and such, but I always struggeled finding the right information.
This blog is an early prototype and an experiment.
My goal is to post articles about all kinds of JavaScript goodness, like a book with in-depth tutorials. With every tutorial this blog will become more of a JavaScript application and that code will be put to practice, so you can follow the progress for real.
If you know Javascript, but are new to JavaScript applications - you'll find everything here about how to build complex JavaScript applications. If you're a JavaScript novice, you might find useful tips and tricks, or you can fork my blog to help get the right information out there.
PS: I'm no native English speaker, so everyone who the mood to do some copywriting is welcome.
There are a few things you'll need to know when you want to get started with this blog.
- It's a prototype and not a fully functional blog!
- You'll have to know some basic knowledge of JavaScript
- Articles are written in Markdown
Still up to the task? You'll need to get started by installing Node. Once you've done that, clone this repo and head over to this folder.
Once you're ready, fire up a terminal and install all plugins by doing:
npm install
You'll also need the SASS compiler, which is a Ruby gem.
Check if you have Ruby installed ruby -v
(if not, I would recommend rvm). Then run gem install sass
and you're all set.
After that, you can simply fire up the blog by doing:
grunt watch
Now it'll open up a browser window, with the blog running.
So there are two folders. The /src
folder has all the actuall code in it, which compiles to /blog
.
Most of the time you'll have to look into the /src
folder. Although the articles are positioned in the /blog
folder for now. Check out blog/scripts/articles
.
To get started with your own markdown files, just remove mine and make one yourself. You'll notice that Grunt will stop running, because it's missing some files.
Head over to src/scripts/fixtures/articles.coffee
. In the top you'll need to require the markdown files you've made. Below is the code that makes the chapters. Please note, this is written in CoffeeScript.
Just change that code to whatever works for you. Open
stands for if the chapter should be open the first time and the arguments
array are the arguments what are passed by RequireJS.
If you'd like to run it on your webserver, you'll only need to use the /blog
folder for that. If you'd like to minify all the files, use:
grunt deploy
You'll have to include the script yourself in the index.html
file, instead of the Require file.