Source

shlomi-fish-homepage / t2 / humour / human-hacking / index.html.wml

Full commit
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
#include '../template.wml'
#include "stories/stories-list.wml"
#include "xml_g_fiction.wml"
#include "toc_div.wml"

<latemp_subject "The Human Hacking Field Guide" />
<latemp_meta_desc "The Human Hacking Field Guide - a story about teenagers in 2005 Los Angeles who deal with open source software development." />
<latemp_more_keywords "open, source, open source, free software, foss, floss, hacking, hacker, female geeks, hackers, story, novella, humor, humour, creative commons, cc, female hackers, english, hebrew, los angeles, california" />

<tagline text="Who said girls can’t code?" />

<hhfg_logo />

<p>
Jennifer is a trendy and popular high school senior who is living and
studying in the vicinity of Los Angeles. Her best friend, Taylor, convinces her
to try to become a developer of open source software. He puts her
under the tutorship of a different friend of his, the female open source
contributor Eve, who prefers to be called Erisa, and who is a self-conscious
and rebelling punk, with whom Jennifer finds it hard to deal. Jennifer remains
determined to learn how to become an open source developer from Erisa, but
there are some surprises along the road.
</p>

<define-tag old_desc>
<p>
An unlikely female computer <a
href="http://www.catb.org/~esr/faqs/hacker-howto.html">hacker</a> (=
software enthusiast, not a computer intruder)-wannabe is getting taught by an
even more unlikely female computer hacker. It takes place in Los Angeles,
California and is written in English.
</p>
</define-tag>

<h2 id="text">The Text</h2>

<h3 id="version_2">Version 2 (Most recent)</h3>

<ul>

<li>
<a href="human-hacking-field-guide-v2/"><b>HTML to read online</b></a>
</li>

<li>
<a href="human-hacking-field-guide-v2.xml">DocBook 5/XML source</a>
</li>

<li>
<a href="human-hacking-field-guide-v2.pdf">Adobe PDF</a> (intended as a
self-contained document - please dont print it.).
</li>

</ul>

<h4 id="version_2_hebrew">Hebrew Translation</h4>

<ul>

<li>
<a href="hebrew-v2.html">Translation to Hebrew</a> - by the author.
</li>

<li>
Sources:<br />

<ul>

<li>
<link_to_fiction_text base="human-hacking-field-guide-hebrew-v2" />
</li>

<li>
<a href="human-hacking-field-guide-hebrew-v2.db-postproc.xslt">XSLT
stylesheet</a> to post-process the resultant DocBook 5/XML source.
</li>

</ul>

</li>

</ul>

<h4 id="version_2_arabic">Arabic Translation</h4>

<ul>

<li>
<a href="arabic-v2.html">Translation to Literary Arabic</a> - by Vieq.
</li>

<li>
<a href="hhfg-v2-arabic.odt">OpenDocument Text Source</a>
</li>

</ul>

<toc_div />

<h2 id="source_repo">Source Repository</h2>

<ul>

<li>
<p>
<a href="http://github.com/shlomif/Human-Hacking-Field-Guide">Source Repository on GitHub</a>
</p>
</li>

<li>
<p>
<a href="http://bitbucket.org/shlomif/human-hacking-field-guide-graphics">Graphics Repository on BitBucket.org</a> - contains an ad, etc.
</p>
</li>

</ul>

<define-tag buffy_inspiration>
<li>
<p>
<a href="http://en.wikipedia.org/wiki/Buffy_the_Vampire_Slayer_%28TV_series%29">The <i>Buffy the Vampire Slayer</i> television series</a> - I believe the
characters of Jennifer and Erisa in <i>The Human Hacking Field Guide</i>
were heavily inspired by those of
<a href="http://en.wikipedia.org/wiki/Buffy_Summers">Buffy</a>
and <a href="http://en.wikipedia.org/wiki/Faith_%28Buffy_the_Vampire_Slayer%29">Faith</a> from the television show, respectively.
</p>
</li>
</define-tag>

<h2 id="see_also">See Also</h2>

<ol>

<li>
<p>
<a href="http://teachingopensource.org/index.php/How_to_start_contributing_to_or_using_Open_Source_Software">How
to start contributing to or using Open Source Software</a> -a tutorial by
me and some other people introducing people to the open source world. (Part of
the <a href="http://teachingopensource.org/">Teaching Open Source</a>
initiative).
</p>
</li>

<li>
<p>
<a href="$(ROOT)/humour/Star-Trek/We-the-Living-Dead/">Star Trek:
We, the Living Dead</a> - a screenplay for an original
<i>Star Trek: Deep Space Nine</i> episode, which also predominantly features
software hackerdom and female geeks.
</p>
</li>

<buffy_inspiration />

<li>
<p>
<a href="http://www.catb.org/esr/faqs/hacker-howto.html">How To Become
A Hacker by Eric Steven Raymond</a> - an insightful document, although
somewhat too elitist and patronising, which is featured, and criticised,
in my story, and provided some inspiration for it. There is a lot of
other very good documents on
<a href="http://www.catb.org/esr/">Mr. Raymonds site</a>, and (if you have
the stomach to tolerate it) on <a href="http://esr.ibiblio.org/">his Armed
and Dangerous blog</a>.
</p>
</li>

<li>
<p>
<a href="http://htmldog.com/">HTML Dog: HTML and CSS Tutorials</a> -
some very good HTML and CSS tutorials.
</p>
</li>

<li>
<p>
<a href="$(ROOT)/philosophy/computers/web/create-a-great-personal-homesite/rev2.html">Create
a Great Personal Home Site</a> - my essay about creating a personal web site.
</p>
</li>


<li>
<p>
<a href="http://freenode.net/">Freenode</a> - an IRC network dedicated for
discussing Free and Open Source Software projects, and other collaborative
projects, that is featured in the story. <b>Warning:</b> IRC is addictive.
</p>
</li>

</ol>

<h2 id="sources_of_inspiration">Sources of Inspiration</h2>

<ol>

<buffy_inspiration />

<li>
<p>
<a href="http://en.wikipedia.org/wiki/Friends">The <i>Friend</i>
T.V. Show</a> - I reference their List of 5 celebrities you can sleep with
from <a href="http://www.friends-tv.org/zz305.html">episode 3.05</a>.
</p>
</li>

<li>
<p>
<a href="http://en.wikipedia.org/wiki/I%27m_Not_a_Girl,_Not_Yet_a_Woman">Im
Not a Girl, Not Yet a Woman</a> by
<a href="http://en.wikipedia.org/wiki/Britney_Spears">Britney Spears</a> . (
<a href="http://www.youtube.com/watch?v=IlV7RhT6zHs">YouTube VEVO Video</a> ).
</p>
</li>

<li>
<p>
<a href="https://en.wikipedia.org/wiki/Sabrina,_the_Teenage_Witch_%28TV_series%29"><i>Sabrina, the Teenage Witch</i> (the live action Television series)</a>
</p>
</li>

<li>
<p>
<a href="http://www.paulgraham.com/nerds.html">Why Nerds are Unpopular</a>
by Paul Graham.
</p>
</li>

<li>
<p>
<a href="http://en.wikipedia.org/wiki/Bring_It_On_%28film%29"><i>Bring
it On</i> (the original film)</a>
</p>
</li>

<li>
<p>
<a href="http://en.wikipedia.org/wiki/Atomic_Kitten">Atomic Kitten</a> -
a British Britpop trio, with extremely kitschy songs that I stillhappen to
like
</p>
<ul>

<li>
<p>
<a href="http://en.wikipedia.org/wiki/Whole_Again">Whole Again</a> - my
favourite songs of theirs.
</p>
</li>

</ul>

</li>

<li>
<p>
<a href="$(ROOT)/humour.html#too_girly">Too Girly</a> -
IRC conversation.
</p>
</li>

</ol>

<h2 id="acknowledgements">Acknowledgements</h2>

<p>
The stylesheet and images used for the background of the text are based
on the
<a href="http://www.oswd.org/viewdesign.phtml?id=1959&amp;referer=%2Fsearch.php%3Fsearchstring%3Dtwin%2Btriangles%26tab%3Ddescription">Twin
Triangles</a> style from <a href="http://www.oswd.org/">Open Source Web
Design</a>.
</p>

<p>
Thanks go to Uri Bruck, Gai Borshack, Omer Zak, Drew Dexter and others who
have read and reviewed early, incomplete, drafts of this story.
</p>

<h2 id="conclusions"><a href="conclusions/">Conclusions and Reviews</a></h2>

<p>
Read these only <b>after</b> you have finished reading the story.
</p>

<h2 id="spin-offs">Spin-offs and Derivative Works</h2>

<ul>

<li>
<p>
<a href="http://hhfg.wikia.com/"><b>The <i>Human Hacking Field Guide</i>
Wikia</b></a>
- a community attempt to improve the original story, under the CC-by-sa.
</p>

<p>
For context see
<a href="http://community.livejournal.com/linux/1860210.html">the
discussion</a> when I mentioned the story on the LiveJournal.com Linux
community and <a href="http://community.livejournal.com/linux/1860830.html">the
post</a> about Remixing The Human Hacking Field Guide. Im not sure I liked
the direction this spin-off / remix had initially taken but you may still like
it.
</p>
</li>

<li>
<p>
<a href="#version_2_arabic"><b>Arabic translation</b></a> by Vieq.
</p>
</li>

</ul>

<p>
If you enjoyed the story, but still think you can do better, I would love to
see more spin-offs, from making the story a little different, to writing
sequels, prequels, etc. to video or audio versions of it. If you find
the CC-by-sa too permissive or too restrictive to license the derivative
work under, then <a href="$(ROOT)/me/contact-me/">drop me
a line</a> and we may be able to negotiate a better, commercial, licence.
</p>

<h2 id="old_versions">Old Versions</h2>

<h3 id="version_1">Version 1 (Old)</h3>

<ul>
<li>
<a href="human-hacking-field-guide/">HTML to read online</a>
</li>
<li>
<a href="human-hacking-field-guide.xml">DocBook/XML source</a>
</li>
</ul>

<h2 id="licensing">Licensing</h2>

<p>
The story (a <a href="http://en.wikipedia.org/wiki/Novella">novella</a>)
is original and complete, and is made available, along with its
source code, under
<a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">the Creative
Commons Attribution ShareAlike License (Unported)</a>, either version 3.0,
or at your option, any later version. Share, build upon, even sell,
and Enjoy! (As long as you keep the derivatives under the same licence.)
</p>

<h2 id="ads">Ads</h2>

<table class="visible">
<tr>
<th>Image</th>
<th>Description</th>
</tr>

<tr>

<td> ;;; start image

<a href="images/hhfg-ad-468x60.svg.png"><img
    src="images/hhfg-ad-468x60.svg.preview.png" alt="banner ad for HHFG" /></a>

</td> ;;; end image

<td> ;;; start description

<p>
Banner (468 * 60 pixels) ad reading The Human Hacking Field Guide ;
Who said girls cant code? with &lt;h1&gt; and &lt;/h1&gt; logos.
</p>

<ul>

<li>
<p>
<a href="http://bitbucket.org/shlomif/human-hacking-field-guide-graphics">Source</a> - in the <tt>hhfg-ad-horiz-468x60.svg</tt> file.
</p>
</li>

</ul>

</td> ;;; end description

</tr>


<tr>

<td> ;;; start image

<a href="images/hhfg-ad.svg.png"><img
src="images/hhfg-ad.svg.png" alt="skyscraper ad for HHFG" /></a>

</td> ;;; end image

<td> ;;; start description

<p>
Skyscraper (160 * 600 pixels) ad reading The Human Hacking Field Guide ;
Who said girls cant code? with &lt;h1&gt; and &lt;/h1&gt; logos.
</p>

<ul>

<li>
<p>
<a href="http://bitbucket.org/shlomif/human-hacking-field-guide-graphics">Source</a> - in the <tt>hhfg-ad.svg</tt> file.
</p>
</li>

</ul>

</td> ;;; end description

</tr>


</table>