http://teethgrinder.co.uk/open-flash-chart/

How does it work?

1. User browses to your web site.
2. The browser downloads the web page which contains the Open Flash Chart.
3. Open Flash Chart downloads the data file and displays the chart.

—————————–

It’s such a wonderful tool.

Perhaps, the user has his own website, say, someone.com. It will be nicer to let the user have a custom domain in your blog application (in this example: blog.someone.com).

After some digging, I found the implementation in Rails is quite simple and straightforward.

Requirements

1. Your application must running on a dedicated IP. Or at least, if running on a virtual hosting without a  dedicated IP, it must be set to the default vhost site, in order to allow all requests from foreign domains be routed to your application.
2. In your blog table add a field to record custom domain set by the user. Something like:
   add_column(:blogs, :custom_domain, :string, :limit=>200)
   And provide an web interface to let the user custom it.

Implementation in Rails

Rails has a built-in URL rewriting module, which redirects incoming requests to controllers and actions. This router makes things a lot easier. But the packaged Routing module only understand request from native domain, and so all we need to do is to extend it to parse requests from foreign domain.

The Routing module provides two extendible methods to define the condition for request parsing. Dan Webb’s Request Routing plugin (alternative link) has already taken care of them and give extra conditions for defining map rules.

So, install the plugin:

ruby script/plugin install http://svn.danwebb.net/external/rails/plugins/request_routing/trunk/

Then create a new map rule in routes.rb

# route all requrest from foriegn domain to boards controller
map.connect(
  ‘:action/:id’,
  :controller => ‘blogs’,
  :conditions => {
     :domain => /\A(?!(yourblogapp\.com))/i
  }
)

This map rule says all requests which are not coming from “yourblogapp.com” will be redirect to the blogs controller.

Then in blogs_controller, you will probably have something like:

def retrieve_blog

   @blog = Blog.find_by_id(params['id'])

   …..

end

Change this retrieving method to:

def retrieve_blog

   @blog = (request.domain != ‘yourblogapp.com’)  ?
         Blog.find_by_id params['id']  :
         Blog.find_by_custom_domian request.host.downcase 

   …..

end

Job done.

What the user needs to do

To custom a domain for his blog, the user need to do following two setup:

1. Create a CNAME record for this domain: blog.someone.com, the destination of which is the domain of your application: yourblogapp.com
2. Log in your application, and add “blog.someone.com” to his preference settings.

Here is what I’ve got for my IDE

Figure above: code editing
 

Figure above: browsing documentation

How to make up this

1. Install Eclox for Eclipse
2. Create a .doxyfile in your opened project (File > New > Other > (Scroll to the bottom of the dialogue) > Other > Doxyfile)
3. Editor the doxyfile, make sure:
1. optimize results for Java
2. then in “Advanced” tab, set “File Patterns” to “*.as”
3. You may need to tweak other settings to make the output document nicer for ActionScript
4. Click the blue “@” button on the top tool bar
   
5. Done

To open the latest generated document, you can do:

1. In eclipse, press Ctrl+Shift+R open “Open Resource” dialogue
2. Enter “index.html”, and (if you got multiple items) pick the one in the documentation output folder
3. After the document is opened, click the “IE Preview” tab at the bottom of editor
   

More flavour for your documentation

A picture paints a thousand words. If you like diagram like me, go to get a free copy of dot generator and set it up in Doxygen like this: