DESCRIPTION

The Tribune theme is fresh, fully responsive, highly adaptible Superdesk Publisher theme built primarily to serve those media operations with high daily news production. It offers editors flexibility in ways they can present sets of news (category or tag based; manually curated, fully- or semi-automated content lists; and more).

The Tribune also features several customizable menu, html and content list widgets which enable live-site editing from frontend.

In this theme we also showcase how 3rd-party services can be incorporated for reacher user experience (Open weather data integration for any wetaher station in the world, Disqus article comments, Playbuzz voting poll, Google Custom Search Engine).

SETTING UP DEVELOPMENT ENVIRONMENT

For information and explanation on theme structure, please see http://superdesk-web-publisher.readthedocs.io/en/latest/themes.html

This Superdesk Publisher theme uses Gulp workflow automation (http://gulpjs.com/).

To correclty set-up working environment for theme development, you can follow these steps:

• Fork and clone, or just download the theme from GitHub (https://github.com/SuperdeskWebPublisher/theme-tribune)
• Make sure Gulp is working on your system (how to get it up and running see here: https://github.com/gulpjs/gulp/blob/master/docs/getting-started.md)
• Gulp file is already there in theme. It has all necessary methods already implemented. For development purposes, you can simply fire the task 'watch' and it will automatically a) compile and add all css/scss/sass changes from public/css/ to public/dist/style.css b) add all js changes from public/js/ to public/dist/all.js file
• For applying changes for production, there is the task 'build' which will also minify css and js and add specific version to these files (to prevent browser caching issues)
• You can also manually run tasks sass, js, cssmin, jsmin, version, as well as sw (service worker steps that ensure propper pre-caching on browser side)

ADJUSTING AND CUSTOMIZING THEME

The Tribune theme comes with predefined functionality which includes:

• front page with manually created content list on top of the page and per-category listings under it (these per-category listings and built in several different ways to offer wider base for customization)
• category pages with pagination. Initial category page features one top article.
• Both category listing widgets on front page and category landing page can benefit if content list with category name is created - then manualy picked articles will be shown in category widget and on top of landing page (the rest is filled with chronologically ordered articles excluding ones already shown via content list).
• article page with featured image on top, article content and article gallery under it (image thumbs that open full version in a fancybox)
• theme also comes with RSS template, static page, search results page and listing of trending articles based on the three most used keywords in articles inside the Top articles content list used on front page.
• Theme has built-in support for Google AMP (accelerated mobile pages). These templates are in subfolder /amp. More information on Google AMP project is here: https://www.ampproject.org/

The Tribune theme has several customizable properties that can be changed in Publisher's Site Manager:

• sidebar element that shows featured author can be turned on or off (for this, Superdesk's author profile should have 'featured author' article role created)
• breaking news widget on top of front page: if turned on, full-width, graphically ritch element will show first article from the Top news content list in this special layout
• primary color will change theme color to custom value

For theme templates customization please refer to Superdesk Publisher documentation, starting here: http://superdesk-web-publisher.readthedocs.io/en/latest/templates_system/index.html