[MacRuby-devel] Any volunteers to help maintain http://www.macruby.org?
Mike Sassak
msassak at gmail.com
Thu Aug 20 10:27:31 PDT 2009
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 <rich at 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 <mattaimonetti at 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 at lists.macosforge.org
> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
>
>
> Rich Kilmer
> 571.229.2374 (cell)
> rich at infoether.com
>
>
>
>
> _______________________________________________
> MacRuby-devel mailing list
> MacRuby-devel at lists.macosforge.org
> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macruby-devel/attachments/20090820/138c22e5/attachment.html>
More information about the MacRuby-devel
mailing list