Skip to content

PGBT is an Orchard theme that aims to provide a set of common markup and styling so other themes can easily inherit from it.

License

Notifications You must be signed in to change notification settings

Lombiq/Pretty-Good-Base-Theme

Repository files navigation

Pretty Good Base Theme Orchard Theme

About

PGBT is an Orchard theme that aims to provide a set of common markup and styling so other themes can easily inherit from it.

Almost everything is taken from the core and The Theme Machine shape templates and stylesheets (credit goes to the Orchard Team!), refactored, reorganized and enhanced.

Documentation

What's the Great Purpose?

This theme wants to help theme developers by giving them a set of cleanly structured, easily reusable and extensible set of templates and stylesheets. You shouldn't use this theme on its own (although since it contains the styling and markup of TheThemeMachine, it gives a solid basic style), but inherit from it when you write your own theme (mark it as BaseTheme in the Theme.txt). In addition to this PGBT does the following:

  • Correctly sets the site's language in the html tag's lang attribute (see the related issue)
  • Adds a "hidden-text" class (what could this be? :-))
  • Enhances form styling: better usability by outlining the focused input element, default border styles and inputs inherit font properties
  • Makes adding a favicon extremely easy (just drop it in)
  • Added some CSS formatting
  • Reverses the order of title parts (provides <page title> <separator> <site name> instead of the native version where site name is always at the beginning)

Installation and upgrade notes

Notes on installation if Orchard is built from the source

If you want, you can include PGBT in the solution of your Orchard source. Since PGBT is a project itself, do this by adding it as an existing project to the Themes folder, but do not add it to the existing Themes project!

Notes on upgrading from 1.1.x

Since PGBT became a C# project from a simple theme folder, if you added it to the Themes project as a folder before, you should exclude it after upgrading and add it as described above.

Notes on performance

To provide a better structure, PGBT uses plenty of external stylesheets. This can impact the performance (load time) of your page, since the client has to fetch all the stylesheets separately. To overcome this, try the Combinator module which combines all the stylesheets (and javascript files) into one file (with minification).

See the How to...

See the Version history

See Pretty Good Bootstrap Base Theme for a Twitter Bootstrap-based theme serving similarly as a base theme.

You can install the theme from the Orchard Gallery.

Contributing and support

Bug reports, feature requests, comments, questions, code contributions, and love letters are warmly welcome, please do so via GitHub issues and pull requests. Please adhere to our open-source guidelines while doing so.

This project is developed by Lombiq Technologies. Commercial-grade support is available through Lombiq.

About

PGBT is an Orchard theme that aims to provide a set of common markup and styling so other themes can easily inherit from it.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published