summaryrefslogtreecommitdiffstats
path: root/guides/shell-workshop
diff options
context:
space:
mode:
Diffstat (limited to 'guides/shell-workshop')
-rwxr-xr-xguides/shell-workshop/index.html81
-rw-r--r--guides/shell-workshop/index.mdwn82
2 files changed, 82 insertions, 81 deletions
diff --git a/guides/shell-workshop/index.html b/guides/shell-workshop/index.html
deleted file mode 100755
index 3b85b6c..0000000
--- a/guides/shell-workshop/index.html
+++ /dev/null
@@ -1,81 +0,0 @@
-<!--#set var="title" value="UNIX Shell Scripting Workshop" -->
-<!--#include virtual="../../includes/header.html" -->
-<h2>UNIX&reg; Shell Scripting Workshop</h2>
-<h3>Introduction to the UNIX Shell Language and Environment</h3>
-<p>
- This is a workshop that I gave at the New Jersey Institute of Technology
- (NJIT) in the Spring of 2012 as part of the workshop series of the
- university's chapter of the Association for Computing Machinery (ACM). It
- was based on a similar tutorial I had given during meetings of NJIT ACM's
- SIG GNU/Linux in the Fall of 2011.
-</p>
-<h4>Flyer</h4>
-<p>
- Below you may find the flyer for this event:
-</p>
-<ul>
- <li><a href="flyer.svg">Source SVG document</a></li>
- <li><a href="flyer.pdf">Rendered PDF document</a></li>
-</ul>
-<p>
- This flyer includes copyrighted images used pursuant to the fair use
- limitation of U.S. Copyright Law.
-</p>
-<h4>Standards</h4>
-<p>
- The workshop referred to the Shell and Utilities (XCU) volume of
- <a href="http://pubs.opengroup.org/onlinepubs/9699919799/">POSIX.1-2008</a>,
- <a href="http://www.unix.org/">published</a> by the IEEE and The Open Group.
- Everything covered applies to any sufficiently-compliant shell and operating
- system.
-</p>
-<h4>Notes</h4>
-<p>
- The following are my notes from the tutorial I gave at SIG GNU/Linux
- meetings, reused for the workshop:
-</p>
-<ul>
- <li><a href="shell.txt">shell.txt</a></li>
- <li><a href="shell-tut.txt">shell-tut.txt</a></li>
-</ul>
-<p>
- The following are the notes I wrote as a guide for the workshop:
-</p>
-<ul>
- <li><a href="notes.txt">notes.txt</a></li>
-</ul>
-<h4>Session</h4>
-<p>
- The following is a cleaned-up version of the shell session from the
- workshop, including all of the commands I ran and scripts I wrote.
-</p>
-<ul>
- <li><a href="session.txt">Plain text (Markdown) document</a></li>
- <li><a href="session.html">HTML document</a></li>
-</ul>
-<h4>Examples</h4>
-<p>
- At the end of the workshop, I showed the following example shell scripts:
-</p>
-<ul>
- <li><a
- href="http://anonscm.debian.org/gitweb/?p=users/clint/debianutils.git;a=blob;f=which;hb=1b1dfee67e9ddd9dfe9171ac347e5000f4deab8a"><code>which</code>
- of debianutils</a>
- (an implementation of
- <a href="https://en.wikipedia.org/wiki/Which_%28Unix%29">a program
- available</a>
- on many UNIX-like operating systems), notable for its use of the internal
- field separator (IFS) to parse the <code>PATH</code> variable</li>
- <li><a href="http://odin1.pehjota.net/git/opkhelper/tree/src/opkbuild.sh"><code>opkbuild</code></a>
- of opkhelper (a set of scripts I wrote)</li>
-</ul>
-<h4>Copyright</h4>
-<p>
- Copyright &copy; 2012 Patrick "P. J." M<span class="super">c</span>Dermott
- <br>
- All works related to this workshop, including this document, the flyer, the
- notes, and the session records may be used under the terms of the
- <a href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
- Attribution 3.0 Unported license</a>.<br>
-</p>
-<!--#include virtual="../../includes/footer.html" -->
diff --git a/guides/shell-workshop/index.mdwn b/guides/shell-workshop/index.mdwn
new file mode 100644
index 0000000..6e4c575
--- /dev/null
+++ b/guides/shell-workshop/index.mdwn
@@ -0,0 +1,82 @@
+<!--#set var="title" value="UNIX® Shell Scripting Workshop" -->
+<!--#include virtual="/includes/header.html" -->
+
+Introduction to the UNIX Shell Language and Environment
+=======================================================
+
+This is a workshop that I gave at the New Jersey Institute of Technology (NJIT)
+in the Spring of 2012 as part of the workshop series of the university's chapter
+of the Association for Computing Machinery (ACM). It was based on a similar
+tutorial I had given during meetings of NJIT ACM's SIG GNU/Linux in the Fall of
+2011.
+
+Flyer
+=====
+
+Below you may find the flyer for this event:
+
+ * [Source SVG document](flyer.svg)
+ * [Rendered PDF document](flyer.pdf)
+
+This flyer includes copyrighted images used pursuant to the fair use limitation
+of U.S. Copyright Law.
+
+Standards
+=========
+
+The workshop referred to the Shell and Utilities (XCU) volume of
+[POSIX.1-2008][posix], [published][unix] by the IEEE and The Open Group.
+Everything covered applies to any sufficiently-compliant shell and operating
+system.
+
+[posix]: http://pubs.opengroup.org/onlinepubs/9699919799/
+[unix]: http://www.unix.org/
+
+Notes
+=====
+
+The following are my notes from the tutorial I gave at SIG GNU/Linux
+meetings, reused for the workshop:
+
+ * [shell.txt](shell.txt)
+ * [shell-tut.txt](shell-tut.txt)
+
+The following are the notes I wrote as a guide for the workshop:
+
+ * [notes.txt](notes.txt)
+
+Session
+=======
+
+The following is a cleaned-up version of the shell session from the
+workshop, including all of the commands I ran and scripts I wrote.
+
+ * [Plain text (Markdown) document](session.txt)
+ * [HTML document](session.html)
+
+Examples
+========
+
+At the end of the workshop, I showed the following example shell scripts:
+
+ * [`which` of debianutils][debianutils-which] (an implementation of [a program
+ available][which] on many UNIX-like operating systems), notable for its use
+ of the internal field separator (IFS) to parse the `PATH` variable
+ * [`opkbuild`][opkbuild] of opkhelper (a set of scripts I wrote)
+
+[debianutils-which]: http://anonscm.debian.org/gitweb/?p=users/clint/debianutils.git;a=blob;f=which;hb=1b1dfee67e9ddd9dfe9171ac347e5000f4deab8a
+[which]: https://en.wikipedia.org/wiki/Which_%28Unix%29
+[opkbuild]: http://odin1.pehjota.net/git/opkhelper/tree/src/opkbuild.sh
+
+Copyright
+=========
+
+Copyright &copy; 2012 Patrick "P. J." M<span class="super">c</span>Dermott
+
+All works related to this workshop, including this document, the flyer, the
+notes, and the session records may be used under the terms of the [Creative
+Commons Attribution 3.0 Unported license][cc-by-3.0].
+
+[cc-by-3.0]: http://creativecommons.org/licenses/by/3.0/
+
+<!--#include virtual="/includes/footer.html" -->