[Kde-bindings] Can I put my 'Developing Ruby apps with the QT Designer' tutorial somewhere on KDE Techbase?

[Declan McGrath]

Hi,

I was thinking that there is a better way than overriding the setup_ui funtion, thanks. I've made some big changes to the article last night once I figured that out http://techbase.kde.org/User:Declan.mcgrath

Hopefully, it is now more correct whilst still being easy to follow.

Niels, I will look at the changing the font like you suggested. I've found your article at http://techbase.kde.org/Development/Tutorials/Plasma/Ruby/GettingStarted so will dig out and handy wiki formatting from that.

Thanks to everyone for the feedback to date and hope to have the article ready soon.

All the best,
Declan




On Wednesday 19 August 2009 22:24:23 Niels Slot wrote:
> In C++ it is common to call the setup_ui method from the constructor. Maybe
> you can do that in the tutorial as well. This also saves you one call when
> start the application (just calling w.show is enough, no need to call
> setup_ui since the constructor takes care of that).
> 
> I still have some small remarks about the markup. In my tutorial I put all
> references to code in a typewriter font. I believe this makes it a lot
> clearer to the reader when you're referring to code. I also put all commands
> in a '<code bash>' block. You can do that with the apt-get commands.
> 
> I think the tutorial looks nice and would make a great addition to the
> existing Techbase tutorials. If nobody else has any comments, I suggest you
> move it to an official location.
> 
> Niels
> 
> 2009/8/17 Declan McGrath <declan at divilment.com>
> 
> > Thanks for the feedback Niels, that's great. I will look at implementing
> > your suggestions soon and I'll post here when done.
> >
> > Also, can anyone advise as to whether overriding setup_ui() was the correct
> > thing to do in order to add some items to the list - or is there a 'more
> > correct' way of doing this?
> >
> > All the best,
> > Declan
> >
> >
> > On Sunday 16 August 2009 17:33:12 Niels Slot wrote:
> > > Hi Declan,
> > >
> > > First of all, I'm not one of the QtRuby developers, nor a maintainer of
> > > Techbase articles. I did wrote one of the Ruby tutorials for Plasma and
> > have
> > > 2 years of Ruby experience.
> > >
> > > I looked through your tutorial. Basically, it looks nice. You tell the
> > > reader how Qt Designer works and show sufficient code examples. The
> > tutorial
> > > is also very verbose, there's no way anyone could miss a step.
> > >
> > > There are some small things that you could do to make it better:
> > >
> > > - You can use the '<code ruby>' tags. This will enable Ruby highlighting
> > for
> > > snippets of code. There are also special tags for things like tips and
> > > warnings.
> > > - Please use 'Qt' not 'QT' when talking about the toolkit.
> > > - You might want to think about your usage of bullets and numbers in the
> > > lists. Try to separate the 'do this and that' from the explanation. In
> > the
> > > paragraph 'Creating the basic application structure' for example you have
> > > 'run the rbuic4 command' and the explanation of its options on the same
> > > level.
> > > You could also, in general, put more of the text as normal text instead
> > of
> > > as lists.
> > > - The tutorial could use an abstract. Possibly an introduction and maybe
> > > some screenshots.
> > >
> > > Great work, I look forward to your reply.
> > >
> > > Niels
> > >
> > > 2009/8/15 Declan McGrath <declan at divilment.com>
> > >
> > > > Hi folks,
> > > >
> > > > I'm just drafted a tutorial on developing Ruby apps with the QT
> > Designer on
> > > > Ubuntu at http://techbase.kde.org/User:Declan.mcgrath
> > > >
> > > > If you think it might be useful for your techbase then please let me
> > know
> > > > with feedback and a location that I can move the page to.
> > > >
> > > > I'm new to using QT with the Ruby bindings so I've almost certainly
> > gotten
> > > > some things wrong but I think it would be useful to have an article
> > that
> > > > combines using Ruby and the QT Designer. I can't find any such
> > articles. A
> > > > quick googling of 'ruby qt' gave
> > > >
> > > > * http://www.darshancomputing.com/qt4-qtruby-tutorial
> > Doesn't
> > > > mention using QT Designer
> > > > * http://techbase.kde.org/Development/Languages/Ruby          Doesn't
> > > > really explain the steps you'd go through with a new simple Ruby app
> > > > starting with QT Designer - a lot of 'noise' for the newbie
> > > > * http://www.kdevelop.org/doc/technotes/rubyrad.html              Out
> > of
> > > > date and KDE only
> > > > * http://www.arachnoid.com/ruby/RubyGUIProject/
> > I
> > > > found this the most useful. Still not simple enough and a bit out of
> > date
> > > >
> > > > Kind regards,
> > > > Declan
> > > > _______________________________________________
> > > > Kde-bindings mailing list
> > > > Kde-bindings at kde.org
> > > > https://mail.kde.org/mailman/listinfo/kde-bindings
> > > >
> > >
> >
> >
>