This is a resource for IS445 as of Fall 2022. It is a way to host an online CV with interactive visualizations. See the course page for more materials.
- clone this repo or download the contents
- make sure you have Ruby properly installed (see the course's install instructions for this process)
- Install using
bundle install
(see the course's install instructions) - Host locally with
bundle exec jekyll serve
orbundle exec jekyll serve -l
(live reload) - Modify files as needed (see sections below)
Edit info in: _config.yml
Some things you should be sure to check
- The "how to use this document" info at the top
- title, description, repository -- basic title and linking info
- baseurl -- in case you want to have it be a sub-page of your main github.io page
- exclude -- this section at the end of the config file, add at will in case you have other things stored in your github.io repo
Edit info in:
- pages/about.md for your general introduction
- _data/programming-skills.yml to update your your programming skills list
- _data/other-skills.yml to update other skills
- timeline.yml to update the timeline of your CV
Add project files in:
_projects
to add page filespages/projects.html
underremote_projects
for links to your github projects. Note: this will ONLY link to your repos and you must specify the end of your repo URL (see example)
You can link both project pages and github repositories. Github repos will autopopulate, pages allow you to provide more details.
By default, the project pages go first, but you can modify this if you want any github repos to show up first.
Project pages can be added by adding markdown files in the _projects
folder.
Project layouts can be modified in _includes/projects
.
See _example_projects
folder for more examples from portfolYOU.
Generally, you will be linking notebooks that exist in other repositories that are doing analysis. However for any "loose" notebooks, you can store them in the python_notebooks
folder. In theory you can do fancy local linking with it, but it hasn't been implemented yet.
By default these are saved in assets/json/
and static images are saved in assets/pngs/
. See the example
All blog posts will be posted by most recent time stamp -- please see the example for a properly formatted file name.
Add blog posts in:
_posts
(see example)
You can see further examples in the _example_posts
directory.
This is an amalgamation of portfolYOU and 4dcu.be.
portfolYOU was used for:
- overall style, taking off a few elements -- Blog, About, Projects all are included here
- also progress bars for skills are modified to contain words, not percentages
- vega-lite additions -- found in the
_plugins
folder and the vega-added things inassets/js
- Start by searching for Jeykll themes: https://github.com/topics/jekyll-theme
- pick the following: https://github.com/YoussefRaafatNasry/portfolYOU
- clone and follow the "Installation" instructions here: https://youssefraafatnasry.github.io/portfolYOU/docs/
- Added port
- remove Gemfile.lock if needed trying to install with: bundle install --path ~/.gem
bundle install
in directory
bundle exec jekyll serve --> without the l for live reload if something else is running?
NOTE!!! it is quite likely that you have to serve the site locally and/or delete _site before pushing for your changes to go live. I AM NOT SURE. Have to re-start after you do a change to the config.yml file