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" >
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; }
14 tt, code { font-size: 1.1em; font-weight: bold; color: #048; }
15 dt { font-weight: bold; color: #048; }
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; }
21 .iat { font-style: oblique; color: #024; }
22 .warn { background: #fdd; }
24 pre { background: #def; color: black; margin: 1em; padding: 0 1em; }
26 #faq dl { margin-left: 1em; }
27 #faq dd { font-size: 0.8em; }
31 <h1>Welcome to <span class="iat">It's All Text!</span></h1>
32 <p id="ver"> version 0.7.3</p>
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!
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.
49 Upon installation, go to the menu <tt>Tools -> It's All Text!
50 -> Preferences</tt> to set your preferences. Specifically,
51 you'll have to set the editor's full path.
55 There are three ways to use <span class="iat">It's All Text!</span>:
58 <li>Right click on a textarea, select <tt>It's All Text!</tt>.
60 <li>Click on the edit buttons added for your convenience.
62 <li>Right click on the edit buttons for more options.
67 Here is a test edit box for you to play with…
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>
73 <div id="nteb">Note the edit button.—> </div>
76 <div style="clear:both;"/>
77 <p id="signoff"> Ciao! </p>
80 <h3>A note to Mac OS X users</h3>
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.
86 If this behavior is fine for you, then leave the editor option alone and enjoy!
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.
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.
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.
98 Otherwise, you need to create a shell script. Here are the basic steps to create a shell script:
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>
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>.
112 <pre lang="sh">#!/bin/sh
113 # This is an example shell script for It's All Text!
115 open -a /path/to/editor.app $*</pre>
118 Other alternative shell scripts are available at <a href="http://docwhat.gerf.org/2007/03/its_all_text_v06/#comment-2054">here</a>.
126 <dt>I want to do something more complicated than just running an editor with a file-name.</dt>
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>
132 <dt>I can't find the edit button for (gmail, blogger, etc.)</dt>
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.
137 Workaround: Turn off the rich text editor, if possible.
141 <dt>I use non-ASCII characters and they turn into blocks or question marks (?).</dt>
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.
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.
155 <!-- LocalWords: gmail blogger WordPad UTF html abd fff moz ffa tt dt ver cdf
157 <!-- LocalWords: nteb px iat faq dl cmd