GitHub Portfolio

Generate a portfolio for your GitHub repository.

See the wiki for an overview of the implementation.

Selecting Repositories to Showcase

github-portfolio will only show projects that you have self-starred.

Starring a repository that you can push to will display it as a primary repository.
Starring a your fork of another repostiory will show the parent repository as a project that you have contributed to.

Viewing Your Portfolio

Visit / to view your portfolo
Visit //reload to reload your portfolo

Installation

This is a standard Rails 4 application.

After bundler installs gems, these initial setup steps will get the app running:

Create a personal access token with the public_repo permission at https://github.com/settings/tokens.
Create config/secrets.yml from config/secrets.yml.example, and insert your GitHub access token.
Migrate the database
```
rake db:migrate
```
Install memcached. To use memcached in development/test environments, set environment variable
```
MEMCACHED_IN_DEVELOPMENT=true
```
Run the rails server
```
rails server
```
(Optional) For fast page loads, configure your web server to use the page caches that the app generates in public/page_cache/.

Customizing

To configure the root route / to display a particular portfolio, set the environment variable:

PORTFOLIO=your-github-login
Modify the hue value in secrets.yml to a color of your choice. You can also use the URL parameter ?hue=123 to experiment with hue colors. Restart the rails server if it is running.

Use the rails console to customize the header text:

Header.find_or_create_by(github_username: 'your-github-login') do |header|
  header.title = 'Large Heading Text',
  header.tagline = 'Tagline text',
  header.intro = "Some text.\nFeel free to use more lines."
end

License

You may use this code for free, but you are required to offer the source code for your version to your users. See LICENSE for details.