Stu’s Greatest Hits (Tools)

I make no excuses for this list. These are the tools that I use every day. They are what I consider to be important for development.

That doesn’t mean I won’t change though, or be persuaded otherwise. I’m always hearing of other tools that sound great. Sometimes it’s a monetary restriction. Other times it’s a busy factor. Hopefully I’ll get to most of them.

Information Tools

Product Tools

Honorable Mention Tools

Information Tools

The Newsgroups (news.softvelocity.com)[Back To Listing]

The Newsgroups provide the largest amount of information relating to Clarion (that I know of).

You get answers to questions. You have the questions themselves. The 3rd-Party newsgroup is a most excellent source of specific product questions.

You get information regarding the Clarion Community across the world; What is happening in various countries; The meetings, gatherings, beer swilling.

You get people at their best, and at their worst.

The one true issue I have with the newsgroups is their inability to provide me with accurate and complete searching capabilities. The Google Groups version of comp.lang.clarion goes some of the way, but (as far as i know) it’s not an up-to-date mirror of the actual newsgroup. And that doesn’t account for any of the other individual newsgroups.

Clarion Mag (http://www.clarionmag.com)[Back To Listing]

Clarion Mag really does stomp all over the Newsgroups in a couple of key areas. Much better contextual searching; and it’s got a great Editor (Dave Harms).

Clarion Mag’s range of articles is large. They are written well, edited (as mentioned) well, and the presentation of the site is clean and simple.

Subscription may frighten some people off. Don’t let it. The benefit massively outweighs the paltry fee (less than two hundred big boys). You have a huge contextual well-written repository of information .. that’s peace of mind for problem-solving.

ClarionShop (http://www.clarionshop.com)[Back To Listing]

I know, bad data mapping huh. ClarionShop isn’t really an "Information" site.

ClarionShop is the best place to buy 3rd-Party Templates and Software.

The folks there are friendly and the service is top-notch.

NetTalk Central (http://www.nettalkcentral.com)[Back To Listing]

This site (it’s forums are the main attraction) has quickly become one of the busiest in the Clarion Community.

For anything NetTalk, particularly the Web Server, head on over. I’d say even to prefer it over the 3rd-Party Newsgroup for help, advice and knowledge. Bruce visits often, and there are more and more wise heads logging in.

Product Tools

File Manager 3 (http://www.capesoft.com/accessories/fm3sp.htm)[Back To Listing]

This is, without a doubt, the greatest 3rd-Party Template in existence for Clarion. And I’d suit it up against the development world at large too.

File Manager 3 is a Template from Capesoft. You buy it and you install it.

What it does is give you the freedom to change your File Structures with wild abandon, and not have to worry about writing your own conversion functionality.

Plug it in. Increment the Version. Compile. Nothing Simpler.

Clarion Desktop (http://www.clariondesktop.com)[Back To Listing]

I’ve gushed about Clarion Desktop before (here). You cannot put a price on making the 3rd Party product upgrade process easy. But I will. $3 a month. That’s right! Gary charges you 3 big boys a month, and what you get in return will save so much time.

Let’s be clear on the reason for Clarion Desktop making this list.

I don’t have to manually upgrade my 3rd Party products. Clarion Desktop knows when there is a new version and will download and (in most of mine) run the Installer. Clarion Desktop (the Professional edition) keeps my passwords, and for the Capesoft products (and some others) that really takes a painful equation out of the way.

There are some issues. Sometimes a product’s "version" will be stuck until you do a manual upgrade. I believe this is due to a problem with how Clarion Desktop reads the 3rd Party RSS feed. But I could be wrong.

For me, taking away the pain of manual 3rd Party product upgrades justifies Clarion Desktop’s place on this list.

NetTalk (http://www.capesoft.com/accessories/netsp.htm)[Back To Listing]

I use NetTalk all the time. These days it’s usually the Web Server in conjunction with Emailing and some other facets. But whether you want to build a standalone Web Server with Browse/Form (and a lot more) Template functionality hitting your DB directly .. or whether you are looking to write and E-Mail client, NetTalk is the Template for you.

Particularly, the Web Server is just awesome. You don’t need to worry about IIS. You don’t need to worry about Apache. All you need (this should be a song) is NetTalk.

PDF-Tools (http://www.docu-track.com/home/dev_tools/clarion/)[Back To Listing]

Reporting to PDF is vital in our world today. Face it, without PDFs you cannot expect to compete.

PDF-Tools is a complete package. You plug in the Template and compile. The more you delve into the options (which work by default just fine), the more you understand the power PDF-Tools gives you.

Setup Builder (http://www.lindersoft.com/products_setupbuilder_dev.htm)[Back To Listing]

Putting together an Installation can be tedious and frustrating. Setup Builder is none of those two, and all of awesome.

Learning the ropes on a new product can be daunting, but take the time with Setup Builder and you will be rewarded in full. Once the fog has lifted (I had a few days of heavy fog, the old brain couldn’t work it out right away) you will be hit with just how much control Setup Builder gives in the creation of Installation (and Upgrade, and more) files.

More than just being a great product, the support that Friedrich brings to the product is first-class. Absolutely.

Dr. Explain (http://www.drexplain.com/)[Back To Listing]

A couple of years back, I saw a post on the newsgroups about a piece of Help Authoring software. The word "free" and "blog" jumped at me with feverish excitement, so I downloaded Dr. Explain, wrote a review, and received my copy.

The latest version of Dr. Explain has kicked it up ten notches to take on the big fellows. Basically, you can write your Help files with wild abandon now, not only having something which outputs like Help & Manual, but pulls in SnagIt-like functionality for good measure.

Seriously, this is what Help Authoring software should be. And is with Dr. Explain.

Notepad++ (http://notepad-plus.sourceforge.net/uk/site.htm)[Back To Listing]

A Text Editor is a powerful development tool. You should not get by without one.

Notepad++ trumps the previous place-holder here, Ultraedit, for me. It’s Lightweight. It does what I needed Ultraedit to do. It’s free. And, it’s light. Weight.

The Text Editor is like the proton energy pill. Or something.

Notes:

"Documents and SettingsApplication DataNotepad++userDefineLang.xml""Program FilesNotepad++pluginsAPIs*.api"

Honorable Mention Tools (One’s I Don’t Use But Probably Should)

Clarion Handy Tools (http://www.cwhandy.com/)[Back To Listing]

I didn’t know much about CHT until I started really getting into NetTalk. Now whenever I’m gushing about NetTalk, one of the little men in the back room of my brain is thinking about CHT and humming away to ACDC: "C. H. T. .. It’s Dynamite!"

This is one particular product that I really want to, and will, try out in the near future. If you ask around, on the newsgroups or Skype or elsewhere, CHT will be on the praise list.

What does it give you? From what I can tell .. Everything. And that’s just fine.

Clarion Connection (http://www.outsidetrains.com/cc/)[Back To Listing]

Tom’s site is fantastic. It’s two lists. One being the recent "Clarion Stuff", the other being ALL the "Clarion Stuff". If you like your information methodical and vertical, hit up Clarion Connection.

I need to visit here more often.

What’s Doing

Okay. I’m very trashed. Going to just list a random order of things happening lately.

– played a bit of WoW again, finally. Missed the crack-e-ness.

– played a very tiny bit of the Witcher with the new patch that lessens load times. Made it much more enjoyable. Will have to continue with that.

– movement on the Tech Evangelist role for SV (Clarion).

– decided on a revamp for Pimp My Clarion, as of now going to create it in NetTalk, host it myself.

– got the web server and basic web system functionality into the Freight system.

– almost got the Tafres (Freight System) web site finished and ready to launch. Just need to fill in some of the content.

– working on a new patch for Jaymoe. Still trying to do too much though. Changing the UI. It’s not going to happen easily or quickly. Going to have to work out which way to go.

– a new beta of Dr. Explain came out. Looking forward to getting stuck into the added features.

– actual work is getting pretty convoluted. I took some initiative and started assuming the role of Team Leader for my project. Noone has corrected my assumption yet, although had to deal with some wierdness.

– read some interesting stuff about Ruby on Rails .. 1. here and 2. here. Well, the second link has a more global topic. Warning .. Extreme Language, specially in the Zed rant. But very interesting. It sounds like a complicated mess, with massive egos and guys who don’t know much about programming, and guys who do, all fighting together over important and not-so-important stuff. Which is of course a global and lame statement. Ha ha. If you want to find out about what’s going on in the Rails community .. read Zed’s rant.

– Sword of Shadows (JVJ’s site) came out! Read it asap and loved it. This series is one of my all time favourites. Got one of the most awesome fantasy quotes ever. "Kill an army for me Raif Sevrance. Any less and I might just call you back."

– almost finished watching Heroes Series 1 through again. Just finished "Five Years Gone" last night while exercising.

– Exercising like a maniac on the bike we got as a combined christmas pressie. 30 mins to 1 hour a night, 5-7 nights a week. It’s crazy. But awesome because you can do it in front of the telly. Ahhhh. However, really cuts into .. well .. time.

That’s enough for now. Regular updates will hopefully be more .. regular.

Examining The Doctor

Dr. Explain is, without question, an awesome piece of software.

drexplain_review_001

Let me explain. No, there is too much. Let me sum up.

The guys behind Dr. Explain have created a simple and powerful problem solver. The problem, of course, is how to quickly create Help Documentation. Their solution is the best I’ve seen.

drexplain_review_002

For what it does.

Dr. Explain doesn’t have a whole bunch of large pieces of functionality. It is a streamlined app. The buttons are placed well, shortcut keys appropriately set. The interface is clean and easy to use.

drexplain_review_005

Basically, you need to come at Dr. Explain with a planned document structure. If you have the words/structure in your mind, you’ll be firing up Help Documentation in no time at all.

And I mean no time. I started using Dr. Explain with only a brief thunk about what I wanted .. mostly it was just to experiment, and I was able to put together stuff very quickly.

drexplain_review_008

So there is a minimal feature set, but that feature set is very rich.

The layout of the pages created is quite well structured. You can alter what appears on the pages by tampering with the CSS Interface (Dr. Explain’s Interface into the CSS), or get stuck into the CSS itself (limited text editor).

drexplain_review_010

I haven’t mentioned probably the biggest selling point of Dr. Explain yet.

drexplain_review_004

It’s got something like SnagIt, only far more focussed (see below capture).

drexplain_review_003

You drag the anchor onto the page you want, and it goes to work. Dr. Explain creates a "Chart", which is the window captured, along with a bunch of bullets attached to each of the controls on said window. It’s pretty cool stuff. Obviously, sometimes you don’t want all the controls, but that’s not really an issue. Just get rid of them.

drexplain_review_012

The end result of this is a page which has the window at the top, the bullets linking to their own Descriptions further down the page. It’s a perfect way to bring the functionality of the system to life within Help Documentation. The user can click on the button to get to the Help for it.

drexplain_review_013

You have a huge set of options, Global Options, Project Options, Chart (the window) Options.

drexplain_review_006

You can mess with the HTML templates of the pages created.

drexplain_review_009

You can set Global Options and then pull them down into individual Chart pages.

drexplain_review_007

Dr. Explain lets you export to either HTML, CHM, or RTF file formats (yeah, I know, HTML isn’t really a file format).

It’s awesome. Awesome to the Max.

Dr. Explain, as a tool, is second-to-none in what it does.

Here’s my summary of my Sum Up Review of Dr. Explain,\r\n

  • Extremely easy to get from thoughts to actual Help Documentation
  • Awesome to the Max Window Capture functionality
  • Clean, simple layout
  • Massive amount of Options, ability to change almost anything

What struck me as missing (these things might actually be in Dr. Explain somewhere, but I haven’t found them yet),\r\n

  • Add Images to Topic Pages
  • Add custom text in any place on the "Window" page, the one with the window capture
  • Option to edit anything about the CSS, even if it’s screwing with the functionality
      I understand this isn’t actually good for the software, and is bad design (my idea). It’s a good thing that you can’t screw with the CSS Templates, but it was just something that passed across my mind while fiddling. The reality is, you can just open up the CSS file yourself and get to work. So basically, this isn’t really a problem
  • (This is very picky) More options for the bullets (shapes, lines, colors, ..)

In the end, for the small amount of mulah the makers are asking for, Dr. Explain is an awesome (there’s that word again) tool to have in your arsenal. There’s nothing else that gets you directed (by that I mean the window with the controls all bulleted, descriptions easily entered) documentation as quick, lean and simple as this baby does.

So go get it, try it out. You’ll see what I mean.