fagan2888/developerportal

Welcome to the Trade Developer Portal. Through this site, the Federal government gives software developers access to authoritative information on U.S. exports and international trade via standard APIs. The data accessible here is targeted at helping U.S. small businesses export and expand their operations in overseas markets.

The ITA Developer Portal is changing. Learn more about how this change affects you.

https://internationaltradeadministration.github.io/DevPortalMessages/DevPortalUpgrade.html

International Trade Administration - Developer Portal

View the site here: http://developer.trade.gov

This project includes the source code and content for the ITA Developer website.

The goal of the project to expose ITA data sources to the public under a common taxonomy which allows for the the general public to more easily consume both trade and export information.

Local Installation Requirements

• Linux, Unix, Windows or Mac OS X
• Ruby
• RubyGems
• Jekyll

Ruby

To install ruby on unix:

yum install ruby (or sudo apt-get install ruby1.9.1)

To install ruby on Mac OS X:

curl -L https://get.rvm.io | bash -s stable --ruby

Visit the following links for more detailed information on how to set up Ruby using a method applicable to your environment:

Three Ways of Installing Ruby (Linux/Unix) http://www.ruby-lang.org/en/downloads/

RubyInstaller for Windows http://rubyinstaller.org/

How to Install Ruby on a Mac http://net.tutsplus.com/tutorials/ruby/how-to-install-ruby-on-a-mac/

Install rubygems:

• cd ~/
• wget http://production.cf.rubygems.org/rubygems/rubygems-1.8.24.tgz
• tar xzvf rubygems-1.8.24.tgz
• cd rubygems-1.8.24
• ruby setup.rb

Managing Dependencies Using Bundler

We recommend using Bundler to manage dependencies. Once you have Ruby installed, install Bundler by running the following command: 'gem install bundler'

Once Bundler is installed, you install/update dependencies by simply running 'bundle install' within your project folder.

More information on Bundler may be found here: http://gembundler.com/

Install Jekyll

• cd WebSite (or the location of your cloned repository)
• bundle install

For more information and detailed documentation on Jekyll, visit the following sites:

Jekyll Project Home http://jekyllrb.com

Jekyll on GitHub https://github.com/mojombo/jekyll

Clone the repository

• cd /var/www/html (or the location you would like the compiled site to live)
• git clone https://github.com/InternationalTradeAdministration/WebSite.git

Generate the site and serve

• bundle exec jekyll serve --baseurl '' (or whatever base url you will be using, e.g. '/DeveloperPortal')
• Browse to localhost:4000 to view the site