Skip to content
This repository has been archived by the owner on Jul 21, 2019. It is now read-only.

devopsdays/devopsdays-theme

Repository files navigation

⛔️DEPRECATED All work on this theme should take place in devopsdays/devopsdays-web

devopsdays-theme

devopsdays-theme is the Hugo theme for the devopsdays website.

QA Testing the New Theme

While we are in development, your help is appreciated in identifying outstanding issues or defects. Please browse through the example site at https://dev.devopsdays.org, and if you idenfity something that is broken or missing, please log an issue. We may mark it as a duplicate, etc, but log anything you find that seems wrong or broken.

Theme Layout

Bear in mind that this theme lives in a separate repo from the main devopsdays-web repo. No changes should be made to the themes/devopsdays-theme directory in devopsdays-web. If changes need to be made to the theme, they should be made in this repo, and a new version released, and the theme installed into devopsdays-web.

All features are documented in REFERENCE.md.

New Features

Frontpage Logo

On the new homepage, upcoming events are listed with a square thumbnail. The image must be square and named logo-square.jpg in the static/events/YYYY-CITY/ directory. If this file does not exist, then the default logo is displayed instead.

Event Menu Icons

When on a smaller screen, the event menu collapses to icons. These icons are named from ones available at Font Awesome and custom ones can be added as optional parameters to the list of event nav elements for the event in its data file. The common menu items have default icons for each type.

Example:

nav_elements:
  - name: program
  - name: speakers
  - name: registration
  - name: sponsor
  - name: stuff
    icon: "smile-o"
  - name: location
  - name: contact
  - name: conduct

Improved Organizer List Page

New elements are available via the list_organizers shortcode. These include a bio, a photo, and Facebook, Linkedin, GitHub, and website links (in addition to the existing Twitter links). Example usage:

team_members:
 - name: "George Michael Bluth"
   employer: "Fakeblock"
   website: "http://www.fakebook.com"
   image: "george-michael-bluth.jpg"
   github: "fakeblock"
   twitter: "thegeorgemichaelbluth"
   bio: "At high school, George Michael is hardly known by any other students but gets good grades. He is paid to tutor Maeby, but instead, she plagiarizes from him. He briefly develops a crush on his teacher Beth Baerly because she paid attention to him. (\"Shock and Aww\") He lost the student council election, receiving only 3% of the votes. (\"The Immaculate Election\")<p>
   George Michael's good grades continue through college. To get into Julliard, George Michael develops a fake woodblock app with his roommate P-Hound called [Fakeblock](http://arresteddevelopment.wikia.com/wiki/Fakeblock). One small lie causes the app to get blown out of proportion by Maeby who thinks it is privacy software."

Please note that quotation marks in the bio need to be escaped. The image is relative to the static/events/YYYY-CITY/organizers/ directory, and must be in jpg format.

Program Page

A new template has been created to generate a program page. An example can be seen at https://dev.devopsdays.org/events/2017-ponyville/program

This is an opt-in feature; the page will need to be set for the type of program in order to generate it.

Social Sharing Images

An event can create a sharing image for use on social media (when the url is shared on Facebook, for instance). This image must be named sharing.jpg and located in the static/events/YYYY-CITY/ directory. It should be a minimum 1200 x 630px, and use ratio: 1.91:1.

Blog

Blog posts now support setting an "author" name in the frontmatter; for example, like this:

+++
Title = "Minneapolis 2016 in review"
Date = "2016-08-08T15:59:27-05:00"
Tags = ["2016"]
Author = "Bridget Kromhout"
+++

If an author is not specified, attempts to display it are ignored.

Feature Requests

If there is a feature in the theme that you would like to see, please submit an issue to this repository and prepend the title with [ENHANCEMENT]. If you discover an issue with the theme, submit an issue and prepend the title with [BUG].

If you would like to help prioritize enhancements, please upvote the original issue by adding a reaction.

Contributing

See CONTRIBUTING.md for details on our workflow, dev setup, and how to release new versions of the theme.

dev examples

This is just a list of some POC urls to see examples: