user_manual/UserManual.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Jupyter Graffiti: Introduction and User Manual"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### What is Jupyter Graffiti?\n",
    "\n",
    "Jupyter Graffiti are short movies you can add to Notebooks that can illustrate and teach any concept you can think of. It's similar to a screencast, but there's no traditional \"video\"; instead, movies are \"live\", meaning they play back whatever you were doing while recording, right in the notebook cells. Viewers can pause your movie any time and play around in your Notebook to try out whatever you're showing them.\n",
    "\n",
    "You can add unlimited Graffiti to text, code, and even images in any Notebook cell.   \n",
    "\n",
    "Try out a demo of Graffiti on <a style=\"font-weight:800;color:blue;\" target=\"_demo\" title=\"Jump to Graffiti Demo\" href=\"https://mybinder.org/v2/gh/willkessler/jupytergraffiti/master?filepath=samples%2FGraffiti%20Basic%20Demo.ipynb\">this Binder link</a>.\n",
    "\n",
    "A screenshot of a Graffiti movie in play is shown below. (Note that if you are previewing this user manual on GitHub, the images won't display. You're better off viewing the manual on <a style=\"font-weight:800;color:blue;\" target=\"_demo\" title=\"Jump to Graffiti Demo\" href=\"https://mybinder.org/v2/gh/willkessler/jupytergraffiti/master?filepath=user_manual/UserManual.ipynb\">Binder.org</a>).\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"background: url(images/pythagorasTip5.png); background-repeat:none; background-size:100% 100%;width:100%;height:890px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<br>\n",
    "<br>\n",
    "<hr>\n",
    "\n",
    "You can also add buttons and inline terminals (shells) to help illustrate ideas and techniques and record your activities in these as well:\n",
    " "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"background: url(images/terminal1.png); background-repeat:none; background-size:100% 100%;width:100%;height:504px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Playing back Jupyter Graffiti"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Graffiti are indicated by a <span style=\"border-bottom:2px dashed rgb(47,147,107);\">dashed green underline</span> underneath text or images, as well as a green marker off to the side of the Notebook. When the users hover over the underlined text, the user will see a floating tip which gives information and access to play the movie (when a movie is available for the Graffiti).\n",
    "\n",
    "During movie playback, the user is able to \"scrub\" to any part of the movie (just like a regular video on YouTube), pause the movie, mute the sound, and play the movie at 2x speed. They can also click the red X to cancel playback any time. \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"background: url(images/graffitiTipAndMarker.png); background-repeat:none; background-size:100% 100%;width:100%;height:288px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "While a Graffiti movie is playing, the user sees a control panel. Here are the controls available to users during movie playback:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"background: url(images/controlPanelExplained2.png); background-repeat:none; background-size:100% 100%;height:510px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### What kinds of things can you record into a movie?\n",
    "\n",
    "* Your voice (just talk as you record)\n",
    "* All your mouse movements, page and cell scrolling, clicking, selecting/highlighting\n",
    "* Any cell execution and its associated output\n",
    "* Adding and removing cells"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### What else can you do with Graffiti?\n",
    "\n",
    "* You can use the Graffiti tips alone; you don't need to record movies if you don't want to. Sometimes tips provide all the information a viewer needs. For instance, in complicated code you can create tips explaining parts of the code that can take the place of a lot of code comments. You can therefore keep the code much shorter and users who are interested can hover over the Graffiti to read the tips only if they want to.\n",
    "* You can add \"annotations\" like freeform drawings, arrows, boxes and other symbols, even pictures-- basically you can scribble on your Notebook anywhere you like (it's only visible while the movie is playing).\n",
    "* You can insert \"mini-terminals\" that give you access to a system shell inside a Notebook cell. All interaction with the \"mini-terminals\" can be recorded in your movies.\n",
    "* \"Graffiti buttons\" can be inserted in cells. These buttons can play Graffiti movies, reveal solutions to challenges students might be facing, or run a command in the mini-terminals.\n",
    "* Lock the markdown cells: You can \"lock\" all the markdown cells so that the user cannot edit them. This is helpful if your markdown content is for teaching only, and you want students to stay focused on code cells.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Setting up Jupyter Graffiti for the First Time\n",
    "\n",
    "Jupyter Graffiti is a Notebook extension. \n",
    "\n",
    "The only requirement is Jupyter Notebooks and your web browser (Chrome/Firefox preferred). \n",
    "\n",
    "Installation of the software is covered in the README.md file at the top of this repository, but you can also try it out without installing anything at <a style=\"font-weight:800;color:blue;\" target=\"_demo\" title=\"Jump to Graffiti Demo\" href=\"https://mybinder.org/v2/gh/willkessler/jupytergraffiti/master?filepath=samples%2FGraffiti%20Basic%20Demo.ipynb\">this Binder link</a>."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Activating Jupyter Graffiti in a Notebook"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Load any Notebook and activate Graffiti by simply clicking the Activate Graffiti button. This step just adds some metadata to the notebook (a graffiti `id`) so that the Graffiti extension can connect Graffiti and recordings back to this Notebook. You can activate Graffiti on more than one Notebook in a directory; the Graffiti will all be stored inside the `jupytergraffiti_data` folder in the same directory as the Notebook. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"background: url(images/activateGraffiti2.png); background-repeat:none; background-size:100% 100%;width:100%;height:180px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Creating Graffiti Tips"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once Graffiti has been activated for a given Notebook, the \"Activate Graffiti\" button now becomes the Show Graffiti Editor button. Click this button to show or hide the editor panel. You can drag the editor panel around to get it out of your way if it's covering up important content using the drag handle on the left side of the panel."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/editorPanelWithDataDir.png); background-repeat:no-repeat; height:482px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now, when you select some text in a Notebook code cell, the Graffiti editor panel will change to show only a button that says \"Create\" on it as shown in the image below.\n",
    "\n",
    "Click this button. A new code cell will appear above your current cell. Enter whatever you want to show up in the Graffiti tip. (You can use markdown formatting here).\n",
    "\n",
    "When you hit control-enter in the Graffiti editor cell, or click \"Save Graffiti\" in the editor panel, your Graffiti will be saved, the Graffiti editor cell will disappear, and you will see a green underline under the text in the code cell where you made your selection. Mouse over the underlined text to see your new tip."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/showGraffitiEditor.png);  background-size:100% 100%;width:100%;height:200px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Creating Movie Recordings"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Recording your interactions"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "When you edit a markdown cell and select any text in it, the Editor Panel will show a \"Record\" button. This allows you to record a movie. \n",
    "\n",
    "Click the Record button. Scroll approximately to where you wish to begin recording, and click anywhere in the Notebook. From now on, all of your activities are being recorded. \n",
    "\n",
    "The Editor Panel will look like what's shown in the screenshot below. You can use the pen, highlight and eraser tools, or expand the stickers part of the panel to get additional markup tools to use while recording.\n",
    "\n",
    "To finish recording, hold down the Option key for about a second. The movie recording will automatically be saved and attached to your Graffiti.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/recordingGraffitiInProgress.png);  background-size:100% 100%;width:100%;height:500px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Annotating while recording"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "While making a recording, you can use the Editor panel to create line drawings, highlight items, or add \"stickers\" by selecting from the stickers choices. All of these annotations are drawn in \"temporary ink\" meaning they fade away after a few seconds (unless you uncheck that option in the Editor panel).\n",
    "\n",
    "You can also type text stickers anywhere in your Notebook, using the Text sticker (`Tt` icon), and even create custom image stickers with the `Cs` sticker icon.\n",
    "\n",
    "Keep in mind that all drawings created during a recording only persist while the recording is being played back. After the movie ends, the drawings will disappear until the next time the movie is played."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Editing and Recording"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once you've made a tip or recording, you can always edit it, (re)record a movie, or remove it entirely. Just select somewhere inside the Graffiti text (in markdown cells you will need to edit the Markdown, in code cells, just click inside the graffiti-ized text)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/editingGraffitiInMarkdown.png);  background-size:100% 100%;width:100%;height:250px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Using Graffiti Directives"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can add additional <a href=\"Directives.ipynb\">\"directives\"</a> to every Graffiti that control how it behaves. All directives are entered in the Graffiti Editor cell when you Edit the Graffiti tip. \n",
    "\n",
    "For instance, the `%%play_on_click` directive will make any movie recorded for a Graffiti begin playing immediately when the Graffiti target (underlined text) is clicked.\n",
    "\n",
    "Each directive must be added on a line by itself, and all of them start with the special prefix `%%`. A list of available directives is given in the Directives documentation."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Locking Markdown cells"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you click the Lock icon on the Graffiti Editor panel, you will lock all the content in markdown cells so that it cannot be edited. You may want to do this to prevent students from accidentally modifying instructional content in markdown cells or deleting Graffiti."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Removing Graffiti"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Use the Trash icon in the Graffiti panel to delete a Graffiti. You must select in the text of the Graffiti first. If the Graffiti is in a markdown cell then edit the markdown cell, click in the Graffiti text, and then click the Trash icon.\n",
    "\n",
    "If you delete text containing a Graffiti, it will not be removed from the stored Graffiti in the `jupytergraffiti_data` folder, although that's not a big deal. But to be most efficient you should use the Trash icon to remove Graffiti before you delete the text containing the Graffiti."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Using the API"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Graffiti includes a Python API that's loaded when you run `import jupytergraffiti` in a code cell. Using this API, you can trigger Graffiti movies to play via your Python code, rather than via user clicks. You can also take other actions on Graffiti. For more information on the API, please consult the <a href=\"Graffiti API.ipynb\">Graffiti API documentation.</a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Graffiti Extras\n",
    "\n",
    "If no text is selected in your Notebook the Editor Panel gives you access to several Graffiti \"extras\" as shown below."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/graffitiExtras2.png);  background-size:100% 100%;width:100%;height:500px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Changing the Graffiti Data Directory\n",
    "\n",
    "**New** for April 27, 2019: You can now change the data directory path. You will see an icon not shown in the image above for the Editor Panel, but that looks like this:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/editorPanelWithDataDir.png);  background-size:100% 100%;width:200px;height:200px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Click the \"Home Folder Icon\" and you will see a confirmation process by which you can change the path to where Graffiti are stored. By default, Graffiti are stored in a folder alongside your notebook called `jupytergraffiti_data`. However, you may wish to store them in another spot. For instance, perhaps you have several notebooks across different sub-folders, but you wish to store all the Graffiti at the top level. Using this function, you can change the location and name of the folder. Note that you cannot use `.` (ie hidden) folders e.g. `.graffiti` because Jupyter will not serve these files up through its built-in web server Tornado. If you wish to distinguish the Graffiti folder from other folders, consider using a prefix like `_` in the folder name, e.g. `../_graffiti-data`.  Here's what the process looks like."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/changeDataDir.png);  background-size:100% 100%;width:800px;height:400px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<div style=\"border:1px solid #ddd;background: url(images/changeDataDir2.png);  background-size:100% 100%;width:700px;height:180px;\">\n",
    "</div>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Creating Inline Terminals (Shells)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can insert a Graffiti shell using the shell icon button on the Graffiti Editor panel. It will be inserted before the selected cell. \n",
    "\n",
    "You can control how many lines of text the shell has. Edit the metadata for the cell and change the *\"rows\"* entry to the number of desired rows:\n",
    "\n",
    "```\n",
    "\"graffitiConfig\": {\n",
    "    \"rows\": 6,\n",
    "    \"startingDirectory\": \"samples\",\n",
    "    \"terminalId\": \"id_73csup4\",\n",
    "    \"type\": \"terminal\"\n",
    "  }\n",
    "  ```\n",
    "\n",
    "For instance, in the above metadata the current number of rows is 6. You could, for instance, change the number of rows to 12. In order for the change to \"stick\", you must save the Notebook and reload the page.\n",
    "\n",
    "If you want all the terminals to use the same linux shell, add a metadata entry at the *Notebook* level. Use Jupyter's **Edit...Edit Notebook Metadata** menu, and in the `graffiti` configuration section add a `singleTerminal` entry like this:\n",
    "```\n",
    "\"graffiti\": {\n",
    "    \"firstAuthorId\": \"dev\",\n",
    "    \"id\": \"id_sz43bzu\",\n",
    "    \"language\": \"EN\",\n",
    "    \"singleTerminal\": \"true\"\n",
    "  },\n",
    "```\n",
    "\n",
    "Note: you **must** use double-quotes around _true_ in the entry above for this to work.\n",
    "\n",
    "Each shell cell gets a **Jump to Notebook Dir** link and a **Reset** link underneath it. Those links will jump the shell to the directory containing the notebook, or destroy the shell cell and replace it with a new one (and new underlying shell process).  Please note that these functions will not work on Windows installations."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Creating Graffiti Buttons"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You can insert a Graffiti Button by clicking the Button icon in the Graffiti Editor panel. If you have selected a markdown cell with an existing Graffiti button in it, a new button will be created alongside the existing one.\n",
    "\n",
    "To control the Graffiti associated with the button, edit the markdown cell contents. When you click inside the Graffiti text, the Graffiti Editor panel will provide an Edit button you can use to configure the button Graffiti in the same way you configure any Graffiti. You can use <a href=\"Directives.ipynb\">directives</a> to configure what the button does when clicked, for instance, running a command in a Graffiti shell."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Creating a Graffiti \"Suite\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The easiest way to set up shells and buttons to work in concert is a Graffiti Suite.\n",
    "\n",
    "A \"Graffiti Suite\" is actually a regular code cell, a Graffiti shell, and a Graffiti Button, all wired together. You can create a Suite by clicking the Suite button on the Graffiti Editor panel.\n",
    "\n",
    "The code cell is set up to autosave its contents to a text file every time they are changed. The Suite's Graffiti Button will run an arbitrary shell command (by default, the button just runs the `cat` command on the text file, but you can change this to anything you like).  Using a Suite, you can provide a simple coding environment for a student which can then run arbitrary commands on their resulting text files. \n",
    "\n",
    "You can configure the file the code cell's contents are saved to, and what command the button runs, by editing the <a href=\"Directives.ipynb\">directives</a> of the Graffiti Button. An example set of directives is shown in the code cell below. These directives are used by the \"Run Code\" button in the Graffiti Demo Notebook."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# Here are some example directives for a \"Run Code\" button\n",
    "%%play_on_click\n",
    "%%hide_tooltip\n",
    "%%save_to_file id_54d409v \"./sum_natural.cpp\"\n",
    "%%terminal_command id_up4395w \"g++ ./sum_natural.cpp && ./a.out\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Using Show/Hide Graffiti Buttons"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Use the Graffiti Editor panel to create a Show/Hide Button, and you can make it easy to show a solution to a student for any problem they're working on. Again, this is a regular Graffiti button but configured with <a href=\"Directives.ipynb\">directives</a> that will insert a code cell below the cell containing the Graffiti button. Into this code cell Graffiti will insert the contents of any file you wish.  Click the Graffiti button again and the solution cell will disappear.\n",
    "\n",
    "Steps to use this feature:\n",
    "\n",
    "1. First, create a code cell or markdown cell with the solution contents.\n",
    "1. Now click the Show/Hide button on the Graffiti Editor panel\n",
    "1. Your solution cell will disappear and a Show Solution button will show up instead.\n",
    "1. Click the Show Solution button to make the solution appear/disappear.\n",
    "\n",
    "If you want to change your solution, just click Show Solution, modify the solution, and click the Graffiti Editor Panel Show/Hide button to create another Show/Hide solution button based on your modified solution contents.\n",
    "\n",
    "**Note** that a file for inclusion is created in the graffiti_data folder. You can change the Graffiti directive on your button if you want to include a different file. "
   ]
  },
  {
   "attachments": {
    "ksnip_20210209-103244.png": {
     "image/png": "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"
    }
   },
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "![ksnip_20210209-103244.png](attachment:ksnip_20210209-103244.png)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Graffiti Movie \"Takes\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Graffiti records each movie as many times as you like. You can pick the best \"take\" to show your viewers. After you record a movie, you will see a list of \"Takes\" in the Editor Panel when you select the Graffiti. The most recent take is the highest number but you can select an earlier take. Whatever you select will be the take that is viewed when that Graffiti's movie is played.\n",
    "\n",
    "This can be handy when you want to rerecord a movie but reference what you recorded previously.\n",
    "\n",
    "You can use the \"Cleanup Takes\" button (with the bathtub icon) to remove any unused takes when you're satisfied with your final take."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### \"Skips\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Tapping the option (alt) key while recording begins (or ends) a skip period. During this period, by default your activities will not be recorded. You may want to do this during a recording to pause for a bit and then come back.\n",
    "\n",
    "Via <a href=\"Directives.ipynb\">directives</a>, you can change all the skips in a movie to accelerations instead. For instance, instead of just skipping over a section, you can make that section play at 4x speed or play through in just half a second. \n",
    "\n",
    "Because holding down the option key to end recording takes about a second, Graffiti automatically inserts a jump skip at the end of every recording ended by holding down the option key. You cannot control how this skip behaves: Graffiti will always jump over this \"tail second\" during playback."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Notes about How Graffiti Works"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* Any changes made to the notebook during playback are rolled back when the movie finishes or is cancelled (so students don't lose any of their own work).  (Via a directive, you can also make changes \"stick\" after a movie completes. This is useful if you want a student to pick up and extend your example.)\n",
    "* Movies only affect the cells interacted with during recording. If you record a movie that only changes the contents of one cell, no other cells are affected during playback.\n",
    "* Because all the Graffiti information is stored in text files inside the `jupytergraffiti_data` directory, you can add that directory to a source-code control system like `git` if you want to manage changes that way (including recorded audio)\n",
    "* All Graffiti in a notebook are loaded when the notebook is loaded (but asynchronously).  Because there is no streaming, we don't recommend making 10 minute long movies-- the audio portion of the download would be large. Instead, try to create many short movies of 1-3 minutes so that the user doesn't wait a long time to see your videos begin.\n",
    "* Graffiti tries to line up scrolling and the cursor as best it can with the cells that were present during the recording. If you delete cells or rearrange the cells, the movies may not play as expected.\n",
    "* If you want, you can even insert old-skool YouTube videos in the tip via the `%%caption_video_id` directive. This way you can add a talking head to your Graffiti before the user starts playing the Graffiti movie.\n",
    "* If you split a Notebook into two notebooks, be aware that the Notebooks will share a Graffiti id. Behavior of movies in two notebooks that share an ID is unpredictable. Via the API you can make a copy of the first notebook and update all its Graffiti ids to new id's, and then delete Graffiti from the second notebook.\n",
    "* If you are inserting more than one Graffiti terminal, you can have it share a single shell. This may help the terminals load faster but be aware that these are all one Jupyter shell now so whatever you type in one shell will appear in all the shells.  The metadata you must modify is at the Notebook level. \n",
    "* In code cells, Graffiti are tied to the \"tokens\" you select, not specific characters. For instance, if you add a Graffiti to the second \"dog\" word in the sentence _The cat, who was friends with the dog, refused to go on a walk with the dog_ then if you insert another _dog_ in the sentence, the Graffiti will appear to move. This is because we just store the fact that the second instance of the word \"dog\" in the code cell has the Graffiti. E.g. _The cat and the dog, who was friends with the other dog, refused to go on a walk with the dog_. The Graffiti will now be shown on the second \"dog\", not the third \"dog\"."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Sharing Graffiti with Others\n",
    "\n",
    "You can send a notebook to anyone else as you normally would, and it will be annotated with Graffiti. However, you will also need to send along the `jupytergraffiti_data` folder alongside the notebook, as this contains all the information about the Graffiti and movie recordings.\n",
    "\n",
    "If you use and install the `nbzip` extension then it's easy to download this folder as a compressed (tarball) file for upload elsewhere.\n",
    "\n",
    "The recipient of your Graffiti-ized notebook will also need to install Graffiti to view your Graffiti. Or they can upload the notebook and the `jupytergraffiti_data` folder to binder.org to view them there.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Hiding the Graffiti Control Panel"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You may not want your users to have access to the Graffiti editing panel. You can choose to hide the button that shows and hides the Graffiti control panel by adjusting the notebook's metadata.\n",
    "\n",
    "To hide the Graffiti control panel,  add a metadata entry at the *Notebook* level like so: use Jupyter's **Edit...Edit Notebook Metadata** menu, and in the `graffiti` section add a `displayControlPanelButton` entry like this:\n",
    "```\n",
    "\"graffiti\": {\n",
    "    \"firstAuthorId\": \"dev\",\n",
    "    \"id\": \"id_sz43bzu\",\n",
    "    \"language\": \"EN\",\n",
    "    \"displayControlPanelButton\": \"false\"\n",
    "  },\n",
    "```\n",
    "\n",
    "Note: you **must** use double-quotes around _false_ in the entry above for this to work. If you want the panel to be displayed again, just remove this entry or use \"true\" instead of false in this entry."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Who can use Graffiti?\n",
    "\n",
    "Graffiti is open sourced under the same license as Jupyter Notebook. If you use it, please let us know and spread the word about Graffiti."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<hr>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "* Graffiti Version: 1.01\n",
    "* Date of this Manual First Writing: 04/16/19\n",
    "* First Update: 4/29/19\n",
    "* Latest update: 2/8/21"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.8.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}