Hi Matt, Sorry about the delay--I've been swamped recently. I'll have something based on Rich's response tomorrow. Sound good?
Mike On Thu, Aug 27, 2009 at 7:52 PM, Matt Aimonetti <mattaimone...@gmail.com>wrote: > 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 > >
_______________________________________________ MacRuby-devel mailing list MacRuby-devel@lists.macosforge.org http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
