📦 Initial commit of new "Themer" plugin

.gitattributes

@@ -0,0 +1,17 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Custom for Visual Studio
+*.cs     diff=csharp
+
+# Standard to msysgit
+*.doc	 diff=astextplain
+*.DOC	 diff=astextplain
+*.docx diff=astextplain
+*.DOCX diff=astextplain
+*.dot  diff=astextplain
+*.DOT  diff=astextplain
+*.pdf  diff=astextplain
+*.PDF	 diff=astextplain
+*.rtf	 diff=astextplain
+*.RTF	 diff=astextplain

.gitignore

@@ -0,0 +1,2 @@
+assets/logo.svg
+*.xcf

CHANGELOG.md

@@ -0,0 +1,5 @@
+# v1.0.0
+## 08/20/2015
+
+1. [](#new)
+  * ChangeLog started...

README.md

@@ -0,0 +1,108 @@
+# [![Grav Themer Plugin](assets/logo.png)][project]
+
+[![Release](https://img.shields.io/github/release/sommerregen/grav-plugin-themer.svg)][project] [![Issues](https://img.shields.io/github/issues/sommerregen/grav-plugin-themer.svg)][issues] [![Dual license](https://img.shields.io/badge/dual%20license-MIT%2FGPL-blue.svg)](LICENSE "License") <span style="float:right;">[![Flattr](https://api.flattr.com/button/flattr-badge-large.png)][flattr] [![PayPal](https://www.paypal.com/en_US/i/btn/btn_donate_SM.gif)][paypal]</span>
+
+> This plugin enables you use different themes on one site individual set per page or collection.
+
+##### Table of Contents:
+
+* [About](#about)
+* [Installation and Updates](#installation-and-updates)
+* [Usage](#usage)
+* [Contributing](#contributing)
+* [Licencse](#license)
+
+## About
+
+With `Themer` you will get the freedom to change the theme by setting the `theme` variable in the header of a page or collection:
+
+```yaml
+theme: my-theme
+```
+
+Theme variables are being inherited from parent pages. Thus without any doing, pages from collections are automatically styled with the same theme. Further you have the possibility to reset the theme to the default value (defined in the `system.yaml` configuration) by finally using the command
+
+```yaml
+theme: @default
+```
+
+![Screenshot Themer Plugin](assets/screenshot.png "Themer Preview")
+
+## Installation and Updates
+
+Installing or updating the `Themer` plugin can be done in one of two ways. Using the GPM (Grav Package Manager) installation update method or (i.e. `bin/gpm install themer`) manual install by downloading [this plugin](https://github.com/sommerregen/grav-plugin-themer) and extracting all plugin files to
+
+    user/plugins/themer
+
+For more informations, please check the [Installation and update guide](docs/INSTALL.md).
+
+## Usage
+
+The `Themer` plugin comes with some sensible default configuration, that are pretty self explanatory:
+
+### Config Defaults
+
+```yaml
+# Global plugin configurations
+
+enabled: true               # Set to false to disable this plugin completely
+```
+
+If you need to change any value, then the best process is to copy the [themer.yaml](themer.yaml) file into your `users/config/plugins/` folder (create it if it doesn't exist), and then modify there. This will override the default settings.
+
+If you want to alter the settings for one or a few pages only, you can do so by adding page specific configurations into your page headers, e.g.
+
+```yaml
+themer: false
+```
+
+to disable the `Themer` plugin just for this page,
+
+```yaml
+theme: my-theme
+```
+
+to assign an individual theme to the page or collection or
+
+```yaml
+theme: @default
+```
+
+to reset the theme variable and fall back to the default theme defined in the `system.yaml` configuration.
+
+## Contributing
+
+You can contribute at any time! Before opening any issue, please search for existing issues and review the [guidelines for contributing](docs/CONTRIBUTING.md).
+
+After that please note:
+
+* If you find a bug, would like to make a feature request or suggest an improvement, [please open a new issue][issues]. If you have any interesting ideas for additions to the syntax please do suggest them as well!
+* Feature requests are more likely to get attention if you include a clearly described use case.
+* If you wish to submit a pull request, please make again sure that your request match the [guidelines for contributing](docs/CONTRIBUTING.md) and that you keep track of adding unit tests for any new or changed functionality.
+
+### Support and donations
+
+If you like my project, feel free to support me via [![Flattr](https://api.flattr.com/button/flattr-badge-large.png)][flattr] or by sending me some bitcoins to [**1HQdy5aBzNKNvqspiLvcmzigCq7doGfLM4**][bitcoin].
+
+Thanks!
+
+## License
+
+Copyright (c) 2015 [Benjamin Regler][github]. See also the list of [contributors] who participated in this project.
+
+[Dual-licensed](LICENSE) for use under the terms of the [MIT][mit-license] or [GPLv3][gpl-license] licenses.
+
+![GNU license - Some rights reserved][gnu]
+
+[github]: https://github.com/sommerregen/ "GitHub account from Benjamin Regler"
+[gpl-license]: http://opensource.org/licenses/GPL-3.0 "GPLv3 license"
+[mit-license]: http://www.opensource.org/licenses/mit-license.php "MIT license"
+
+[flattr]: https://flattr.com/submit/auto?user_id=Sommerregen&url=https://github.com/sommerregen/grav-plugin-themer "Flatter my GitHub project"
+[paypal]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SYFNP82USG3RN "Donate for my GitHub project using PayPal"
+[bitcoin]: bitcoin:1HQdy5aBzNKNvqspiLvcmzigCq7doGfLM4?label=GitHub%20project "Donate for my GitHub project using BitCoin"
+[gnu]: https://upload.wikimedia.org/wikipedia/commons/thumb/3/33/License_icon-gpl-88x31.svg/88px-License_icon-gpl-88x31.svg.png "GNU license - Some rights reserved"
+
+[project]: https://github.com/sommerregen/grav-plugin-themer
+[issues]: https://github.com/sommerregen/grav-plugin-themer/issues "GitHub Issues for Grav Themer Plugin"
+[contributors]: https://github.com/sommerregen/grav-plugin-themer/graphs/contributors "List of contributors of the project"

blueprints.yaml

@@ -0,0 +1,32 @@
+name: Themer
+version: 1.0.0
+description: "This plugin enables you to use different themes on one site individual set per page or collection."
+icon: magic
+author:
+  name: Sommerregen
+  email: [email protected]
+homepage: https://github.com/sommerregen/grav-plugin-themer
+keywords: [themer, theme, plugin]
+docs: https://github.com/sommerregen/grav-plugin-themer/blob/master/README.md
+bugs: https://github.com/sommerregen/grav-plugin-themer/issues
+license: MIT/GPL
+
+form:
+  validation: strict
+  fields:
+    global:
+      type: section
+      title: "Global plugin configurations"
+      underline: 1
+
+      fields:
+        enabled:
+          type: toggle
+          label: "Plugin Status"
+          highlight: 1
+          default: 0
+          options:
+            1: Enabled
+            0: Disabled
+          validate:
+            type: bool

docs/CONTRIBUTING.md

@@ -0,0 +1,125 @@
+# Contributing to Grav Themer plugin
+
+Please take a moment to review this document in order to make the contribution process easy and effective for everyone involved.
+
+Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open source project. In return, they should reciprocate that respect in addressing your issue or assessing patches and features.
+
+## Using the issue tracker
+
+The issue tracker is the preferred channel for [bug reports](#bugs), [features requests](#features) and [submitting pull requests](#pull-requests), but please respect the following restrictions:
+
+* Please format your issue using [GitHub's markdown syntax and features][markdown].
+
+* Please **do not** use the issue tracker for personal support requests (use [Stack Overflow](http://stackoverflow.com) or IRC).
+
+* Please **do not** derail or troll issues. Keep the discussion on topic and respect the opinions of others.
+
+As a courtesy to avoid sending notifications to any user that might have the `@username` being referenced, please remember that GitHub usernames also start with the at sign and therefore wrap words that begin with the at sign (`@`) in backticks.
+
+<a id="bugs"></a>
+## Bug reports
+
+A bug is a _demonstrable problem_ that is caused by the code in the repository. Good bug reports are extremely helpful - thank you!
+
+Guidelines for bug reports:
+
+1. **Use the GitHub issue search** &mdash; check if the issue has already been reported.
+
+2. **Check if the issue has been fixed** &mdash; try to reproduce it using the latest `master` or development branch in the repository.
+
+3. **Isolate the problem** &mdash; create a [reduced test case](http://css-tricks.com/6263-reduced-test-cases/) and a live example that should be included in each bug report.
+
+A good bug report shouldn't leave others needing to chase you up for more information. Please try to be as detailed as possible in your report. What is your environment? What steps will reproduce the issue? What browser(s) and OS experience the problem? What would you expect to be the outcome? All these details will help people to fix any potential bugs.
+
+_Example:_
+
+> Short and descriptive example bug report title
+>
+> A summary of the issue and the browser/OS environment in which it occurs. If
+> suitable, include the steps required to reproduce the bug.
+>
+> 1. This is the first step
+> 2. This is the second step
+> 3. Further steps, etc.
+>
+> `<url>` - a link to the reduced test case
+>
+> Any other information you want to share that is relevant to the issue being
+> reported. This might include the lines of code that you have identified as
+> causing the bug, and potential solutions (and your opinions on their
+> merits).
+
+Last but not least, if you have a solution or suggestion for how to fix the bug you're reporting, please include it, too, or make a pull request - this will make the life of the maintainers easier and a bug faster to be fixed.
+
+<a id="features"></a>
+## Feature requests
+
+Feature requests are welcome. But take a moment to find out whether your idea fits with the scope and aims of the project. It's up to *you* to make a strong case to convince the project's developers of the merits of this feature. Please provide as much detail and context as possible and don't forget:
+
+* Please search for existing feature requests first to see if something similar already exists.
+* Include a clear and specific use-case. We love new ideas, but we do not add features without a reason.
+* Consider whether or not your feature would be better as a function or implemented in a separate project.
+
+## Pull requests
+
+Good pull requests - patches, improvements, new features - are a fantastic help. They should remain focused in scope and avoid containing unrelated commits. You can start by adding a feature request to get feedback and see how your idea is received.
+
+**Please ask first** before embarking on any significant pull request (e.g. implementing features, refactoring code, porting to a different language), otherwise you risk spending a lot of time working on something that the project's developers might not want to merge into the project.
+
+Please adhere to the coding conventions used throughout a project (indentation, accurate comments, etc.) and any other requirements (such as test coverage).
+
+Follow this process if you'd like your work considered for inclusion in the project:
+
+1.  [Fork](http://help.github.com/fork-a-repo/) the project, clone your fork, and configure the remotes:
+
+    ```bash
+    # Clone your fork of the repo into the current directory
+    git clone https://github.com/<your-username>/<repo-name>
+    # Navigate to the newly cloned directory
+    cd <repo-name>
+    # Assign the original repo to a remote called "upstream"
+    git remote add upstream https://github.com/<upstream-owner>/<repo-name>
+    ```
+
+2.  If you cloned a while ago, get the latest changes from upstream:
+
+    ```bash
+    git checkout <dev-branch>
+    git pull upstream <dev-branch>
+    ```
+
+3.  Create a new topic branch (off the main project development branch) to contain your feature, change, or fix:
+
+    ```bash
+    git checkout -b <topic-branch-name>
+    ```
+
+4.  Commit your changes in logical chunks. Please adhere to these [git commit message guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) or your code is unlikely be merged into the main project. Use Git's [interactive rebase](https://help.github.com/articles/interactive-rebase) feature to tidy up your commits before making them public.
+
+5.  Locally merge (or rebase) the upstream development branch into your topic branch:
+
+    ```bash
+    git pull [--rebase] upstream <dev-branch>
+    ```
+
+6.  Push your topic branch up to your fork:
+
+    ```bash
+    git push origin <topic-branch-name>
+    ```
+
+7.  [Open a Pull Request](https://help.github.com/articles/using-pull-requests/) with a clear title and description.
+
+**IMPORTANT**: By submitting a patch, you agree to allow the project owner to
+license your work under the same license as that used by the project.
+
+### Coding Standards
+
+* Always use spaces, never tabs
+* End lines in semi-colons.
+
+## Developing
+
+If you want to take an issue, just add a small comment saying you are having a go at something, so we don't get duplication.
+
+[markdown]: https://help.github.com/articles/github-flavored-markdown

docs/INSTALL.md

@@ -0,0 +1,47 @@
+# [Installation and update guide][project]
+[project]: https://github.com/sommerregen/grav-plugin-themer
+
+## Installation
+
+Installing the `Themer` plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.
+
+### GPM Installation (Preferred)
+
+The simplest way to install this plugin is via the [Grav Package Manager (GPM)](http://learn.getgrav.org/advanced/grav-gpm) through your system's Terminal (also called the command line). From the root of your Grav install type:
+
+    bin/gpm install themer
+
+This will install the `Themer` plugin into your `/user/plugins` directory within Grav. Its files can be found under `/your/site/grav/user/plugins/themer`.
+
+### Manual Installation
+
+To install this plugin, just download the zip version of this repository and unzip it under `/your/site/grav/user/plugins`. Then, rename the folder to `themer`. You can find these files either on [GitHub](https://github.com/sommerregen/grav-plugin-themer) or via [GetGrav.org](http://getgrav.org/downloads/plugins).
+
+You should now have all the plugin files under
+
+    /your/site/grav/user/plugins/themer
+
+>> NOTE: This plugin is a modular component for Grav which requires [Grav](http://github.com/getgrav/grav) and a theme to be installed in order to operate.
+
+## Updating
+
+As development for `Themer` continues, new versions may become available that add additional features and functionality, improve compatibility with newer Grav releases, and generally provide a better user experience. Updating `Themer` is easy, and can be done through Grav's GPM system, as well as manually.
+
+### GPM Update (Preferred)
+
+The simplest way to update this plugin is via the [Grav Package Manager (GPM)](http://learn.getgrav.org/advanced/grav-gpm). You can do this with this by navigating to the root directory of your Grav install using your system's Terminal (also called command line) and typing the following:
+
+    bin/gpm update themer
+
+This command will check your Grav install to see if your `Themer` plugin is due for an update. If a newer release is found, you will be asked whether or not you wish to update. To continue, type `y` and hit enter. The plugin will automatically update and clear Grav's cache.
+
+#### Manual Update
+
+Manually updating `Themer` is pretty simple. Here is what you will need to do to get this done:
+
+  * Delete the `your/site/user/plugins/themer` directory.
+  * Download the new version of the `Themer` plugin from either [GitHub](https://github.com/sommerregen/grav-plugin-themer) or [GetGrav.org](http://getgrav.org/downloads/plugins).
+  * Unzip the zip file in `your/site/user/plugins` and rename the resulting folder to `themer`.
+  * Clear the Grav cache. The simplest way to do this is by going to the root Grav directory in terminal and typing `bin/grav clear-cache`.
+
+>> Note: Any changes you have made to any of the files listed under this directory will also be removed and replaced by the new set. Any files located elsewhere (for example a YAML settings file placed in `user/config/plugins`) will remain intact.

hebe.json

@@ -0,0 +1,15 @@
+{
+   "project":"grav-plugin-themer",
+   "platforms":{
+      "grav":{
+         "nodes":{
+            "plugin":[
+               {
+                  "source":"/",
+                  "destination":"/user/plugins/themer"
+               }
+            ]
+         }
+      }
+   }
+}