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

#include '../template.wml'
#include "xml_g_fiction.wml"

<latemp_subject "The Human Hacking Field Guide" />

<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>

<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 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>

<p>
<b>Update:</b> (12 April, 2011) there’s now a new
<a href="#version_2">version 2</a> of the story with some improvements to
the plot and style, and it’s now written using version 5 of DocBook/XML. I’m
planning some smaller future improvements, but it should be OK as it is.
</p>

<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 don’t 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>

<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 Sfotware</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>

<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.
</p>
</li>

<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 elitistic 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. Raymond’s site</a> and if you have
the stomach to tolerate it <a href="http://esr.ibiblio.org/">his “Armed
and Dangerous” blog</a>.
</p>
</li>

</ol>


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

<p>
The stylesheet and images used for 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”. I’m 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>
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.