Hey Mike, any updates on the blog post? Let me know if you need assistance.
- Matt On Thu, Aug 20, 2009 at 10:27 AM, Mike Sassak <msas...@gmail.com> wrote: > What version of Webby is everyone using? I'm on the latest (0.9.4) and was > getting errors from the blog:post task until I replaced tasks/blog.task with > the one created by 'webby-gen blog'. You can see the changes here: > http://github.com/msassak/macruby_website/commit/f262f91c099186fc74f2b1e0c9e4099f0ed1ff67#diff-1. > They're small, but made all the difference. :-) > > I'll create a tutorial out of Rich's post and let the list know when I've > pushed it. > > Mike > > On Thu, Aug 20, 2009 at 9:07 AM, Richard Kilmer <r...@infoether.com>wrote: > >> This is from something I wrote a while ago on how to write a recipe but >> did not post to the site. I added stuff on how to do blog posts too. >> Writing a recipe/blog post for the MacRuby website is very easy. First, >> you need to get the MacRuby website source checked out on your computer. >> >> (This can be replaced with Matt's git instructions) >> svn checkout >> http://svn.macosforge.org/repository/ruby/MacRubyWebsite/trunkmacruby_website >> >> You also need to have Webby installed. Webby is a RubyGem that builds >> websites from static files. The MacRuby website is built with Webby. You >> will also need to install CodeRay which is used to render source code. >> Lastly, you will need to install RedCloth for textile formatting. >> >> (sudo) gem install webby >> (sudo) gem install coderay >> (sudo) gem install RedCloth >> >> Now that we have webby, and we have the MacRuby website local, we will use >> webby to generate our recipe and then use webby to visualize it. >> >> *Generating your Recipe* >> >> Change your directory to the root of the website. You then will generate >> the recipe from the template: >> >> cd macruby_website >> webby create:recipe recipes/my_cool_recipe >> >> Just change *my_cool_recipe/blog_post* with a unique name for your recipe >> name. If you want just preface it with your name like >> *rich_kilmer_my_cool_recipe*. This will generate that file. Now you open >> the generated file and update the header information: >> >> title: rich_kilmer_my_cool_recipe >> created_at: 2009-04-17 15:07:10.638684 -04:00 >> recipe: true >> author: Your Name Here >> >> You will want to change that title to be more expressive. And then >> replace 'Your Name Here' with your name. >> >> *Generating a Blog Post* >> >> This generates a blog post: >> >> cd macruby_website >> webby blog:post my_cool_blog_post >> >> You will see output such as: >> >> [09:00:21] INFO: creating content/blog/2009/08/index.txt >> [09:00:21] INFO: creating content/blog/2009/08/20/my-cool-blog-post.txt >> >> So there you see it created a structure with today's date and your next >> post's template. You can then edit the template like was indicated above >> for the recipe...changing the title and author YAML fields. >> >> --- >> title: my_cool_blog_post >> created_at: 2009-08-20 09:00:21.829275 -04:00 >> blog_post: true >> layout: blog_entry >> author: Your Name Here >> filter: >> - erb >> - textile >> --- >> >> You can see here that this template can use textile format. >> >> *Webby Autobuild and Local Preview* >> >> Its helpful to put webby in 'autobuild' mode so you can write and preview >> your recipe or blog post. >> >> webby autobuild >> >> This compiles and builds the MacRuby website locally and starts up a local >> server and then opens a browser pointed at the local service. If you click >> on the Documentation tab you will see your new recipe listed there. >> Clicking on its link to your article in the browser will show you the >> article so far. If you then edit your recipe webby will detect that change >> and rebuild your recipe page. Refresh the browser and you see your updates >> live! >> >> Best, >> >> Rich >> >> >> On Aug 20, 2009, at 3:04 AM, Mike Sassak wrote: >> >> On Thu, Aug 20, 2009 at 1:01 AM, Matt Aimonetti >> <mattaimone...@gmail.com>wrote: >> >>> Alright, things are now setup and contribution should be easier (patches >>> against svn are also accepted). >>> >>> How to contribute content for the website using github: >>> >>> * fork the website repo on github: >>> http://github.com/mattetti/macruby_website/ >>> * clone and pull your branch locally >>> * create a new topic branch, work on the post, git rebase >>> interactive/squash commits >>> * push your branch/commit to your branch and email the list/me to let us >>> know that the article is ready >>> * I'll cherry pick your commit and push it to the svn repo >>> * after verification, Laurent will redeploy the site. >>> >>> Advice: >>> >>> * try to communicate with other contributors so we don't end up with 2 >>> people working on the same post. >>> * if you want to cover something that isn't a status update or major >>> change, please get in touch with one of us or post to the mailing list. >>> * I might be on a trip or not available so don't hesitate to send me a >>> reminder or contact the mailing list if I don't get back to you. >>> >>> Technical details about the blog engine: >>> >>> The website is developed using webby http://webby.rubyforge.org/ >>> You obviously need to have webby installed on your machine. ($ sudo gem >>> install webby) >>> Using $ webby autobuild will let you preview the site in your browser.(it >>> should run and open http://localhost:4331/) >>> To create a new blog post template, simply do: $ webby blog:post >>> >>> Mike, if that's ok with you, could you write a tutorial ($ webby >>> create:tutorial ) on how to write and submit a blog post? >>> >> >> That's just fine with me. I forked your repo and am fiddling with the blog >> task a bit before going to bed. It appears to be looking for defaults >> missing from the Sitefile. Is anyone else having this problem? (MRI 1.8.7, >> Webby 0.9.4) I'll let everyone know how it goes tomorrow. >> >> Mike >> _______________________________________________ >> MacRuby-devel mailing list >> MacRuby-devel@lists.macosforge.org >> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel >> >> >> Rich Kilmer >> 571.229.2374 (cell) >> r...@infoether.com >> >> >> >> >> _______________________________________________ >> MacRuby-devel mailing list >> MacRuby-devel@lists.macosforge.org >> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel >> >> > > _______________________________________________ > MacRuby-devel mailing list > MacRuby-devel@lists.macosforge.org > http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel > >
_______________________________________________ MacRuby-devel mailing list MacRuby-devel@lists.macosforge.org http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
