Visually speaking, the WSU Spine is a 198px wide column that binds together the many websites of wsu.edu. As a framework, the WSU Spine is a minimal template that provides a responsive and flexible grid for every WSU website. With a uniform and global column on the left and a blank, unwritten page to the right, the Spine upholds the unity and diversity of our university.
- Consistently brands the university across websites and platforms
- Provides a usable and consistent navigation solution
- Provides a responsive solution for devices
A typical implementation of the WSU Spine would start with markup from the
spine.html file in this repository.
- Customize the
#spineelement by replacing default data with appropriate contact details.
- Customize the markup in
spine.htmlby adding any out-of-the-box modifications, such as changing the color of the spine. Customization options can be found in the comments of
spine.htmland, for some lesser used options, at brand.wsu.edu.
- Rebuild the markup in your CMS of choice while taking care to preserve its elements and structure.
More information is available in this repository's Wiki.
WSU Spine Repository
The Spine framework is made available as part of a central repository at WSU.
Using this repository as an external library in your CMS or the web pages you create will help to ensure you receive the benefits of automatic updates as they are pushed. Visitors to your web pages will also benefit from faster page loads as the Spine files will likely be cached in their browser from other university properties.
Using the current major version build will ensure that you will receive all non-breaking updates automatically. This is the recommended method.
As versions change between
2.1.0, the files at the above URLs will be automatically built and cached in users' browsers for an hour. A version change to
3.0.0 will result in a new URL and will be communicated at the time.
Specific version builds are also available for every minor version.
These have the benefit of being cached in browser for 120 days, though will require attention whenever the Spine is updated.
When following along with development, the following can be used:
These are cached in the browser for only 10 minutes and can be considered bleeding edge. This is the first place to test fixed bugs, but may also be considered unstable from time to time.
Releasing a new version
git checkout master- Check out the master branch locally.
git checkout -b release-2.0.2- Check out a release branch based on
git merge develop- Merge the
developbranch into the release branch.
- Resolve any conflicts during the merge process.
styles/sass/vars/_global.scssto reference the correct version number. These both use
developbranch and the full, latest version number in the
- Update the
CHANGELOG.mdfile with the upcoming version number, date, and description of changes.
package.jsonversion number to the upcoming version number.
npm installto automatically update
package-lock.jsonwith the new version number.
- Commit version number changes to the release branch.
git checkout master- Check out the master branch.
git merge release-2.0.2- Merge the release branch into the master branch.
git push origin master- Push the master branch to GitHub.
git checkout develop- Check out the develop branch.
git merge release-2.0.2- Merge the release branch into the develop branch.
styles/sass/vars/_global.scssto reference the
- Commit version changes to the develop branch.
git push origin develop- Push the develop branch to GitHub.
- Use the GitHub release interface to tag a new version number based on the latest position of the
develop branches should now be different by only one commit, the one used to update the
develop branch for development again. Use
git fetch --all to retrieve new tags locally so that you can deploy as needed.
Deployment at WSU
Makefile is included with the repository to aid in the deployment of the WSU Spine to the server hosting repo.wsu.edu.
For deployment to work, you must be authorized on the wsuwp-indie-p2n01.web.wsu.edu server. This likely means that you are a member of the web team at WSU and have the appropriate network access required.
From a command line within the Spine directory on your local machine:
make deploy version=developdeploys your current branch to the develop directory.
make deploy version=2.0.2should be used after tagging a release and deploys the current working directory to three different branch directories.
If a version number that is not
develop or a semver type number is passed, the deployment will fail with an error message.