.mozilla/firefox/default/extensions/itsalltext@docwhat.gerf.org/chrome/locale/en-US/readme.xhtml

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml" >
   3   <head>
   4     <title>Welcome to It's All Text! version 0.7.3</title>
   5     <style type="text/css">
   6       html { background: #abd; color: #000; padding: 0; margin: 0; }
   7       body { background: #fff; color: #000; margin: 1ex auto; padding: 1em;
   8              -moz-border-radius: 1em; width: 30em;
   9              font-family: sans-serif;}
  10       h1, h2, h3, h4, h5, h6 { background: #ffa; color: #06d; -moz-border-radius: 1ex; padding: 0 0.8em 0 2em; margin-left: -2em;}
  11       h1 { padding: 0.5ex 1em 0.5ex 2em; margin: 0 -2em;}
  12       h2, h3, h4, h5, h6 { display: block; width: 20em; clear: both; }
  13
  14       tt, code { font-size: 1.1em; font-weight: bold; color: #048; }
  15       dt { font-weight: bold; color: #048; }
  16
  17       #ver { margin: 0; text-align: right; }
  18       #test { width: 50%; height: 10em; background: #cdf; }
  19       #nteb { font-size: 0.5em; text-align: right; margin-right: 50%; padding-right: 30px; }
  20
  21       .iat { font-style: oblique; color: #024; }
  22       .warn { background: #fdd; }
  23
  24       pre { background: #def; color: black; margin: 1em; padding: 0 1em; }
  25
  26       #faq dl { margin-left: 1em; }
  27       #faq dd { font-size: 0.8em; }
  28     </style>
  29   </head>
  30   <body>
  31     <h1>Welcome to <span class="iat">It's All Text!</span></h1>
  32     <p id="ver"> version 0.7.3</p>
  33
  34     <p class="warn">
  35       This software is ALMOST version 1.0! It's inches from being
  36       ready to go.  Please <a
  37       href="http://docwhat.gerf.org/2007/03/its_all_text_v06">report</a>
  38       any problems you have to help!
  39     </p>
  40
  41     <p>
  42       <span class="iat">It's All Text!</span> gives you a simple way to edit textareas, the large text boxes in forms, using your favorite editor.
  43     </p>
  44
  45
  46
  47     <h3>Quick Start</h3>
  48     <p>
  49       Upon installation, go to the menu <tt>Tools -&gt; It's All Text!
  50       -&gt; Preferences</tt> to set your preferences. Specifically,
  51       you'll have to set the editor's full path.
  52     </p>
  53
  54     <p>
  55       There are three ways to use <span class="iat">It's All Text!</span>:
  56     </p>
  57     <ul>
  58       <li>Right click on a textarea, select <tt>It's All Text!</tt>.
  59       </li>
  60       <li>Click on the edit buttons added for your convenience.
  61       </li>
  62       <li>Right click on the edit buttons for more options.
  63       </li>
  64     </ul>
  65
  66     <p>
  67       Here is a test edit box for you to play with&hellip;
  68     </p>
  69     <form action="" style="margin-left: 2em;">
  70       <p style="margin: 0; padding: 0;">
  71         <textarea id="test" cols="10" rows="4">Click the edit button and have fun editing!</textarea>
  72       </p>
  73       <div id="nteb">Note the edit button.&mdash;&gt; </div>
  74     </form>
  75
  76     <div style="clear:both;"/>
  77     <p id="signoff"> Ciao! </p>
  78
  79
  80     <h3>A note to Mac OS X users</h3>
  81
  82     <p>
  83       Out of the box, <span class="iat">It's All Text!</span> uses the <code>open</code> program. <code>open</code> behaves like double clicking on a file.  It uses the type of the file to choose the correct application to run;  for <tt>.txt</tt> files, that application is the built-in text editor.
  84     </p>
  85     <p>
  86       If this behavior is fine for you, then leave the editor option alone and enjoy!
  87     </p>
  88     <p>
  89       However, if you want to use a different editor or to force the same editor regardless of the file type, then you will need to do something a little more complicated.
  90     </p>
  91     <p>
  92       Firefox <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=307463">cannot run .app applications directly</a>.  To run a program in Mac OS X you need to do one of two things:  If your editor comes with a non-<code>.app</code> version, then use that.  Otherwise you have to write a shell script.
  93     </p>
  94     <p>
  95       Check your editor's documentation; if it comes with a standalone program, usually located in the <code>/usr/bin/</code> directory, then you can enter that into the <span class="iat">It's All Text!</span> preferences and you're done.
  96     </p>
  97     <p>
  98       Otherwise, you need to create a shell script.  Here are the basic steps to create a shell script:
  99     </p>
 100     <ol>
 101       <li> Open your favorite editor. </li>
 102       <li> Create a file like the example below. </li>
 103       <li> Save it to your home directory: <code>~/iat.sh</code> </li>
 104       <li> Open a terminal window. </li>
 105       <li> Type this command to make the shell script executable: <code>chmod +x ~/iat.sh</code> </li>
 106       <li> In <span class="iat">It's All Text!</span> preferences, use the shell script as your editor. </li>
 107     </ol>
 108
 109     <p>
 110       The example shell script.  Replace <code>/path/to/editor.app</code> with the actual path to your .app file.  It'll probably be something like <code>/Applications/MyEditor.app</code>.
 111     </p>
 112     <pre lang="sh">#!/bin/sh
 113 # This is an example shell script for It's All Text!
 114
 115 open -a /path/to/editor.app $*</pre>
 116
 117     <p>
 118       Other alternative shell scripts are available at <a href="http://docwhat.gerf.org/2007/03/its_all_text_v06/#comment-2054">here</a>.
 119     </p>
 120
 121
 122
 123     <h3>FAQ</h3>
 124
 125     <dl id="faq">
 126       <dt>I want to do something more complicated than just running an editor with a file-name.</dt>
 127       <dd>
 128         <p>In UNIX systems, such as Mac OS X or Linux, you can create a shell script with your commands in it.</p>
 129         <p>In windows, you can create a <tt>.cmd</tt> file instead.</p>
 130       </dd>
 131
 132       <dt>I can't find the edit button for (gmail, blogger, etc.)</dt>
 133       <dd>
 134         <p>Gmail, blogger, and other sites has the option to use "rich text editors".  The editors act similar to a word processor.  Due to the way these work, it isn't possible for <span class="iat">It's All Text!</span> find the <tt>textarea</tt>, it is hidden or, in some cases, absent.
 135         </p>
 136       <p>
 137         Workaround: Turn off the rich text editor, if possible.
 138       </p>
 139       </dd>
 140
 141       <dt>I use non-ASCII characters and they turn into blocks or question marks (?).</dt>
 142       <dd>
 143         <p>
 144           The problem is that the encoding <span class="iat">It's All Text!</span> is using and your editor is using don't match.  You can figure out what encoding your editor wants and change the encodings preference in <span class="iat">It's All Text!</span> or you can change the encoding your editor uses.
 145         </p>
 146         <p>
 147           A common problem I get is that someone is using Notepad or WordPad in Windows.  These both do not support sane encodings.  I recommend getting something like <a href="http://notepad-plus.sourceforge.net/">Notepad++</a> for editing in UTF-8 instead.
 148         </p>
 149       </dd>
 150     </dl>
 151
 152   </body>
 153 </html>
 154
 155 <!-- LocalWords:  gmail blogger WordPad UTF html abd fff moz ffa tt dt ver cdf
 156 -->
 157 <!-- LocalWords:  nteb px iat faq dl cmd
 158 -->