Getting Started Guide
Looking to create a CleanSlate theme? The "Getting Started Guide" is a great way to learn the process of creating a theme. Follow the steps below to get up and running quickly. It is required that all newly developed themes follow the web standards and guidelines for creating your site.
Make a Request
Step 1: Fill out the " Theme Developer - CleanSlate Request Form"to request a:
- new user account for CleanSlate and Bitbucket
- new site in CleanSlate
- new theme repository in Bitbucket
Wait for a response from University Relations - Web. Generally we will respond
to your request within 1-2 days with a notification that your
request has been completed.
Step 3: Log in with your WVU Login credentials to check your request. Once you receive your notification from University Relations - Web, you need to double check CleanSlate and Bitbucket to make sure it has been properly setup.
RequirementsStep 1: Use Git. CleanSlate uses Git to version control our themes. If you're not familiar with Git, visit:
Clone the theme repository in the ~/Sites/cleanslate_themes directory on your
local computer. You may need to make a Sites folder and a cleanslate_themes folder
as well. If you need a refresher on how to use Git, refer to the Requirements
Step 2: If you are using a Mac you will need to adjust your computer settings to view the hidden files in your theme. Visit this site to learn how to view hidden files on your Mac.
Create Your Theme
Step 2: Structure your site the right way. Every site in CleanSlate needs to have the correct site structure. Without the correct structure, your theme will not work in CleanSlate. Visit Theme Creation Rules to learn more about the setting up a new CleanSlate theme. You should also check out the CleanSlate Toolkit boilerplate for a working example of a theme's structure.
Step 3: Make your template D.R.Y. Learn how to use
layouts and the r:yield tag to make your template more flexible.
Add Your Theme to CleanSlate
Step 1: Git add, commit, push and then sync. To
make your changes live you will need to push your local theme changes
using Git and then sync your theme in CleanSlate.
Step 2: Start adding content to your site. Visit the content publishing section of this site to learn more about managing your content.
Launching the Site
Step 1: You must submit your designs via ConceptBoard. Give us at least 5 business days to review your design upon submitting your original concept. You can submit images or a link to a *.sandbox site. We will provide feedback in the board comments and give you the go-ahead to build the site (if you haven't already done so). Once you think you are ready to go live, submit the website for formal approval. You must submit your final *.sandbox.wvu.edu URL at least one week prior to your intended launch date. Please include Adam Glenn, Adam Johnson, and Mike Esposito on the approval request, and ONLY these approvers. Mike and Adam G. will sign off on your design and AJ will sign off on accessibility.
Step 2: Fill out the Website Host Name Request Form. Before you launch your site you will need to put in a request for your host name. Fill out the form to request a:
- new host name
- replace a current host name
- DNS change
Last updated on May 23, 2019.
We welcome all questions, feedback and bug reports. If you're having an issue, we usually need the following information:
- A brief description of the issue
- A link to the page where you saw the issue
- Screenshots that illustrate the problem - How do I take a screenshot?