[MacRuby-devel] Any volunteers to help maintain http://www.macruby.org?

Matt Aimonetti mattaimonetti at gmail.com
Mon Aug 31 10:14:39 PDT 2009 

I'll review that today, thanks a lot.

- Matt

p.s: you can use the editorial "we", no worried about that.

On Fri, Aug 28, 2009 at 2:02 PM, Mike Sassak <msassak at gmail.com> wrote:

> Hi Matt,
>
> You can see my draft at
> http://github.com/msassak/macruby_website/tree/tutorials/contributing-to-the-website.
> It's in content/documentation/website-contributions.txt. The flow from one
> section to another could be improved in places, and I think it might be
> better if I used the editorial "we" consistently rather than mentioning you
> and Laurent by name, but all in all I think it's in pretty good shape.
>
> I had to replace the rake blog tasks with those generated by the newest
> version of Webby (0.9.4) to get them to work for me, and I added a gitignore
> file, but all those changes are in separate commits.
>
> Let me know what you think, and what changes need to be made, etc.
> Mike
>
>
> On Thu, Aug 27, 2009 at 11:00 PM, Matt Aimonetti <mattaimonetti at gmail.com>wrote:
>
>> Awesome, don't hesitate to contact me if you need help.
>>
>> - Matt
>>
>>
>> On Thu, Aug 27, 2009 at 7:47 PM, Mike Sassak <msassak at gmail.com> wrote:
>>
>>> 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 <mattaimonetti at 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 <msassak at 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 <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
>>>>>>
>>>>>>
>>>>>
>>>>> _______________________________________________
>>>>> MacRuby-devel mailing list
>>>>> MacRuby-devel at lists.macosforge.org
>>>>> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
>>>>>
>>>>>
>>>>
>>>> _______________________________________________
>>>> MacRuby-devel mailing list
>>>> MacRuby-devel at lists.macosforge.org
>>>> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
>>>>
>>>>
>>>
>>> _______________________________________________
>>> MacRuby-devel mailing list
>>> MacRuby-devel at lists.macosforge.org
>>> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
>>>
>>>
>>
>> _______________________________________________
>> MacRuby-devel mailing list
>> MacRuby-devel at lists.macosforge.org
>> http://lists.macosforge.org/mailman/listinfo.cgi/macruby-devel
>>
>>
>
> _______________________________________________
> 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/20090831/e624c6e8/attachment.html>

More information about the MacRuby-devel mailing list