department-of-veterans-affairs/dsva-portfolio

Name: dsva-portfolio

Owner: Department of Veterans Affairs

Description: A portfolio website for the Digital Service at VA team.

Created: 2015-07-15 17:39:22.0

Updated: 2017-08-10 03:56:03.0

Pushed: 2015-09-01 19:44:04.0

Homepage: null

Size: 826

Language: HTML

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

dsva-portfolio

This is a portfolio site for the Digital Service at VA team.

Adding or editing your basic information

If you're new to the team or would like to update your profile information for the site follow these steps:

First create a profile picture and place it in img/team. Make sure to name it logical like harriet_tubman.jpg. Note that your picture should be 350x150 or similary proportioned to render correctly on the site.

Under the team.yml under the _data folder. In this document you'll see a list of team members as an array like so:

ference_name: kavi_harshawat
me: Harriet Tubman
tle: UX Designer and Researcher
cture: http://placehold.it/350x150
itter: htubman
thub: hariettubman

If you see yourself there, feel free to edit your personal information otherwise create a new array with the same formatting at the bottom of the list.

Creating a project page

We can use this portfolio site to list out the project that the DSVA team is working on. If you'd like to create a new project page follow these steps:

Create a new markdown file and save it under the _posts directory with the following filename formatting: YYYY-MM-DD-example-project.md. This formatting of the title is important so make sure it follows the pattern!

Once you've created your markdown file, you need to put in what's called “Frontmatter” surrounded by --- at the top of the page. This Frontmatter contains meta-information about project and how it's webpage should look online. Take a look at the following example:


ut: post
gory: work
alink: example-project

e: Example Project
itle: Appeals Cupcakification
-updated: 6/12/15
ributors: 
vi Harshawat
ff Maher
tthew Weaver
ily Wright-Moore
ex Gaynor

As we mentioned above all the Frontmatter is surrounded by ---. The layout variable is what template the page should follow. In this case we should just use the post template. We set the category to work to make it easy to collect all the projects on the work landing page. The permalink should be set to whatever you want the URL to looklike in browser's address bar (best to keep this simple).

A couple of lines below we have variables that are used in the post itself. The title should be the title of your project. The subtitle variable is used on the work landing page. Use the date-updated variable to make let others know when this project was last updated. Finally, you can list out all the contributors to a project by listing them out like the example above. This will automatically generate a little grid with these people's faces and details at the bottom of the project page (pretty nifty, eh?). If you list someone here, make sure they're also listed in the _data/team.yml file or their information won't show up!

Finally, below the second --- after the frontmatter, write up the description of your project. You can use markdown syntax, and the content will be formatted appropriately on the site.

{{ site.url }} is a variable for the base-website URL. It's important because it tells the browser where to look for the image. If you'd like to add an image to your description, use the normal markdown syntax ![Cupcakes!]({{ site.url }}/img/cupcakes.jpg) (make sure to include your image in the img/!).


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.