Skip to content

Commit

Permalink
docs: add link to video tutorials on YouTube
Browse files Browse the repository at this point in the history
Plus some minor readme improvements.
  • Loading branch information
pbodnar authored May 21, 2022
1 parent fe55598 commit a3ee4d1
Showing 1 changed file with 12 additions and 8 deletions.
20 changes: 12 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,20 @@
# About
# Greasemonkey (User) Scripts

This project contains various handy user scripts for the [Greasemonkey](https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/) (only for Firefox; GM) and [Tampermonkey](https://www.tampermonkey.net/) (for Chrome, but also for other browsers; TM) browser addons. A user script is a piece of JavaScript code which gets executed on page load and which extends functionality of the pages it was written for.
This project contains various handy user scripts for the [Greasemonkey](https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/) (only for Firefox; GM) and [Tampermonkey](https://www.tampermonkey.net/) (for Chrome, but also for other browsers; TM) browser addons. A [user script](https://en.wikipedia.org/wiki/Userscript) is a piece of JavaScript code which gets executed on page load and which extends functionality of the pages it was written for.

# Installation
## YouTube Tutorials

Videos in the following YouTube playlist might help you to get started with this project quickly: [gm-scripts - User scripts for Jira](https://www.youtube.com/playlist?list=PLRRrWIs5dbQ0jsdhgz_gRe-RH4ybNfwni).

## Installation

Firstly install the aforementioned addon for your favorite browser and then simply open the selected *\*.user.js* file in the browser. GM (or TM) will guide you through the rest of the user script installation. The most important thing to do is to set up the pages for which you want to have the given user script activated. You can always find an example of the appropriate "include pattern" right in the installed user script.

An example configuration:

![screenshot](screenshots/JIRA_copy_GM-options.png)

# Usage
## Usage

The usage is always specific to a given user script. Most user scripts should offer a special help dialog that can be opened via the GM / TM toolbar icon. And of course, you can always look into the script's source code and see what it actually does... :)

Expand All @@ -26,25 +30,25 @@ One of the JIRA_shotcuts user script functions in action:

![screenshot](screenshots/JIRA_shortcuts_fn-alter-estim.png)

# Troubleshooting
## Troubleshooting

What if something is not working as expected? Then you should firstly try to find some relevant information or error messages in the console log - this is typically available by pressing F12 in your browser and by navigating to the "Console" tab. And select for example "Logging -> Log" to see detailed logging from the GM scripts in Firefox.

If you find a bug or a missing feature, you can create a new issue for that on the "Issues" page of this Github project.

# For developers
## For Developers

This special chapter includes tips for those who would like to develop GM / TM scripts.

## Run GM Scripts on Local Disk Files
### Run GM Scripts on Local Disk Files

Set the following on the "about:config" page in Firefox:

greasemonkey.fileIsGreaseable: true

See http://stackoverflow.com/questions/9931115/run-greasemonkey-on-html-files-located-on-the-local-filesystem

## Force GM to Run Script in Sandbox
### Force GM to Run Script in Sandbox

At least some `@grant <> 'none'` must be present in the user script's header in order to force GM to run the script 'in sandbox'.

Expand Down

0 comments on commit a3ee4d1

Please sign in to comment.