README.md

TeXify-Plickers

TeXify-Plickers allows you to include mathematics in Plickers. Is NOT a formula editor; LaTeX, MathML or AsciiMath notation language must be known. Is based on MathJax technology.

Installation and usage

You can include mathematics to plickers using a GreaseMonkey/Tampermonkey user-script or a native firefox add-on.

Use the native FireFox Add-on (Desktop & Mobile)

• install FireFox Addon. For mobile, you need to uninstall previous version and turn off xpinstall.signatures.required in about:config

Use a user script (FireFox & Google Chrome Desktop)

• install GreaseMonkey for FireFox or Tampermonkey for Chrome;
• install TeXify-Plickers user script.

Usage

Then, create questions and use delimiters [; and ;] (inline) or $$ and $$ for insert math code.

Sample

14) If [; \frac{2}{a-1} = \frac{4}{y} ;] and [; y \neq 0 ;] where [; a \neq 1 ;] , what is [; y ;] in terms of [; a ;] ?

A: $$ y = 2a - 2  $$
B: $$ y = 2a - 4 $$
C: $$ y = 2a - \frac{1}{2} $$
D: $$ y= \frac{1}{2} \, a + 1 $$

Live view result

Technics and security considerations

compiling firefox add-on

npm, jpm, jpm-mobile installation

sudo apt-get install npm
sudo npm install jpm jpm-mobile --global

edit /usr/local/lib/node_modules/jpm-mobile/bin/jpm-mobile and add cmd line and change 2 run lines :

var VERSION = require("../package.json").version;
var cmd = require("jpm/lib/cmd");
var run = require("../lib/run").run;
...
  .action(function () {
    var manifest = require(path.join(cwd, "package.json"));
    run(manifest, makeOptions(program, "run"))
...
  .action(function () {
    var manifest = require(path.join(cwd, "package.json"))
    run(manifest, makeOptions(program, "test"))
...

edit /usr/local/lib/node_modules/jpm-mobile/lib/adb.js and add " ' " in function amStart(options) :

function amStart(options) {
  console.log("Starting Firefox with " + options.profile);
  var p = cp.spawn(options.adb, [
              "shell",
              "am start",
              "-a",
              "android.activity.MAIN",
              "-n",
              options.intent + "/.App",
              "--es",
              "args",
              "'-profile " + options.profile + "'"
          ], makeOptions(options));
  p.stdout.pipe(process.stdout);
...

Then compile with "jpm xpi"

test on android device

$ adb shell pm list packages | grep org.mozilla
package:org.mozilla.firefox
package:org.mozilla.firefox_beta
$ jpm-mobile run -b firefox_beta --adb $(which adb)

test on desktop

$ jpm run -b $(which firefox)

security

TeXify-Plickers use script = createElement("script") and document.head.appendChild(script) to add mathjax javascript library from hardcoded link of MathJax Content Delivery Network (CDN) . This is secure until cloudflare CDN and your DNS are not compromised.

Known Bugs

tampermonkey for Dolphin

Under tampermonkey for Dolphin (Android), the @include directive is buggy. You must change the script line

// @include https://plickers.com/*

to

// @include *

Picture of question is inserted after choices.

---