Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 202 lines (191 sloc) 9.758 kb
4523d0d @atombender New readme, split license into separate file.
atombender authored
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <meta http-equiv="Content-Style-Type" content="text/css">
6 <title>Readme</title>
7 <style type="text/css">
8 * {
9 margin: 0;
10 padding: 0;
11 line-height: 100%;
12 font-size: normal;
13 }
14 body {
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
15 margin: 25px 25px;
4523d0d @atombender New readme, split license into separate file.
atombender authored
16 font-family: "Lucida Grande", "Helvetica Neue", "Helvetica", "Arial", sans-serif;
17 font-size: 10pt;
18 }
19 body, p {
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
20 color: #666;
4523d0d @atombender New readme, split license into separate file.
atombender authored
21 }
22 a:link, a:visited, a:active, a:hover {
23 color: #5d90ff;
24 }
25 p, li {
26 line-height: 160%;
27 margin: 10px 0;
28 }
29 h1 {
d4c2e03 @atombender New Readme.
atombender authored
30 color: #222;
31 font-weight: bold;
32 letter-spacing: -1px;
33 font-size: 15pt;
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
34 margin-bottom: 10px;
4523d0d @atombender New readme, split license into separate file.
atombender authored
35 }
36 h2 {
37 color: #444;
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
38 font-size: 11pt;
4523d0d @atombender New readme, split license into separate file.
atombender authored
39 margin-bottom: 10px;
40 margin-top: 20px;
41 }
42 h2 b {
43 }
44 ol.ol1 {list-style-type: decimal}
45 ul.ul1 {list-style-type: disc}
46 ul, ol {
47 margin-left: 35px;
48 }
49 .section {
50 }
51 .section.section2 {
52 margin-top: 15px;
53 padding-top: 15px;
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
54 border-top: solid 1px #ddd;
4523d0d @atombender New readme, split license into separate file.
atombender authored
55 }
56 b.high {
57 color: #333;
58 }
59 .warn {
d4c2e03 @atombender New Readme.
atombender authored
60 color: #c40;
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
61 font-size: 14pt;
62 }
63 .beta_warning {
64 margin-bottom: 30px;
65 border: solid 1px #c40;
66 padding: 5px 15px;
4523d0d @atombender New readme, split license into separate file.
atombender authored
67 }
68 </style>
69 </head>
70 <body>
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
71
72 <div class="section beta_warning">
73 <p>
74 <b class="warn">The current beta version is prelease software. Please back up your preference file (under
75 Library/Application Support/Keywurl) before use. I am not responsible for any
76 data loss incurred by this plugin. Don't blame me if the sky falls on your head.
77 </b>
78 </p>
79 </div>
80
4523d0d @atombender New readme, split license into separate file.
atombender authored
81 <div class="section">
82 <h1>About</h1>
d4c2e03 @atombender New Readme.
atombender authored
83 <p>Keywurl is a small extension for Safari that adds keyword search, similar to Firefox's "Quick Search" functionality. The name is an increasingly unimaginative portmanteau of "keyword" and "URL".</p>
84 </div>
85 <div class="section section2">
86 <h1>Installation</h1>
87 <p>
88 The current beta <strong>does not have an installer</strong>. Apple's installer
89 tool is something I'm not going to fight with right now. So to install:
90 </p>
91 <p>
92 Copy <b><tt>Keywurl.bundle</tt></b> into
93 <b><tt>Library/Application Support/SIMBL/Plugins</tt></b> under your home folder, <em>or</em>
94 in <b><tt>/Library/Application Support/SIMBL/Plugins</tt></b> in the hard drive root if you
95 want Keywurl to be enabled for all users on the computer.
96 </p>
97 <p>
98 <b>Remember to also run the SIMBL installer</b>. If SIMBL does not work properly, try
99 installing it system-wide. Or, if that was what you were doing, try installing it
100 for your user account only.
101 </p>
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
102 </div>
103
104 <div class="section section2">
105 <h1>Uninstalling</h1>
d4c2e03 @atombender New Readme.
atombender authored
106 <p>
107 To uninstall, just delete the file you copied.
108 </p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
109 </div>
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
110
4523d0d @atombender New readme, split license into separate file.
atombender authored
111 <div class="section section2">
112 <h1>Changes</h1>
d4c2e03 @atombender New Readme.
atombender authored
113
35f0f67 @atombender Bump to version 1.4.0 beta 6.
atombender authored
114 <h2><b>1.4 beta 6 </b>(June 12th, 2009)</h2>
115 <p>Updated to Safari 4 final.</p>
116
fd941dc @atombender Updated to 1.4.0 beta 5.
atombender authored
117 <h2><b>1.4 beta 5 </b>(March 16, 2009)</h2>
118 <p>Fixes the <strong>default</strong> keyword to avoid using Safari's fallback
119 for names that are probably not proper domain names. Also fixed the
120 preference bubbles which were accidentally broken in the last release.
121 </p>
122
8d961b3 @atombender Updated Readme file for 1.4.0 beta 4.
atombender authored
123 <h2><b>1.4 beta 4 </b>(March 15, 2009)</h2>
124 <p>Fixes several bugs, the most important
125 one being in handling legitimate addresses typed without the http:// prefix;
126 this restores the way address resolution worked with Safari 3, with the
127 additional benefit that you can now remap hosts as keywords. For example,
128 you can create a keyword named <strong>apple.com</strong> and have it
129 expand to <strong>apple.de</strong>. This release also fixes and improves
130 the right-click-to-create-keyword feature, and fixes the
131 default <strong>default</strong> expansion, which was broken.
d4c2e03 @atombender New Readme.
atombender authored
132 </p>
133
134 <h2><b>1.4 beta 3 </b>(February 25, 2009)</h2>
135 <p>Support for for the new Safari 4 beta. Fixed a bug where keywords would not be
136 saved if you created it with the context menu. Currently Leopard only.</p>
137
138 <h2><b>1.4 beta 2 </b>(Mar 20, 2008)</h2>
139 <p>Safari 3.1 changed some internals that broke how Keywurl handled fallbacks when no
140 "default" keyword has been created; so just typing foo in the address field would
141 not take you to www.foo.com.</p>
142
143 <h2><b>1.4 beta 1 </b>(February 20, 2008)</h2>
144 <p>First beta.</p>
145 <ul class="ul1">
4523d0d @atombender New readme, split license into separate file.
atombender authored
146 <li><b class="high">You can now create a new keyword just by right-clicking on any text field in any web page form, and selecting <i>Create Keyword</i>. </b>Keywurl takes care of the dirty details.</li>
147 <li><b class="high">Nicer substitution syntax.</b> The "@@@" and "$$$" expansion symbols have been replaced with a more human-friendly system that does not rely on magic syntax. Instead, the address field now shows the substitutions using nice, friendly, little blue bubble shapes. Old configuration files are automatically migrated from the old syntax. The available substitutions are shown in a separate box, and you can drag them with the mouse into the address field. Visual editing, yay!</li>
148 <li><b class="high">It is now possible to address each query word separately</b>: In the query "foo bar", "query 1" expands to "foo", "query 2" to "bar", etc. Up to 10 such query terms are supported. For example, this allows you to map a queries such as: <a href="http://quote.fool.com/Chart/chart.asp?time=1dy&amp;symbols=aapl">graph 2yr aapl</a> (stock prices for Apple over two years) or <a href="http://quote.fool.com/Chart/chart.asp?time=1dy&amp;symbols=msft">graph 1dy msft</a> (stock prices for Microsoft for one day).</li>
149 <li>The configuration file is now backed up to a separate file whenever it is saved.</li>
150 <li>The keyword list in the preference dialog is now sorted lexicographically.</li>
151 <li>Some minor bug fixes to the way selection and keyword creation is handled.</li>
152 </ul>
153 <h2><b>1.3.3 </b>(February 18, 2008)</h2>
d4c2e03 @atombender New Readme.
atombender authored
154 <p>Safari 3.1 compatibility.</p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
155 <h2><b>1.3.2 </b>(January 29, 2008)</h2>
156 <ul class="ul1">
157 <li><b class="high">Tiger compatibility</b>.</li>
158 <li>Fixed a crash when exiting the preference pane.</li>
159 <li>Fixed so that Safari's default fallback (eg., going to "foo.com" when you enter just "foo") works if there is no default keyword.</li>
160 </ul>
161 <h2><b>1.3.1 </b>(January 27, 2008)</h2>
d4c2e03 @atombender New Readme.
atombender authored
162 <p>This released was hoped to fix Tiger compatibility. It did not.</p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
163 <h2><b>1.3 </b>(January 24, 2008)</h2>
d4c2e03 @atombender New Readme.
atombender authored
164 <p>This is a minor bug fix release. Thanks to Eli Dourado and Brian de Alwis for ideas and suggestions.</p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
165 <h2><b>1.2 </b>(January 23, 2008)</h2>
166 <ul class="ul1">
167 <li><b class="high">Default keyword</b>.<b> </b>The keyword "default" (if it is defined) is now invoked when no other keyword matches. Google is included as an example. For example, typing "Paris Hilton" in the address bar will now invoke a Google search. Keywurl uses a simple heuristic to determine whether something is a legitimate host name (eg., cnn.com) or something that should be expanded: If what you entered contains only a single word consisting of alphanumeric characters and at least one dot, it's considered a host name and ignored.</li>
168 <li><b class="high">Single-word expansions</b>. You can now create convenience aliases – for example, if you add the keyword "sd" with the expansion "slashdot.org", you can enter just "sd" in the address bar to go there.</li>
169 <li><b class="high">Added per-keyword character encoding setting</b>. Some sites (such as imdb.com and amazon.com) require Latin 1 encoding for URLs. This fixes such sites.</li>
170 <li><b class="high">Added per-keyboard space encoding setting</b>. Some sites require that spaces are encoded as "+" instead of "%20". This fixes such sites.</li>
171 <li><b></b>The configuration file format changes in this version, breaking backwards compatibility. If you want to be able to downgrade, make a backup first.</li>
172 </ul>
173 <h2><b>1.1</b> (November 23, 2007)</h2>
174 <ul class="ul1">
175 <li>Leopard compatibility.</li>
176 </ul>
177 </div>
178 <div class="section section2">
179 <h1>Requirements</h1>
d4c2e03 @atombender New Readme.
atombender authored
180 <p>
181 For Tiger support I recommend the 1.3 series. Unfortunately, I no longer
182 have a machine with Tiger on which to test. For the current versions the following
183 apply:
184 </p>
185 </p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
186 <ul class="ul1">
d4c2e03 @atombender New Readme.
atombender authored
187 <li><b class="high">Mac OS X 10.5 ("Leopard") or later</b>.</li>
4523d0d @atombender New readme, split license into separate file.
atombender authored
188 <li><b class="high">Safari 3.0</b> or later.</li>
189 <li><b class="high">SIMBL</b>, which lets Keywurl be installed into Safari. SIMBL is included in the Keywurl package, and may also be <a href="http://www.culater.net/software/SIMBL/SIMBL.php">downloaded here</a>.</li>
190 </ul>
191 </div>
192 <div class="section section2">
193 <h1>License</h1>
d4c2e03 @atombender New Readme.
atombender authored
194 <p>See the file License.rtf accompanying the installer.</p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
195 </div>
196 <div class="section section2">
197 <h1>Credits</h1>
d4c2e03 @atombender New Readme.
atombender authored
198 <p>The preference code was written based on Jim Fowler's ForgetMeNot plugin, with many thanks.</p>
4523d0d @atombender New readme, split license into separate file.
atombender authored
199 </div>
200 </body>
201 </html>
Something went wrong with that request. Please try again.