Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit fb9ee39
Showing
11 changed files
with
5,660 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
# build artifacts | ||
plugin.sketchplugin | ||
|
||
# npm | ||
node_modules | ||
.npm | ||
npm-debug.log | ||
|
||
# mac | ||
.DS_Store | ||
|
||
# WebStorm | ||
.idea |
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
{ | ||
"compatibleVersion": 3, | ||
"bundleVersion": 1, | ||
"icon": "icon.png", | ||
"commands": [ | ||
{ | ||
"name": "my-command", | ||
"identifier": "my-command-identifier", | ||
"script": "my-command.js" | ||
} | ||
], | ||
"menu": { | ||
"title": "100-shapesum", | ||
"items": [ | ||
"my-command-identifier" | ||
] | ||
}, | ||
"version": "0.1.0", | ||
"name": "100-shapesum", | ||
"identifier": "100-shapesum", | ||
"disableCocoaScriptPreprocessor": true, | ||
"appcast": "https://raw.githubusercontent.com//master/.appcast.xml" | ||
} |
133 changes: 133 additions & 0 deletions
133
100-shapesum.sketchplugin/Contents/Sketch/my-command.js
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,93 @@ | ||
# 100-shapesum | ||
|
||
_This plugin was created using `skpm`. For a detailed explanation on how things work, checkout the [skpm Readme](https://github.com/skpm/skpm/blob/master/README.md)._ | ||
|
||
## Usage | ||
|
||
Install the dependencies | ||
|
||
```bash | ||
npm install | ||
``` | ||
|
||
Once the installation is done, you can run some commands inside the project folder: | ||
|
||
```bash | ||
npm run build | ||
``` | ||
|
||
To watch for changes: | ||
|
||
```bash | ||
npm run watch | ||
``` | ||
|
||
Additionally, if you wish to run the plugin every time it is built: | ||
|
||
```bash | ||
npm run start | ||
``` | ||
|
||
## Custom Configuration | ||
|
||
### Babel | ||
|
||
To customize Babel, you have two options: | ||
|
||
* You may create a [`.babelrc`](https://babeljs.io/docs/usage/babelrc) file in your project's root directory. Any settings you define here will overwrite matching config-keys within skpm preset. For example, if you pass a "presets" object, it will replace & reset all Babel presets that skpm defaults to. | ||
|
||
* If you'd like to modify or add to the existing Babel config, you must use a `webpack.skpm.config.js` file. Visit the [Webpack](#webpack) section for more info. | ||
|
||
### Webpack | ||
|
||
To customize webpack create `webpack.skpm.config.js` file which exports function that will change webpack's config. | ||
|
||
```js | ||
/** | ||
* Function that mutates original webpack config. | ||
* Supports asynchronous changes when promise is returned. | ||
* | ||
* @param {object} config - original webpack config. | ||
* @param {boolean} isPluginCommand - whether the config is for a plugin command or a resource | ||
**/ | ||
module.exports = function(config, isPluginCommand) { | ||
/** you can change config here **/ | ||
} | ||
``` | ||
|
||
## Debugging | ||
|
||
To view the output of your `console.log`, you have a few different options: | ||
|
||
* Use the [`sketch-dev-tools`](https://github.com/skpm/sketch-dev-tools) | ||
* Open `Console.app` and look for the sketch logs | ||
* Look at the `~/Library/Logs/com.bohemiancoding.sketch3/Plugin Output.log` file | ||
|
||
Skpm provides a convenient way to do the latter: | ||
|
||
```bash | ||
skpm log | ||
``` | ||
|
||
The `-f` option causes `skpm log` to not stop when the end of logs is reached, but rather to wait for additional data to be appended to the input | ||
|
||
## Publishing your plugin | ||
|
||
```bash | ||
skpm publish <bump> | ||
``` | ||
|
||
(where `bump` can be `patch`, `minor` or `major`) | ||
|
||
`skpm publish` will create a new release on your GitHub repository and create an appcast file in order for Sketch users to be notified of the update. | ||
|
||
You will need to specify a `repository` in the `package.json`: | ||
|
||
```diff | ||
... | ||
+ "repository" : { | ||
+ "type": "git", | ||
+ "url": "git+https://github.com/ORG/NAME.git" | ||
+ } | ||
... | ||
``` |
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.