--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" >
+ <head>
+ <title>Welcome to It's All Text! version 0.7.3</title>
+ <style type="text/css">
+ html { background: #abd; color: #000; padding: 0; margin: 0; }
+ body { background: #fff; color: #000; margin: 1ex auto; padding: 1em;
+ -moz-border-radius: 1em; width: 30em;
+ font-family: sans-serif;}
+ h1, h2, h3, h4, h5, h6 { background: #ffa; color: #06d; -moz-border-radius: 1ex; padding: 0 0.8em 0 2em; margin-left: -2em;}
+ h1 { padding: 0.5ex 1em 0.5ex 2em; margin: 0 -2em;}
+ h2, h3, h4, h5, h6 { display: block; width: 20em; clear: both; }
+
+ tt, code { font-size: 1.1em; font-weight: bold; color: #048; }
+ dt { font-weight: bold; color: #048; }
+
+ #ver { margin: 0; text-align: right; }
+ #test { width: 50%; height: 10em; background: #cdf; }
+ #nteb { font-size: 0.5em; text-align: right; margin-right: 50%; padding-right: 30px; }
+
+ .iat { font-style: oblique; color: #024; }
+ .warn { background: #fdd; }
+
+ pre { background: #def; color: black; margin: 1em; padding: 0 1em; }
+
+ #faq dl { margin-left: 1em; }
+ #faq dd { font-size: 0.8em; }
+ </style>
+ </head>
+ <body>
+ <h1>Welcome to <span class="iat">It's All Text!</span></h1>
+ <p id="ver"> version 0.7.3</p>
+
+ <p class="warn">
+ This software is ALMOST version 1.0! It's inches from being
+ ready to go. Please <a
+ href="http://docwhat.gerf.org/2007/03/its_all_text_v06">report</a>
+ any problems you have to help!
+ </p>
+
+ <p>
+ <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.
+ </p>
+
+
+
+ <h3>Quick Start</h3>
+ <p>
+ Upon installation, go to the menu <tt>Tools -> It's All Text!
+ -> Preferences</tt> to set your preferences. Specifically,
+ you'll have to set the editor's full path.
+ </p>
+
+ <p>
+ There are three ways to use <span class="iat">It's All Text!</span>:
+ </p>
+ <ul>
+ <li>Right click on a textarea, select <tt>It's All Text!</tt>.
+ </li>
+ <li>Click on the edit buttons added for your convenience.
+ </li>
+ <li>Right click on the edit buttons for more options.
+ </li>
+ </ul>
+
+ <p>
+ Here is a test edit box for you to play with…
+ </p>
+ <form action="" style="margin-left: 2em;">
+ <p style="margin: 0; padding: 0;">
+ <textarea id="test" cols="10" rows="4">Click the edit button and have fun editing!</textarea>
+ </p>
+ <div id="nteb">Note the edit button.—> </div>
+ </form>
+
+ <div style="clear:both;"/>
+ <p id="signoff"> Ciao! </p>
+
+
+ <h3>A note to Mac OS X users</h3>
+
+ <p>
+ 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.
+ </p>
+ <p>
+ If this behavior is fine for you, then leave the editor option alone and enjoy!
+ </p>
+ <p>
+ 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.
+ </p>
+ <p>
+ 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.
+ </p>
+ <p>
+ 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.
+ </p>
+ <p>
+ Otherwise, you need to create a shell script. Here are the basic steps to create a shell script:
+ </p>
+ <ol>
+ <li> Open your favorite editor. </li>
+ <li> Create a file like the example below. </li>
+ <li> Save it to your home directory: <code>~/iat.sh</code> </li>
+ <li> Open a terminal window. </li>
+ <li> Type this command to make the shell script executable: <code>chmod +x ~/iat.sh</code> </li>
+ <li> In <span class="iat">It's All Text!</span> preferences, use the shell script as your editor. </li>
+ </ol>
+
+ <p>
+ 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>.
+ </p>
+ <pre lang="sh">#!/bin/sh
+# This is an example shell script for It's All Text!
+
+open -a /path/to/editor.app $*</pre>
+
+ <p>
+ Other alternative shell scripts are available at <a href="http://docwhat.gerf.org/2007/03/its_all_text_v06/#comment-2054">here</a>.
+ </p>
+
+
+
+ <h3>FAQ</h3>
+
+ <dl id="faq">
+ <dt>I want to do something more complicated than just running an editor with a file-name.</dt>
+ <dd>
+ <p>In UNIX systems, such as Mac OS X or Linux, you can create a shell script with your commands in it.</p>
+ <p>In windows, you can create a <tt>.cmd</tt> file instead.</p>
+ </dd>
+
+ <dt>I can't find the edit button for (gmail, blogger, etc.)</dt>
+ <dd>
+ <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.
+ </p>
+ <p>
+ Workaround: Turn off the rich text editor, if possible.
+ </p>
+ </dd>
+
+ <dt>I use non-ASCII characters and they turn into blocks or question marks (?).</dt>
+ <dd>
+ <p>
+ 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.
+ </p>
+ <p>
+ 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.
+ </p>
+ </dd>
+ </dl>
+
+ </body>
+</html>
+
+<!-- LocalWords: gmail blogger WordPad UTF html abd fff moz ffa tt dt ver cdf
+-->
+<!-- LocalWords: nteb px iat faq dl cmd
+-->