Miyagi is a Heroku-inspired journal of application development. It is meant to serve as an educational tool for developers wishing to stay at the edge of their craft and as an outlet for practitioners to give others insight into their techniques.
Miyagi is open to all contributors that wish to speak to a diverse audience of technologists.
Miyagi uses Middleman, a Ruby-based static site generator, to render the site in development mode. Get Miyagi running locally with the following steps:
git clone git://github.com/rwdaigle/miyagi.git && cd miyagibundle installmiddleman- open
http://localhost:4567
Miyagi uses the livereload mechanism during development to automatically reload the site when a file changes. This makes writing in Markdown alongside the real-time rendered article a reality.
We welcome contributors across disciplines - web dev, Ruby, Clojure, Go, Javascript, front-end, mobile etc... If you have an interest in promoting a particular technique, perspective or vision please get in touch with rd at heroku.com.
Once you are comfortable that your topic is appropriate for Miyagi contributing is as easy as forking this repo and creating a new markdown file in the articles directory. Copy the frontmatter from an existing article to get started.
Miyagi supports Github flavored markdown so you can use other tools such as Gists during the writing phase before merging into Miyagi.
Miyagi's main purpose is to free the thoughts that are so often locked within developers' heads. One observation from working with technical content in a variety of roles is that the hardest part is often the structuring of the idea and the putting it on paper. To remove those bottlenecks we're experimenting with performing short interviews from which a ghost-writer will write the article for you. Please let us know if you'd like to explore this approach: rd at heroku.com.
Though it is a static site, Miyagi runs on Heroku and utilizes the multi-buildpack to chain the middleman buildpack and nginx buildpack. This allows site generation to occur when you do a git push heroku master and serves the content via the very fast nginx.
To deploy your own Miyagi:
git clone git://github.com/rwdaigle/miyagi.git && cd miyagiheroku create --buildpack git://github.com/ddollar/heroku-buildpack-multi.githeroku config:set HOST=mysite.comgit push heroku masterheroku open