Move example script to "extra" directory, update README

Author: ehrenfeu

README.md

@@ -8,42 +8,16 @@ A very thin Python package (mavenized for [ImageJ2][imagej]) to use the
 Developed and provided by the [Imaging Core Facility (IMCF)][imcf] of the
 Biozentrum, University of Basel, Switzerland.
 
-# Example usage
+## Example usage
 
-The snippet below demonstrates how to use the handler in an ImageJ2 Python
-script utilizing the fabulous [Script Parameters][ij_script_params] for
-retrieving the LogService instance.
-
-```Python
-#@ LogService sjlogservice
-
-from sjlogging.logger import setup_scijava_logger
-from sjlogging.setter import set_loglevel
-
-
-def log_messages(level):
-    log.critical("+++ new round of messages (level %s) +++" % level)
-    set_loglevel(level)
-    log.debug('debug log message')
-    log.info('info log message')
-    log.warn('warn log message')
-    log.error('error log message')
-    log.critical('critical log message')
-    log.critical("--- finished round of messages (level %s) ---" % level)
-
-
-log = setup_scijava_logger(sjlogservice)
-
-log_messages('WARNING')
-log_messages('INFO')
-log_messages('DEBUG')
-log_messages('WARNING')
-```
+The code in [extra/scripts/example.py](extra/scripts/example.py) demonstrates
+how to use the handler in an ImageJ2 Python script utilizing the fabulous
+[Script Parameters][ij_script_params] for retrieving the LogService instance.
 
 Running this code from ImageJ will result in the following messages being
 printed to the console or the *Log* window, depending on how you launch ImageJ:
 
-```
+```log
 [Fri Jan  5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level WARNING) +++
 [Fri Jan  5 12:25:15 CET 2018] [WARNING] warn log message
 [Fri Jan  5 12:25:15 CET 2018] [ERROR] error log message

extra/README.md

@@ -0,0 +1,12 @@
+# Supplementary stuff
+
+This directory contains additional scripts and stuff that can't or shouldn't be
+packaged in the `.jar` file by Maven but is rather meant as an example, to be
+run manually or copied over to a specific location inside a Fiji installation.
+
+## Logger usage example
+
+The script [`example.py`](scripts/example.py) shows how to use the scijava
+logging adapter from Jython code and demonstrates its behaviour in the
+*Console/Log* window. To use it, simply open it with the Script Editor and hit
+the `Run` button.