Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marionettejs/blog

:memo: Blog for Marionettejs.com (hosted on the gh-pages branch)
https://github.com/marionettejs/blog

Last synced: 2 months ago
JSON representation

:memo: Blog for Marionettejs.com (hosted on the gh-pages branch)

Awesome Lists containing this project

README

        

# Marionette Blog
![screenshot](screenshot.png)

### This blog is built using [Hexo](http://hexo.io).

### Topic suggestions
Please create a new [GitHub issue](https://github.com/marionettejs/blog/issues/new) for topic ideas that you would like us to write about

### Steps to get it running:

##### 1. Fork this repo

##### 2. `npm install`

##### 3. To create a new post in markdown: `hexo new draft `

##### 4. Edit the file with your file name in this directory: [\_drafts](https://github.com/marionettejs/blog/tree/master/source/_drafts)

##### 5. Edit your title at top of the file

##### 6. Add a tag at the top of the file so that it can be filtered, choose from:
* `tags: news`
* `tags: notes`
* `tags: releases`
* `tags: tutorials (beginner)`
* `tags: tutorials (intermediate)`
* `tags: tutorials (advanced)`
* `tags: behind the scenes`

*Note: Make sure you add a space after the colon*

##### To add multiple tags:

tags:
- news
- releases

##### 7. Add your name as the last tag (after the word `by`):
tags:
- news
- by Uncle Bob

*Note: Make sure you write your name the same way for all posts so it filters correctly (so no Uncle Bob one week and Uncle Bobby the next)*

##### 8. To edit a post that has been **published**, edit the file in this directory: [\_posts](https://github.com/marionettejs/blog/tree/master/source/_posts)

##### 9. Turn on the server: `hexo s` (if port 5000 is being used already, try `hexo s -p 4000`)

##### 10. Preview your post at: [localhost:5000](http://localhost:5000)

##### 11. Once you're satisfied with your changes, send a pull request

----

### Steps to go live:

##### 12. To publish a post (moves a post from [\_drafts](https://github.com/marionettejs/blog/tree/master/source/_drafts) to [\_posts](https://github.com/marionettejs/blog/tree/master/source/_posts) directory): `hexo p `

##### 13. To generate static files into the `public` folder for hosting: `hexo generate`

##### 14. To preview the blog: open the `index.html` file in the `public` folder

##### 15. One time setup:

* `cd public`
* `git init`
* `git remote add live [email protected]:marionettejs/blog.git`

##### 16. To push to the `gh-pages` branch - NOT MASTER - (this is where [blog.marionettejs.com](http://blog.marionettejs.com) is hosted on GitHub):
* Make sure you're still in the `public` directory
* `git add .`
* `git commit -m 'publish ' && git push live master:gh-pages`

### Adding Images
There's a matching folder with the same name as your post. Save you image(s) in that folder.

##### To link to the image:

![alt text](/path/to/img.png "Title")

### Code Highlighting

##### Backtick code block

``` [language]

code snippet

```

##### More info on formatting: [http://hexo.io/docs/tag-plugins.html](http://hexo.io/docs/tag-plugins.html)

### Disqus Syntax Highlighting
If you're responding to a comment on Disqus and want syntax highlighting, place your code inside `

` tags. For example:



var foo = 'bar';
alert('foo');

*Happy blogging!*

***************************
###### Got questions? Contact [@jdaudier](https://github.com/jdaudier) at [![Gitter chat](https://badges.gitter.im/marionettejs/backbone.marionette.png)](https://gitter.im/marionettejs/backbone.marionette)