Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/getgrav/grav-plugin-devtools
Grav Devtools Plugin
https://github.com/getgrav/grav-plugin-devtools
developer-tools devtools grav grav-plugin
Last synced: about 2 months ago
JSON representation
Grav Devtools Plugin
- Host: GitHub
- URL: https://github.com/getgrav/grav-plugin-devtools
- Owner: getgrav
- License: mit
- Created: 2016-04-19T16:36:20.000Z (over 8 years ago)
- Default Branch: develop
- Last Pushed: 2024-05-22T13:09:04.000Z (8 months ago)
- Last Synced: 2024-10-30T02:06:03.494Z (2 months ago)
- Topics: developer-tools, devtools, grav, grav-plugin
- Language: Twig
- Homepage: https://getgrav.org
- Size: 228 KB
- Stars: 37
- Watchers: 9
- Forks: 31
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Grav Devtools Plugin
The `devtools` is a [Grav](http://github.com/getgrav/grav) Plugin that lets you quickly create a scaffolding for your new plugins and themes. The plugin provides CLI commands that allow for the quick and easy deployment of a sample scaffolding for your new plugin.
# Installation
## GPM Installation (Preferred)
The simplest way to install this plugin is via the [Grav Package Manager (GPM)](http://learn.getgrav.org/advanced/grav-gpm). From the root of your Grav install type:
bin/gpm install devtools
## Manual Installation
If for some reason you can't use GPM you can manually install this plugin. Download the zip version of this repository and unzip it under `/your/site/grav/user/plugins`. Then, rename the folder to `devtools`.
You should now have all the plugin files under
/your/site/grav/user/plugins/devtools
## Configuration
By default, devtools will perform a check with the online gpm repository to ensure name-collision avoidance. If you wish to not perform this online check, change the devtools.yaml at `user/config/plugins` from `collision_check: true` to `collision_check: false`.
# Usage
## Plugin Scaffolding
To create a new plugin you simply need to run: `bin/plugin devtools new-plugin` and fill in the few questions at the prompts:
```
> bin/plugin devtools new-plugin
Enter Plugin Name: MyPlugin
Enter Plugin Description: My New Custom Plugin
Enter Developer Name: Johnny Rotten
Enter GitHub ID (can be blank): pretty-vacant
Enter Developer Email: [email protected]
SUCCESS plugin myplugin -> Created Successfully
Path: /home/johnnyr/webroot/grav-installation/user/plugins/myplugin
```
## Theme Scaffolding
To create a new theme you simply need to run: `bin/plugin devtools new-theme` and fill in the few questions at the prompts:
```
> bin/plugin devtools new-theme
Enter Theme Name: MyTheme
Enter Theme Description: My New Custom Theme
Enter Developer Name: Johnny Rotten
Enter GitHub ID (can be blank): pretty-vacant
Enter Developer Email: [email protected]
Please choose a template type
[pure-blank ] Basic Theme using Pure.css
[inheritance] Inherit from another theme
[copy ] Copy another theme
> pure-blank
SUCCESS theme mytheme -> Created Successfully
Path: /home/johnnyr/webroot/grav-installation/user/themes/mytheme
```
There are **three template creation options**
1. `pure-blank` - This is a very basic blank theme that uses the [Pure CSS framework](http://purecss.io/)
2. `inheritance` - This creates a very basic template with minimal files that inherits a base theme. To find out more about theme inheritance, [check out the subject in more details on the Grav Learn site](https://learn.getgrav.org/themes/customization#theme-inheritance).
3. `copy` - This allows you to create a new theme based on an existing theme. This is the simplest way to get started with a new theme by using another theme as the basis.
## Skipping Online Project Name Collision Checking
By default, devtools will check your project's name with the existing gpm ecosystem to ensure no collisions. In order to skip this check, add an `--offline` or `-o` to your command:
`bin/plugin devtools new-theme --offline`
or
`bin/plugin devtools new-theme -o`