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