Anonymous avatar Anonymous committed 7e45271

Importing the current source from my home repository into the perl-begin
repository.

Comments (0)

Files changed (39)

+-DROOT~src
+
+TARGET = dest
+
+# PAGES = about articles/index books/index core-doc/index index irc/index mailing-lists/index links/index site-resources/index tutorials/index web-forums/index
+
+# SUBDIRS = articles books core-doc irc links mailing-lists tutorials site-resources source source/arcs web-forums
+
+include defs.mak
+
+
+SOURCES = $(addprefix src/,$(addsuffix .html.wml,$(PAGES)))
+
+DESTS = $(patsubst src/%.html.wml,$(TARGET)/%.html,$(SOURCES))
+
+RAW_FILES = style.css
+RAW_FILES_SOURCES = $(addprefix src/,$(RAW_FILES))
+RAW_FILES_DEST = $(addprefix $(TARGET)/,$(RAW_FILES))
+
+PODS = $(addprefix docs/,roadmap spec whitepaper version-0.2-spec)
+PODS_DESTS_HTMLS = $(patsubst %,$(TARGET)/%.html,$(PODS))
+PODS_DESTS_PODS = $(patsubst %,$(TARGET)/%.pod,$(PODS))
+
+# PACKAGES_DIR = $(TARGET)/download/arcs
+# PACKAGES = $(shell cd temp && cd lk-module-compiler-final && ls)
+# PACKAGES_DESTS = $(addprefix $(PACKAGES_DIR)/,$(PACKAGES))
+
+SUBDIRS_DEST = $(addprefix $(TARGET)/,$(SUBDIRS))
+
+WML_FLAGS += --passoption=2,-X --passoption=7,"-S imgsize" -DROOT~.
+
+RSYNC = rsync --progress --verbose --rsh=ssh 
+
+ARC_NAME := $(shell cd temp && ./get-arc-name.sh)
+
+DEST_ARC_PAGE = $(TARGET)/source/index.html
+
+all: dest $(SUBDIRS_DEST) $(DESTS) $(RAW_FILES_DEST)
+
+dest:
+	if [ ! -e $@ ] ; then mkdir $@ ; fi
+	
+$(DESTS) :: $(TARGET)/% : src/%.wml template.wml
+	(cd src && wml $(WML_FLAGS) -DFILENAME=$(patsubst src/%.wml,%,$<) $(patsubst src/%,%,$<)) > $@
+
+$(RAW_FILES_DEST) :: $(TARGET)/% : src/%
+	cp -f $< $@
+
+$(SUBDIRS_DEST) :: % : unchanged
+	if [ ! -e $@ ] ; then mkdir $@ ; fi
+
+$(PODS_DESTS) :: $(TARGET)/% : src/%
+	cp -f $< $@
+
+$(PODS_DESTS_HTMLS) :: $(TARGET)/%.html : src/%.pod
+	pod2html $< > $@
+
+# $(PACKAGES_DESTS) :: $(PACKAGES_DIR)/% : ./temp/lk-module-compiler-final/%
+# 	cp -f $< $@
+
+upload: upload_berlios
+
+upload_berlios: all
+	(cd dest && $(RSYNC) -r * shlomif@shell.berlios.de:/home/groups/perl-begin/htdocs/)
+
+upload_iglu: all
+	(cd dest && $(RSYNC) -r * shlomif@iglu.org.il:/iglu/html/shlomif/Perl-Begin/)
+
+DEST_ARC_NAME = $(TARGET)/source/arcs/$(ARC_NAME)
+
+.PHONY: 
+
+$(DEST_ARC_PAGE) :: $(TARGET)/% : src/%.wml template.wml .PHONY
+	(cd src && wml $(WML_FLAGS) -DARCNAME=$(ARC_NAME) -DFILENAME=$(patsubst src/%.wml,%,$<) $(patsubst src/%,%,$<)) > $@
+
+arc: $(DEST_ARC_NAME) $(DEST_ARC_PAGE)
+
+$(DEST_ARC_NAME):
+	(cd temp && ./make-archive.sh)
+	mv temp/$(ARC_NAME) $@
+
+upload_arc: arc
+	$(RSYNC) $(ARC_NAME) shlomif@shell.berlios.de:
+
+Before running make for the first time, one has to run "bash gen_helper.sh".
+This script generates the list of directories and pages inside defs.mak.
+
+This script also has to be invoked whenever new pages are added, or existing 
+ones are removed or renamed.
+
+Enjoy!
+
+    Shlomi Fish
+* Add the other books sections in separate pages.
+
+* Add the Uses (with CGI, Sys Admin, etc. underneath) section
+
+#!/bin/bash
+list_wmls()
+{
+    find ./src/ -name '*.html.wml' | 
+        sed 's!^\./src/!!' | 
+        sed 's!\.html\.wml$!!' | 
+        grep -v '^source/index$' |
+        sort
+}
+
+get_subdirs()
+{
+    grep '/' | 
+        sed 's!/[^/]*$!!' |
+        sort |
+        uniq |
+        sort
+}
+
+add_extra()
+{
+    cat ;
+    echo "source"
+    echo "source/arcs"
+}
+
+(echo "PAGES = $(list_wmls | xargs)" ;
+echo
+echo "SUBDIRS = $(list_wmls | get_subdirs | add_extra | xargs)"
+echo ) > defs.mak
+
+    

src/about.html.wml

+#include '../template.wml'
+
+<subject "Perl Beginners' Site - About" />
+
+<h2>About</h2>
+
+<p>
+Welcome to the unofficial Perl Beginners' Site. This site will provide
+links and references to on-line and off-line material that can be used
+to learn Perl. This site is directed both for people who learn Perl 
+after knowing one or more languages, or for people who are learning
+Perl as their first language.
+</p>
+

src/articles/index.html.wml

+#include '../template.wml'
+
+<subject "Collection of Articles" />
+
+<h2>External Collections of Articles</h2>
+
+<p>
+<a href="http://www.stonehenge.com/merlyn/columns.html">Randal L. Schwartz' Newspaper Columns</a> - a collection of articles by Randal L. Schwartz.
+</p>
+
+<p>
+<a href="http://perl.plover.com/">Mark Jason Dominus' Perl Paraphernalia</a> -
+many articles, some of them quite high-level.
+</p>
+
+<p>
+<a href="http://www.perl.com/">www.perl.com</a> - articles on Perl that are 
+on advanced or out-of-core topics, but mostly suitable for beginners.
+</p>
+
+<p>
+<a href="http://www.perladvent.org/">The Perl Advent Calendar</a> - An online 
+calendar that contains articles about Perl.
+</p>
+
+<p>
+<a href="http://www.theperlreview.com/">The Perl Review</a> - An online 
+journal with articles about Perl.
+</p>
+
+<p>
+<a href="http://articles.mongueurs.net/magazines/">Articles by the French Perl Mongers</a> -
+a collection of articles in French, that the French Perl Mongers are writing for the French
+Linux magazine.
+</p>
+
+

src/books/index.html.wml

+#include '../template.wml'
+
+<subject "Paper Books" />
+
+<define-tag get:ext:publisher whitespace="delete">
+<ifeq "%0" "oreilly" "<a href="http://www.oreilly.com/">O'Reilly and Associates</a>" />
+<ifeq "%0" "manning" "<a href="http://www.manning.com/">Manning Publications Co.</a>" />
+<ifeq "%0" "new-riders" "<a href="http://www.newrider.com/">New Riders</a>" />
+</define-tag>
+
+<define-tag book:store>
+<preserve isbn />
+<preserve store />
+<preserve title />
+<set-var %attributes />
+<ifeq "<get-var store />" "ukamazon" 
+    "<set-var ucstore="Amazon UK" />"
+    "<set-var ucstore="<:{print ucfirst("<get-var store />")}:>" />"
+    />
+<a href="http://learn.perl.org/redirect?url=book;bookstore=<get-var store />;bookisbn=<get-var isbn />"><get-var title /></a>
+<restore title />
+<restore store />
+<restore isbn />
+</define-tag>
+
+<define-tag book:info>
+<preserve authors />
+<preserve publisher />
+<preserve isbn />
+<set-var %attributes />
+<set-var ext:publisher=<get:ext:publisher <get-var publisher /> /> />
+<div class="bookinfo">
+<h3>Book Information</h3>
+<b>Authors:</b> <get-var authors /><br />
+<b>Publisher:</b> <get-var ext:publisher /><br />
+<b>Buy From:</b> 
+<book:store isbn="<get-var isbn />" store="amazon" title="Amazon" /> - 
+<book:store isbn="<get-var isbn />" store="powells" title="Powells" /> - 
+<book:store isbn="<get-var isbn />" store="amazonuk" title="Amazon UK" />
+<br />
+</div>
+<restore isbn />
+<restore publisher />
+<restore authors />
+</define-tag>
+
+<h2>Note</h2>
+
+<p>
+It is not absolutely necessary to read an organized book to learn Perl. But 
+occassionally many people like it better than reading an ad-hoc tutorial
+on their computer screeens, and then trying to understand the man pages. Here 
+is a list of books that can teach you Perl with some remarks on each book.
+</p>
+
+<h2><a href="http://www.oreilly.com/catalog/lperl3/">Learning Perl</a></h2>
+
+<book:info 
+    authors="Randal L. Schwartz and Tom Phoenix" 
+    publisher="oreilly" 
+    isbn="0596001320" 
+    />
+
+<p>
+Also referred to as "the Llama Book". Considered
+one of the best books for people who are absolute beginners in Perl and even
+in programming in general.
+</p>
+
+<p>
+Available online electronically for a registration as part of 
+<a href="http://safari.oreilly.com/">O'Reilly's Safari</a>.
+</p>
+
+<define-tag beginning:perl:url whitespace="delete">
+http://learn.perl.org/library/beginning_perl/
+</define-tag>
+
+<h2><a href="<beginning:perl:url />">Beginning Perl</a></h2>
+
+<book:info
+    authors="Simon Cozens"
+    publisher="Wrox Press Inc."
+    isbn="1861003145"
+    />
+
+<p>
+This book is intended for people who are new to programming and wish to learn
+programming with Perl. Those that already have a past experience in 
+programming, will find it easier, but, otherwise even those without
+will be able to learn through it.
+</p>
+
+<p>
+This book is <a href="<beginning:perl:url />">available 
+online for free download</a>.
+</p>
+
+<h2><a href="http://www.manning.com/Johnson/">Elements of Programming with Perl</a></h2>
+
+<book:info 
+    authors="Andrew L. Johnson" 
+    publisher="manning" 
+    isbn="1884777805"
+    />
+
+<p>
+A book that teaches Perl for people who have no programming experience. Takes
+an unusual approach of introducing them to Literate Programming as well,
+and using it for creating documentation and better organizing the examples.
+</p>
+
+<h2><a href="http://www.amazon.com/exec/obidos/tg/detail/-/073571228X/qid=1042963777/sr=8-2/ref=sr_8_2/104-8970354-3083156?v=glance&amp;s=books&amp;n=507846">Perl for C Programmers</a></h2>
+
+<book:info
+    authors="Steve Oualline"
+    publisher="new-riders"
+    isbn="073571228X"
+    />
+
+<p>
+This book teaches Perl for experienced C Programmers. It is comperehensive
+and encompassing and tries to focus on Perl code that resembles C as much as 
+possible. If you don't know C either, it will probably be of little help.
+</p>
+

src/contribute/index.html.wml

+#include '../template.wml'
+
+<subject "Contribute to the Perl Beginners' Site" />
+
+<p>
+    We feel that the Perl Beginners' Site should be a community site
+    instead of a centralized "Cathedral"-like site. Thus, the entire source
+    code is available online and contributions from outsiders are welcome.
+    There is a <a href="./list/">list of contributors</a>, so make sure
+    your name appears there as soon as possible.
+</p>
+
+<p>
+    Here are ways in which you can contribute to the site:
+</p>
+
+<h2>Contribute to the Wiki</h2>
+
+<p>
+<a href="<wiki:link />">The Wiki</a> is a portion of the site that can
+be edited by anyone at any time. Feel free to add your own material there.
+</p>
+
+<h2>Join the Mailing List</h2>
+
+<p>
+By joining <a href="<mailing:list:link />">the mailing list</a>, you will 
+receive questions by E-mail, which you can answer. (or alternatively be able
+to ask your own)
+</p>
+
+<h2>Visit the Help Web Forum</h2>
+
+<p>
+The <a href="<web:forum:link />">Help Web Forum</a> is meant to help people
+with their Perl problems. You can visit it if you have questions or would like
+to help people with their problems.
+</p>
+
+<h2>Contribute to the Core Site</h2>
+
+<p>
+You can send patches or corrections to the HTML pages of the site. It is 
+preferable to send corrections to the <a href="$(ROOT)/source/">site's Web 
+Meta Language source</a>, because they can be applied immediately.
+</p>
+

src/contribute/list/index.html.wml

+#include '../template.wml'
+
+<subject "Contributors List" />
+
+<dl>
+<dt>
+<a href="http://t2.technion.ac.il/~shlomif/">Shlomi Fish</a>
+</dt>
+<dd>
+Founded perl-begin and did most of the work on the initial versions.
+</dd>
+<dt>
+<a href="http://www.cthulhu-burger.org/">Dave Goehrig</a>
+</dt>
+<dd>
+Contributed the essay "What the Books Don't Teach You" to the Wiki.
+</dd>
+<dt>
+Marilyn Matty
+</dt>
+<dd>
+Gave some web design and content tips.
+</dd>
+<dt>
+Mark Fowler
+</dt>
+<dd>
+Suggested two important additions to the articles section.
+</dd>
+</dl>
+
+

src/conventions.html.wml

+#include '../template.wml'
+
+<subject "Coding Conventions" />
+
+<ul>
+<li>
+The packages that can be used to compile and install kernel modules and
+entire packages can assume that a GNU system is present. Namely that 
+GNU make, GNU install, gawk, gcc, etc. are present and at the appropriate
+places. It cannot assume that Perl is installed though.
+</li>
+<li>
+The CLAN code and the Module packager will be written in pure Perl 5, and
+can depend on whatever publicly available CPAN modules that are known to 
+be portable and common enough. Eventually, a CPAN bundle will be prepared
+to install everything including CLAN.
+</li>
+<li>
+Generally, maintaining a simple CLAN module will be possible without too deep a
+knowledge of Perl, but such knowledge may prove useful for advanced use.
+</li>
+<li>
+I'll try to avoid using Autoconf and friends for the modules for as long as 
+I can. If we assume a GNU system, we can make a lot of simplifying assumptions.
+</li>
+<li>
+Packages can be prepared along with a list of patches. They can be defined
+inside the package or the package can be built while specifying them.
+</li>
+<li>
+A kernel module package will contain an RPM Spec, Debianization file and other
+native distribution packaging systems.
+</li>
+<li>
+There should be planning but no over-engineering. I believe we can build
+the functionality incrementally without re-writing the entire code from scratch
+at a certain point. 
+</li>
+</ul>

src/core-doc/index.html.wml

+#include '../template.wml'
+
+<subject "Perl Core Documentation" />
+
+<h2>Online Documentation</h2>
+
+<p>
+<a href="http://www.perldoc.com/">Perl-Doc</a> - contains searchable index
+for the core perl documentation. 
+</p>
+
+<p>
+<a href="http://www.mongueurs.net/perlfr/perl.html">French version of the Perl
+Manual</a> - a bit out-of-date, but still very pertinent for beginners.
+</p>
+
+
+<h2>Books</h2>
+
+<h3><a href="http://www.oreilly.com/catalog/pperl3/">Programming Perl, 3rd 
+Edition</a></h3>
+
+<p>
+The Bible of Perl. Makes an easier and more organized read than the online
+core documentation, and provides explanation for every last nuance of the 
+Perl language. Also contains a lot of jokes and Perl musings, and an 
+introduction to the culture behind Perl.
+</p>
+
+<p>
+Not recommended as an introducory Perl book, but still makes a very good read 
+after the language is learned to a working extent.
+</p>
+
+<h3><a href="http://www.oreilly.com/catalog/cookbook/">The Perl Cookbook</a></h3>
+
+<p>
+A book that contains a long list of code snippets for achieving certain tasks 
+in Perl, with some discussion on how they work and how to customize them.
+</p>

src/download/index.html.wml

+#include '../template.wml'
+
+<subject "CLAN Code Downloads" />
+
+<h2 class="plain"><a href="./arcs">For Downloads Check here</a></h2>
+
+<h2>LKMB - The Linux Kernel Module Builder</h2>
+
+<p>
+Grab its latest version as it is the most complete. Currently it is a Perl 
+Package that creates a bootstrap package for a Linux module. It is still 
+very incomplete, but partially usable.
+</p>
+
+<h2>Putting the code on CPAN</h2>
+
+<p>
+Eventually, everything is going to be on 
+<a href="http://www.cpan.org/">CPAN</a>, but meanwhile I don't feel it'
+s quite usable to put it there yet.
+</p>
+
+

src/future.html.wml

+#include '../template.wml'
+
+<subject "The Future Vision" />
+
+<p>
+After CLAN is installed on the system it compiles a basic kernel that 
+fullfills all of the system requirements. These may be found out using a 
+hardware manager (such as MandrakeSoft's hard-drake) or explicitly. It then 
+compiles a basic kernel and installs it. This requires a reboot.
+</p>
+
+<p>
+Afterwards, whenever the user needs a new module, he invokes CLAN (something 
+like ``clan -e shell'') and installs this module by downloading it, 
+verifying it for cryptographic validity (if necessary), compiling it 
+and installing it.
+</p>
+
+
+<p>
+That's not all. If CLAN detects that the current kernel does not 
+support this module it will accept the admin explicit or implicit 
+permission to recompile the kernel with this option added, and 
+install the new kernel as well.
+</p>
+
+
+<p>
+CLAN will require no bootstrapping. It would be able to prepare 
+standalone source kernel packages that can be compiled without 
+CLAN installed.
+</p>
+
+<p>
+And like I said earlier, installing a module will install all 
+of its dependencies as well.
+</p>
+
+
+<p>
+CLAN will support multiple sources for modules (controlled by editing a 
+text file), and will be able to handle source packages, binary packages 
+and restrict each one to various architectures (i386, SPARC, Alpha, ARM) 
+and sub- architectures (i386, i486, i586, i686).
+</p>
+
+<p>
+Some sources of CLAN will be able to carry non-GPL-compliant code and 
+so the free software ideals will not be violated anywhere.
+</p>
+
+<p>
+I hope that CLAN will be able to play nice with the underlying 
+package systems. I.e: build modules and kernels as RPMs on RPM based 
+systems , as deb packages on Debian and derived systems, etc.
+</p>
+
+<p>
+CLAN will interact and play nice with system loaders such as LILO, GRUB and
+loadlin. Generally it will not install a new kernel unless explicitly 
+instructed to
+</p>
+
+<p>
+All the kernel modules and subsystems will be available as CLAN packages and
+can be upgraded, configured and installed at home from a convenient CPAN or
+Apt like interface.
+</p>
+

src/index.html.wml

+#include '../template.wml'
+
+<subject "Perl Beginners' Site" />
+
+<h2>About</h2>
+
+<p>
+Welcome to the unofficial Perl Beginners' Site. This site will provide
+links and references to on-line and off-line material that can be used
+to learn Perl. This site is intended for people who learn Perl 
+after knowing one or more languages, as well as for people who are learning
+Perl as their first language.
+</p>
+
+<h2>What is Perl?</h2>
+
+<p>
+<a href="http://www.perl.org/">Perl</a> is a flexible, feature-rich and
+powerful high-level language. It is many times referred to as a "scripting
+language" albeit this term is very misleading because it can be efficiently
+used for many other tasks besides scripting. It is in fact possible to write
+numercial applications, GUIs, graphics generation, database applications, WWW
+and network scripts, games, and even servers in Perl. And naturally, anything
+that combines two or more of these things. ;-) 
+</p>
+
+<p>
+Perl code can be written very quickly, and although not run as fast as the
+most optimized C code, will still usually be fast enough. It is very usual
+to achieve in one line of Perl what in ANSI C and many other languages 
+requires 100's of lines.
+</p>
+
+<p>
+Perl has a lot of easily installable ready made modules in 
+<a href="http://www.cpan.org/">CPAN</a> (the Comprehensive Perl Archive 
+Network), which make writing Perl code to achieve many tasks even easier.
+</p>
+

src/irc/index.html.wml

+#include '../template.wml'
+
+<subject "IRC Channels for Perl Q&amp;A" />
+
+<h2>What is the IRC?</h2>
+
+<p>
+IRC stands for Internet Relay Chat, and it is a distributed, real-time form
+of communication, that was common from relatively early in the history of
+the Internet and is still very popular. IRC servers form a network of servers,
+and each network is separated from the other networks. This allows chat-rooms
+(called channels in IRC-jargon) with same name to exist in different networks.
+</p>
+
+<p>
+Some popular IRC clients include the cross-platform 
+<a href="http://www.mozilla.org/projects/rt-messaging/chatzilla/">Chatzilla</a> 
+(which is part of <a href="http://www.mozilla.org/">the Mozilla project</a>), 
+the Windows-based <a href="http://www.mirc.com/">mIRC</a> and 
+<a href="http://www.xchat.org/">XChat</a>, an IRC client for all UNIX 
+systems including Linux and Mac OS X. By downloading either one, you can log 
+in to an IRC network and start chatting. 
+</p>
+
+<p>
+IRC is a great way to get answers to questions quickly and easily. Just note 
+that the channel <tt>#perl</tt> on some of the networks is not dedicated for
+newbie questions, and you should use a different channel instead. Consult this
+page for more details.
+</p>
+
+<h2><a href="http://www.efnet.org/">EF-Net</a></h2>
+
+<p>
+Check the channels <tt>#perlhelp</tt> (but not <tt>#perl</tt> which is
+intended for advanced discussion), and <tt>#html</tt>.
+</p>
+
+<h2><a href="http://freenode.net/">FreeNode (previously OpenProjects.net)</a></h2>
+
+<p>
+Check the channels <tt>#perl</tt>, <tt>#mandrake</tt> and <tt>#modperl</tt>.
+</p>
+
+<h2><a href="http://www.ircnet.org/">IRCnet</a></h2>
+
+<p>
+Try the channel <tt>#perl</tt>.
+</p>
+
+<h2><a href="http://www.oftc.net/">OFTC</a></h2>
+
+<p>
+The channel <tt>#perl</tt> accepts beginner questions.
+</p>
+
+<h2><a href="http://www.undernet.org/">Undernet</a></h2>
+
+<p>
+Check the channels <tt>#perl</tt> (not for CGI questions), and <tt>#cgi</tt>.
+</p>
+
+<h2>TODO</h2>
+
+<p>
+Add DAL-net and other networks that are fit for the purpose.
+</p>
+
+
+
+

src/links.html.wml

+#include '../template.wml'
+
+<subject "CLAN Links" />
+
+<h2>Documents</h2>
+
+<p>
+<a href="http://www.cpan.org/misc/ZCAN.html">The Zen of Comprehensive Archive
+Networks</a> - a document by Jarkko Hietaniemi, the CPAN master librarian
+on how to construct such comprehensive archive networks like we intend do.
+Brings some lessons from CPAN, and indicates why it has been successful.
+</p>
+
+<p>
+<a href="http://www.joelonsoftware.com/articles/fog0000000043.html">The Joel 
+Test : 12 Steps to Better Code</a> - an insightful article (orignallly
+derived from the McConnell Test) giving some guidelines for useful management
+of a "shrinkwrap" project. CLAN aims for just that.
+</p>
+
+<h2>Reference Projects</h2>
+
+<p>
+<a href="http://oprofile.sourceforge.net./">OProfile</a> - a system-wide
+profiler for GNU/Linux that contains an externally maintained kernel module.
+Provided reference for writing the appropriate makefile for the LKMB packages.
+</p>
+
+<h2>Similar Efforts for Other Systems</h2>
+
+<p>
+<a href="http://www.cpan.org/">CPAN - The Comperhensive Perl 
+Archive Network</a> - a repository of useful modules for the Perl programming
+language, that can be installed at ease while resolving all depenedencies. CLAN
+,in fact, will be available as a set of CPAN packages.
+</p>
+
+<p>
+<a href="http://www.debian.org/distrib/packages">The Debian Package Pool</a> -
+a comprehensive repository of packages for the Debian GNU/Linux distribution 
+that are maintained by volunteers. Easily installable and upgradable using
+a utility named "apt".
+</p>
+
+<p>
+<a href="http://www.linux-mandrake.com/cooker/urpmi.html">urpmi</a> - an
+interface around RPM created by MandrakeSoft to resolve the unique problems
+faced in handling the RPM package format. Extensively used in a Mandrake Linux
+environment and very convenient as well for maintaing the packages.
+</p>
+
+<p>
+<a href="http://www.freebsd.org/">FreeBSD</a> - its packages management is 
+source based and very configurable (you can specify configuration options for
+packages at compile time). Also look for 
+<a href="http://www.gentoo.org/">Gentoo Linux</a> which implemented a similar
+functionatily for a GNU/Linux system.
+</p>
+

src/links/index.html.wml

+#include '../template.wml'
+
+<subject "Links" />
+
+<h2>Main Perl Resources</h2>
+
+<p>
+<a href="http://www.perl.com/">Perl.com</a> - O'Reilly's Perl Portal
+with many interesting articles, some sections and links.
+</p>
+
+<p>
+<a href="http://use.perl.org/">use Perl;</a> - a news site dedicated to Perl
+, Slashdot-style. (but with much fewer comment and such of higher 
+signal-to-noise ratio). Visit it to keep up to date with what's going on in
+Perl.
+</p>
+
+<p>
+<a href="http://www.perl.org/">Perl.org</a> - a Perl portal by the Perl Mongers
+Organization and the Perl Foundation.
+</p>
+
+<p>
+<a href="http://www.pm.org/">Perl Mongers</a> - The "Perl Mongers" Perl 
+user-groups world-wide.
+</p>
+
+<p>
+<a href="http://www.cpan.org/">CPAN - The Comprehensive Perl 
+Archive Network</a> - Contains a lot of modules for doing practically
+anything with Perl. Why re-invent the wheel when so many different types
+of them are available for free. Note that Perl distributions on various 
+systems contains an easy to use interface to install modules from it, 
+including dependencies.
+</p>
+
+<h2>Perl Culture</h2>
+
+<p>
+<a href="http://directory.google.com/Top/Computers/Programming/Languages/Perl/Poetry/">Perl Poetry</a> - 
+Poems that are valid Perl programs.
+</p>
+
+<p>
+<a href="http://perlgolf.sourceforge.net/">Perl Golf</a> - competitions to
+find out the shortest Perl programs to achieve a certain task. Looking at
+the winning entries and analyzing them can actually teach you a lot about
+built-in Perl features. (some of them relatively obscure).
+</p>
+
+<p>
+<a href="http://perl.plover.com/qotw/">The Perl Quiz of the Week</a> - 
+a quiz to write a Perl program by Mark Jason Dominus.
+</p>
+
+<h2>Prominent Perl People</h2>
+
+<p>
+<a href="http://www.wall.org/~larry/">Larry Wall</a> - the father of Perl. A
+very colourful, amusing and interesting guy, who is also a competent UNIX
+hacker (invented patch, rn and other utilities), and a linguist by training.
+</p>
+
+<p>
+<a href="http://www.perl.com/pub/au/Christiansen_Tom">Tom Christiansen</a> -
+Perl's No. 2. Authored Several books and has been hacking with Perl and on Perl
+since its early beginning. 
+</p>
+
+<p>
+<a href="http://perl.plover.com/">Mark Jason Dominus</a> - Runs a web-site
+that contains a lot of random information and code about Perl.
+</p>
+
+<p>
+<a href="http://www.csse.monash.edu.au/~damian/">Damian Conway</a> - a computer
+science academic, who is obsessed with Perl. Wrote a book and some modules 
+(including one to write Perl in Latin - ;-)), and is considered one of the
+primary experts on Object-Oriented Programming in Perl. Now co-heads the Perl 6
+effort.
+</p>
+
+<p>
+<a href="http://www.stonehenge.com/merlyn/">Randal L. Schwartz</a> - co-authored
+some of Perl's most important books and one of the top experts on Perl on the
+planet.
+</p>
+
+<p>
+<a href="http://www.hut.fi/~jhi/">Jarkko Hietaniemi</a> - the 
+<a href="http://www.cpan.org/">CPAN</a> master librarian, a contributor to
+the core Perl distribution and external modules, and an all-around nice guy.
+</p>
+
+<h2>More Links</h2>
+
+<h3><a href="http://directory.google.com/Top/Computers/Programming/Languages/Perl/">The Google Directory Perl Category</a></h3>
+
+<p>
+a comprehensive hierarchy of links.
+</p>
+
+<h3><a href="http://dmoz.org/Computers/Programming/Languages/Perl/">DMoz' Perl Category</a></h3>
+
+<p>
+The source of the above, which is more up-to-date, but is slower and does not
+include Googlisms.
+</p>
+
+<h3><a href="http://dir.yahoo.com/Computers_and_Internet/Programming_and_Development/Languages/Perl/">Yahoo's Perl Category</a></h3>
+
+

src/lkmb/index.html

+#include '../template.wml'
+
+<subject "CLAN - Documents" />
+
+<define-tag pod:doc endtag="required">
+<preserve url />
+<preserve title />
+<set-var %attributes />
+<h3><a href="<get-var url />.html"><get-var title /></a></h3>
+
+%body
+
+<div class="indent">
+<a href="<get-var url />.pod">(Perl POD Source)</a>
+</div>
+<restore title />
+<restore url />
+</define-tag>
+
+<pod:doc url="whitepaper" title="Whitepaper">
+<p>
+A whitepaper describing the motivation and capabilities of CLAN. 
+</p>
+</pod:doc>
+
+<pod:doc url="spec" title="Functional SPEC">
+<p>
+A functional SPEC of the complete system.
+</p>
+
+</pod:doc>
+
+<pod:doc url="roadmap" title="Roadmap">
+
+<p>
+A roadmap for the CLAN code.
+</p>
+
+</pod:doc>
+
+<h2>Versions SPECs</h2>
+
+<div align="indent">
+These are specs of the various versions.
+</div>
+
+<pod:doc url="version-0.2-spec" title="Version 0.2.x">
+</pod:doc>

src/lkmb/index.html.wml

+#include '../template.wml'
+
+<subject "LKMB - The Linux Kernel Module Builder" />
+
+<h2>About</h2>
+<p>
+The Linux Kernel Module Builder (or LKMB) for short is a kernel module
+that can be used to build self-contained packages that can be processed
+into kernel modules packages. By installing the Perl module system-wide,
+it relieves such duplicate functionality, that is needed to maintain
+such packages and allows for fast processing and analyzing of them.
+</p>
+
+<p>
+LKMB can be downloaded from the <a href="$(ROOT)/download/">downloads 
+section</a>, and expect it to be on CPAN soon.
+</p>
+
+<h2>Features</h2>
+
+<p>
+Currently, one can build a kernel module package that can be compiled against
+the current kernel. Most of the other functionality needs to be implemented.
+</p>
+

src/mailing-lists/index.html.wml

+#include '../template.wml'
+
+<subject "Mailing Lists" />
+
+<h2>Overview</h2>
+
+<p> 
+Generally, your local Perl Mongers mailing list is considered a good place
+to ask <b>any</b> perl questions including beginners one. Refer to the <a
+href="http://www.pm.org/">Perl Mongers International homepage</a> for <a
+href="http://www.pm.org/groups/">a list of them</a>. If you can't find one in
+your area, then any PM list you join will be OK, as its members will accept you
+there. Perl Mongers are united world-wide in their love for Perl and their
+burning desire to get more people to know it and use it as well.
+</p>
+
+<h2>Resources of Interest</h2>
+
+<h3><a href="http://lists.cpan.org/">The Perl Mailing List Database</a></h3>
+
+<p>
+A comprehensive list of the Perl mailing lists worldwide. Some of them are
+for specific Perl technologies and not directly related to core or general use
+Perl functionality.
+</p>
+
+<h3><a href="http://dir.groups.yahoo.com/dir/Computers___Internet/Programming_Languages/Perl?show_groups=1">Yahoo Groups Perl Lists</a></h3>
+
+<p>
+Many international Perl groups on many topics. Including some on very 
+specific Perl technologies.
+</p>
+
+<h2>Perl Beginners Mailing Lists</h2>
+
+<h3><a href="http://learn.perl.org/">learn.perl.org's Mailing Lists</a></h3>
+
+<p>
+Some mailing lists for beginners, generally with a high or very high volume.
+</p>
+
+<h3><a href="https://lists.berlios.de/mailman/listinfo/perl-begin-help">Our Own Mailing List</a></h3>
+
+<h3><a href="http://groups.yahoo.com/group/perl-beginner/">Yahoo Groups Perl-Beginner Mailing List</a></h3>
+
+<p>
+An international mailing list for beginners in English.
+</p>
+
+
+<h3><a href="http://tlali.iztacala.unam.mx/mailman/listinfo/perl">Spanish-Speaking Mailing List</a></h3>
+
+<p>
+This mailing list has many beginners and several gurus that can help them. It accepts 
+beginners' questions, but every now and then there are higher level talks. (which beginners
+may be able to benefit from). Its Lingua Franca is Spanish.
+</p>
+
+
+<h3>Insert your Mailing List Here</h3>
+
+<p>
+Do you have a Perl mailing list for beginners? If not, do you wish to 
+start one? Let us know and we'll link to it from here. The more the better.
+</p>
+

src/platforms/index.html.wml

+#include '../template.wml'
+
+<subject "Perl Platforms" />
+
+<p>
+perl 5 (the most common implementation of the Perl language) was made very 
+portable and can run on almost any platform imaginable. (here's 
+<a href="http://www.perldoc.com/perl5.8.0/pod/perlport.html#Supported-Platforms">an exhaustive list</a>). Perl, however, started on UNIX platforms and still
+reflects the UNIX culture to a large extent.
+</p>
+
+<h2><a href="./mac/">Mac OS (PowerPC, etc.)</a></h2>
+
+<p>
+    Mac OS X, being mostly compatible with UNIX can, easily run Perl 5, as 
+    compiled and installed from the source. Mac OS Classic requires MacPerl,
+    which I never worked with. Mac OS X is still highly recommended from the
+    aspect of running Perl or otherwise.    
+</p>
+
+<h2><a href="./windows/">Windows</a></h2>
+
+<p>
+    Perl can easily run on Windows and makes for a very powerful and free
+    scripting language there. Complete Beginners should probably start
+    by downloading an ActiveState's <a href="http://www.activestate.com/Products/ActivePerl/">ActivePerl</a> build and experimenting with it.
+</p>
+
+<p>
+    Perl for Windows 32, is mostly compatible with Perl for UNIX, so scripts
+    and modules written on one platform will run on the other.
+</p>
+

src/platforms/mac/index.html.wml

+#include '../template.wml'
+
+<subject "Perl on Mac OS" />
+
+<p>
+    Mac OS X, being mostly compatible with UNIX can, easily run Perl 5, as 
+    compiled and installed from the source. Mac OS Classic requires MacPerl,
+    which I never worked with. Mac OS X is still highly recommended from the
+    aspect of running Perl or otherwise.    
+</p>

src/platforms/unix/index.html.wml

+#include '../template.wml'
+
+<subject "Perl on UNIX and Linux Systems" />
+
+<p>
+    If you are using a UNIX-compatible system (such as Linux or Solaris), most chances
+    are that Perl 5 is already installed there. To verify that, type <tt>perl -v</tt>
+    inside a command shell, and check that the version of Perl is recent enough. If so, you 
+    can easily run Perl scripts there.
+</p>
+
+<p>
+    Even if this is not the case, you can usually install it from the distribution you
+    are using, assuming you are an administrator of the system. Else, given enough quota it 
+    is possible to install the most recent version of Perl 5 under your home directory. 
+    This procedure can be followed by downloading the latest Perl source from CPAN, and 
+    following the instructions in the INSTALL file.
+</p>
+

src/platforms/windows/index.html.wml

+#include '../template.wml'
+
+<subject "Perl on Win32" />
+
+<p>
+    Perl can easily run on Windows and makes for a very powerful and free
+    scripting language there. Complete Beginners should probably start
+    by downloading an ActiveState's <a href="http://www.activestate.com/Products/ActivePerl/">ActivePerl</a> build and experimenting with it.
+</p>
+
+<p>
+    Perl code can be written to run perfectly on both Windows and UNIXes, out
+    of the box. Most Perl code written by people who know what they are doing
+    will be such, and this is the case for most CPAN Perl modules as well.
+</p>
+
+<h2>Resources</h2>
+
+<h3>Mailing Lists</h3>
+
+<p>
+    ActiveState has <a
+    href="http://lists.perl.org/showlist.cgi?name=perl-win32-users">a mailing
+    list for Win32 users</a>. Generally, Perl for Win32 questions can be
+    effectively answered in beginners mailing lists as well, but this mailing
+    list may also prove of help especially in regards to Win32-specific Perl
+    extensions.
+</p>
+

src/site-resources/index.html.wml

+#include '../template.wml'
+
+<subject "Site Resources" />
+
+<h2><a href="https://lists.berlios.de/mailman/listinfo/perl-begin-help">Mailing List</a></h2>
+
+<p>
+Ask questions and receive answers by E-mail. Very convenient and instructive.
+One can find other mailing lists in our 
+<a href="$(ROOT)/mailing-lists/">mailing lists</a> section.
+</p>
+
+<h2><a href="<site:link url="cgi-bin/chiq_chaq/chiq.pl" />">Wiki</a></h2>
+
+<p>
+This is a portion of the site in which anyone can edit any page. It aims
+to eventually become a good reference for Perl beginners.
+</p>
+
+<h2><a href="http://developer.berlios.de/forum/forum.php?forum_id=2341">Web Forum</a></h2>
+
+<p>
+A place to put messages on the web and check them. Note that I'm not entirely
+happy with its implementation and am working on a new forum framework that 
+emulates the <a href="http://www.joelonsoftware.com/">Joel on Software</a> 
+forums. (I will gladly send you the code or accept contributions)
+</p>
+
+

src/source/index.html.wml

+#include '../template.wml'
+
+<subject "Site's Source Code" />
+
+<p>
+This site is a static HTML site written in
+<a href="http://thewml.org/">Web Meta Language</a>. Its self-contained
+source code (that requires WML, GNU make, GNU basha nd a GNU
+system to be built) can be found on this page.
+</p>
+
+<h2><a href="./arcs/$(ARCNAME)">Get the Latest Source Code</a></h2>
+
+
+body { font-family : sans-serif }
+a:hover, img.highlight:hover { background-color : lightgreen }
+td.navbar 
+{ 
+    background-color: #E6FAE6;
+    width : 20% ; 
+    border-color : black;
+    border-width : thick;
+    border-style : double;
+}
+
+h2 
+{ 
+    font-family : serif ;
+    border-style : solid ; 
+    border-width : thin;
+    background-color : #ccddff;
+    padding-left: 0.2em;
+}
+
+td.navbar h2 { color: black ; border : none ; font-size : large ; margin-left : 0.5em ; background-color : transparent }
+p.desc { margin-left : 3em }
+ul.navbarmain { padding-left : 1em ; margin-left : 1em ; font-size : 90%}
+ul.navbarnested { padding-left : 0em ; margin-left : 2em }
+h3.newsitem { text-indent: 3em }
+p.newsitem { margin-left : 6em }
+div.indent { margin-left : 3em }
+p.indent { margin-left : 3em  }
+div.rightalign { text-align : right }
+/*
+    Make sure the links inside the navigation bar are highlited
+    with a different colour. That's CSS 2.
+    http://www.zvon.org/xxl/CSS2Tutorial/Examples/example3.html
+*/
+td.navbar a:hover { background-color : orange }
+td.main { padding-left : 1em ; margin-left : 1em }
+h1 { font-family : serif }
+h2.plain{ color : black ; border : none ; font-family : serif }
+
+h3
+{
+    font-family : serif;
+}
+    
+/* Make sure it is not underlined when inside a boxed heading */
+h2 a,h3 a
+{
+    text-decoration : none
+}
+
+h1 a, h2 a, h3 a 
+{
+    font-family : sans-serif;
+}
+
+h3
+{ 
+    border-style : solid ; 
+    border-width : thin;
+    background-color : lemonchiffon;
+    padding-left: 0.3em;
+}
+
+div.bookinfo h3
+{
+    border : none;
+    margin-top : 0em;
+    color : green;
+    padding-left : 0em;
+    background-color : transparent;
+}
+
+div.bookinfo 
+{ 
+    border-style : dotted;
+    border-width : thin;
+    background-color : lightyellow;
+    margin-left : 1em;
+    padding-left : 1em;
+}
+tt { color : #8A2BE2 /* The BlueViolet Color */ }

src/tutorials/index.html.wml

+#include '../template.wml'
+
+<subject "Online Tutorials" />
+
+<h2>Note</h2>
+
+<p>
+The definitive sources for Perl are the <a href="http://www.perldoc.com/perl5.8.0/pod.html">online "man pages"</a> that come with
+the distribution and the book 
+<a href="http://www.oreilly.com/catalog/pperl3/">"Programming Perl"</a> by 
+<a href="http://www.oreilly.com/">O'Reilly and Associates</a>.
+However, none of them is suitable for beginners for various reasons. These
+online tutorials can provide an introduction to Perl so you can start writing
+your own scripts. Nevertheless, they don't teach everything there is
+to know about the language and one should still go over the man pages
+afterwards
+</p>
+
+<h2><a href="http://vipe.technion.ac.il/~shlomif/lecture/Perl/Newbies/">Haifux'
+Perl for Perl Newbies Series</a></h2>
+
+<p>
+Intended for People with basic knowledge of C or something similar or even no 
+knowledge of any programming language at all. Contains verbose slides filled
+with explanation, examples and anecdotes. Covers a basic subset of Perl, 
+without too many "other ways to do it". (you are still expected to read the
+man pages after the second lecture)
+</p>
+
+<h2><a href="http://www.ebb.org/PickingUpPerl/">Picking Up Perl</a></h2>
+
+<p>
+A comprehensive tutorial by <a href="http://www.ebb.org/">Bradley M. Kuhn</a> 
+and others. Does not cover modules and objects, but should get you started
+on simple scripts.
+</p>
+
+<h2><a href="http://archive.ncsa.uiuc.edu/General/Training/PerlIntro/">Perl Intro from NCSA</a></h2>
+
+<p>
+Another tutorial which simplifies things considerably. Leaves out many caveats
+and simply wishes to get you started. Does not cover modules and objects.
+</p>
+
+<h2><a href="http://www.perl.com/pub/a/2001/01/begperl6.html">Perl.com's 
+Beginners Introduction to Perl</a></h2>
+
+<p>
+A 6-part tutorial that covers the basics without too many details. Again, 
+reading the man pages is expected afterwards, but this tutorial should get
+you started.
+</p>
+
+<h2><a href="http://lea-linux.org/dev/perl.php3">French Intro to Perl</a></h2>
+
+<p>
+An introduction to Perl in the French language.
+</p>
+
+<h2><a href="http://cs.haifa.ac.il/~shlomo/perl/">Haifa University Perl Course</a></h2>
+
+<p>
+A perl course with online slides.
+</p>
+
+<h2><a href="http://dmoz.org/Computers/Programming/Languages/Perl/FAQs,_Help,_and_Tutorials/">Dmoz Category</a></h2>
+
+<p>
+Links to many other online tutorials.
+</p>
+
+
+
+

src/uses/bio-info/index.html.wml

+#include '../template.wml'
+
+<subject "Perl for Bio-Informatics" />
+
+<h2>To be filled in.</h2>

src/uses/index.html.wml

+#include '../template.wml'
+
+<subject "Common Uses for Perl" />
+
+<p>
+Perl can be used and was utilized for a variety of uses. This section will
+cover some of the more common uses and explain how to get started with
+using Perl for them.
+</p>
+
+<h2><a href="./bio-info/">Bio-Informatics</a></h2>
+
+<h2><a href="./qa/">Quality Assurance (QA) and Testing</a></h2>
+
+<h2><a href="./sys-admin/">System Administration</a></h2>
+
+<h2><a href="./web/">Web and CGI Programming</a></h2>

src/uses/qa/index.html.wml

+#include '../template.wml'
+
+<subject "Perl for Quality Assurance and Testing" />
+
+<h2>To be filled in.</h2>

src/uses/sys-admin/index.html.wml

+#include '../template.wml'
+
+<subject "Perl for System Administration" />
+
+<p>
+Perl can be used to perform or automate system administration tasks
+on all platforms on which it is available. Some UNIX beginners who learn
+Perl, use it at first where shell scripts may be more appropriate. This use
+is still OK, because Perl can be a good alterantive for them.
+</p>
+
+<p>
+Besides the core language, those who wish to use Perl for System Administration
+should focus on the <tt>perlfunc</tt> document (which covers the various
+functions available inside Perl), and on its regular expressions capabilities
+(which are handier than what shell scripts offer).
+</p>
+

src/uses/web/index.html.wml

+#include '../template.wml'
+
+<subject "Perl for CGI and Web Programming" />
+
+<p>
+Perl 5 was one of the first available technologies for automating a web-server,
+and is still considered one of the most powerful and most cost-effective 
+ones, today. Once you learn the core language, and some HTML and HTTP concepts, 
+programming a simple CGI callback or form handler is very easy and
+straightforward. 
+</p>
+
+<p>
+Users are recommended to use the excellent <a href="http://stein.cshl.org/WWW/software/CGI/">CGI.pm</a> module (which is included in every Perl 5 
+distribution), or one of the other interfaces to the web-server (like 
+HTML::Mason or Apache::ASP). Furthermore, there are many CPAN modules 
+available that can make many common CGI programming tasks much easier.
+</p>
+
+<h2>Interfaces</h2>
+
+<h3><a href="http://www.apache-asp.org/">Apache::ASP</a></h3>
+
+<p>
+An implementation of the Active Server Pages for Perl on UNIXes. Compatible
+with the Perl ASP on Microsoft's IIS server, and so provides a cross-platform
+solution. 
+</p>
+
+<h3><a href="http://www.masonhq.com/">HTML::Mason</a></h3>
+
+<p>
+A portable solution for a dynamic maintenance of a Perl site. Very powerful
+and feature-rich.
+</p>
+
+<h2>Tutorials</h2>
+
+<h3><a href="http://www.cgi101.com/class/">CGI Programming 101</a></h3>
+
+<p>
+A free online course about CGI in Perl.
+</p>
+
+<h3><a href="<wiki:link url="CGI_Getting_Started" />">Our own CGI Getting Started</a></h3>
+
+<p>
+In the Wiki.
+</p>
+

src/web-forums/index.html.wml

+#include '../template.wml'
+
+<subject "Web Forums" />
+
+<h2><a href="http://www.perlmonks.org/">Perl Monks</a></h2>
+
+<p>
+The premiere web forum for Perl people. In English, and offers
+many interesting categories. Complete archive of all past discussions
+is available.
+</p>
+
+<h2><a href="http://www.programmersheaven.com/c/MsgBoard/wwwboard.asp?Board=464">Perl for Newbies Messageboard</a></h2>
+
+<h2>Localized Forums</h2>
+
+<h3><a href="http://www.whatsup.org.il/modules.php?op=modload&name=Forum&file=viewforum&forum=19&52">Whatsup's Hebrew Perl Forum</a></h3>
+
+<p>
+A forum in Hebrew hosted on the <a href="http://www.whatsup.org.il/">Whatsup.org.il Israeli Linux Portal</a>.
+</p>

temp/get-arc-name.sh

+#!/bin/bash
+if [ ! -e last_date ] ; then
+    echo "$(date +%Y-%m-%d)" > last_date
+    echo -n 0 > rev
+fi
+echo "Perl-Beginners-Site-$(cat last_date)-rev$(cat rev).tar.gz"
+

temp/make-archive.sh

+#!/bin/bash
+rm -fr Beginners
+svn export http://localhost:8080/svn/repos/Docs/Perl/sites/Beginners/
+date="$(date +%Y-%m-%d)"
+test -e last_date && old_date="$(cat last_date)"
+test -e rev && rev="$(cat rev)"
+dir_name="Perl-Beginners-Site-$date"
+mv Beginners "$dir_name"
+if [ "$date" == "$old_date" ] ; then
+    let rev++;
+else
+    rev=1
+fi
+echo "$date" > last_date
+echo "$rev"  > rev
+arc_name=$(./get-arc-name.sh)
+tar -czvf "$arc_name" "$dir_name"
+rm -fr "$dir_name"
+# #use wml::des::navbar
+
+<define-tag email:link>
+<a href="mailto:%0">%0</a>
+</define-tag>
+
+# The Definition of the page itself
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
+<head>
+<title>{#SUBJECT_LOC#}</title>
+<link rel="stylesheet" href="$(ROOT)/style.css" type="text/css" />
+</head>
+<body>
+
+<define-tag rellink whitespace="delete">
+<preserve url />
+<set-var %attributes />
+$(ROOT)/<get-var url />
+<restore url />
+</define-tag>
+
+<define-tag site:link whitespace="delete">
+<preserve url />
+<set-var %attributes />
+http://perl-begin.berlios.de/<get-var url />
+<restore url />
+</define-tag>
+
+
+<define-tag navbarlink whitespace="delete">
+<preserve title />
+<set-var %attributes />
+<set-var l="<rellink url="%0" />" />
+<set-var t="<if "<get-var title />" <attributes-quote title=<get-var title /> /> "" />" />
+<if
+    ;;; Determine if %0 matches this document
+    <ifeq "$(FILENAME)" "%0"
+        "1"
+        <ifeq "$(FILENAME)" "%0index.html"
+            "1"
+            <ifeq "$(FILENAME)" "%0/index.html" 
+                "1"
+                ""
+                />
+        />
+
+    />
+    ;;; If so - bolds the text
+    "<b>%1</b>"
+    ;;; If not - makes a hyperlink
+    "<a href="<get-var l />" <get-var t />>%1</a>"
+/>
+<restore title />
+</define-tag>
+
+
+<define-tag vipe:url>http://vipe.technion.ac.il/~shlomif/%0</define-tag>
+<define-tag lect:link><navbarlink "lecture/%0" "%1" host="vipe" /></define-tag>
+
+<define-tag links:group endtag="required">
+<ul class="navbarmain">
+%body
+</ul>
+</define-tag>
+
+<define-tag wiki:link whitespace="delete">
+<preserve url />
+<set-var %attributes />
+<ifeq "<get-var url />" "" 
+    "" 
+    "<set-var url="?<get-var url />" />" 
+    />
+<site:link url="cgi-bin/chiq_chaq/chiq.pl" /><get-var url />
+<restore url />
+</define-tag>
+
+<define-tag mailing:list:link whitespace="delete">
+https://lists.berlios.de/mailman/listinfo/perl-begin-help
+</define-tag>
+
+<define-tag web:forum:link whitespace="delete">
+http://developer.berlios.de/forum/forum.php?forum_id=2341
+</define-tag>
+
+<define-tag nothing></define-tag>
+
+<define-tag navbar:head>
+<preserve href />
+<preserve title />
+<preserve hint />
+<set-var %attributes />
+<set-var title:attr="<if "<get-var hint />" <attributes-quote title=<get-var hint /> /> <nothing /> />" />
+<h2><a href="<get-var href />" <get-var title:attr />><get-var title /></a></h2>
+<restore hint />
+<restore title />
+<restore href />
+</define-tag>
+
+<table summary="Layout Table: The first cell contains a navigation bar, the second the main page" border="0" width="99%">
+<tr>
+<td valign="top" class="navbar" style="width:20%">
+
+<links:group>
+<li><navbarlink "" "Home" /></li>
+<li><navbarlink "about.html" "About" /></li>
+<li><navbarlink "tutorials/" "Online Tutorials" /></li>
+<li><navbarlink "books/" "Books" /></li>
+<li><navbarlink "core-doc/" "Core Documentation" /></li>
+<li><navbarlink "articles/" "Article Collections" /></li>
+</links:group>
+<links:group>
+<li><navbarlink "mailing-lists/" "Mailing Lists" title="Ask Questions and Receive Answers about Perl by E-mail" /></li>
+<li><navbarlink "web-forums/" "Web Forums" /></li>
+<li><navbarlink "irc/" "IRC Channels" title="Chat online about Perl using the Internet Relay Chat (=IRC)" /></li>
+</links:group>
+<links:group>
+<li><navbarlink "links/" "Links" /></li>
+</links:group>
+
+<navbar:head href="$(ROOT)/site-resources/" title="Site Resources" />
+
+<ul class="navbarmain">
+<li><a href="<mailing:list:link />" title="A mailing list for helping Beginners">Mailing List</a></li>
+<li><a href="<wiki:link />" title="A sub-site that can be freely edited with any information">Wiki</a></li>
+<li><a href="<web:forum:link />" title="A web-based forum where you can post messages.">Web Forum</a></li>
+</ul>
+
+<navbar:head href="$(ROOT)/platforms/" title="Platforms" />
+
+<ul class="navbarmain">
+<li><a href="$(ROOT)/platforms/mac/" title="Macintosh and PowerPC/PowerMac platforms">Mac OS</a></li>
+<li><a href="$(ROOT)/platforms/unix/">UNIX/Linux</a></li>
+<li><a href="$(ROOT)/platforms/windows/">Windows</a></li>
+</ul>
+
+<define-tag uses:link>
+<preserve href />
+<preserve caption />
+<preserve title />
+<preserve hide />
+<set-var %attributes />
+<set-var t="<if "<get-var title />" <attributes-quote title=<get-var title /> /> "" />" />
+<if "<ifeq "<get-var hide />" "1" "<match "$(FILENAME)" "^uses/" action="report" />" "1" />"
+    "<li><navbarlink "<get-var href />" "<get-var caption />" <get-var t /> /></li>"
+    ""
+    />
+<restore hide />
+<restore title />
+<restore caption />
+<restore href />
+</define-tag>
+
+<navbar:head href="$(ROOT)/uses/" title="Uses" hint="Common Uses for Perl" />
+<links:group>
+<uses:link href="uses/bio-info/" title="Perl for Bio-Informatics" caption="Bio-Informatics" hide="1" />
+<uses:link href="uses/qa/" title="Perl for Testing and Quality Assurance" caption="QA and Testing" hide="1" />
+<uses:link href="uses/sys-admin/" title="System Administration" caption="Sys Admin" />
+<uses:link href="uses/web/" title="Perl for the Web (CGI, etc.)" caption="Web/CGI" />
+</links:group>
+
+
+<navbar:head href="$(ROOT)/contribute/" title="Contribute" />
+<links:group>
+<li><navbarlink "source/" "Site's Source Code" /></li>
+</links:group>
+
+
+<define-tag validhtml>
+<br /><br /><br /><br />
+<p>
+<a href="http://validator.w3.org/check/referer"><img 
+    style="border:0" src="http://www.w3.org/Icons/valid-xhtml10" 
+         alt="Valid XHTML 1.0!"
+         /></a>
+</p>
+<p>
+ <a href="http://jigsaw.w3.org/css-validator/"><img style="border:0"
+       src="http://jigsaw.w3.org/css-validator/images/vcss" 
+       alt="Valid CSS!" /></a>
+</p>
+<p>
+</p>
+</define-tag>
+
+<ifeq "$(FILENAME)" "index.html" "<validhtml />" "" />
+
+</td>
+<td valign="top" class="main">
+<h1>{#SUBJECT_LOC#}</h1>
+{#BODY#}
+
+</td>
+</tr>
+</table>
+<hr />
+<p>
+<b>Webmaster:</b> <a href="mailto:shlomif@vipe.technion.ac.il">Shlomi Fish - shlomif@vipe.technion.ac.il</a>
+</p>
+
+</body>
+</html>
+
+<define-tag subject>
+{#SUBJECT_LOC#:%0:##}
+</define-tag>
+
+
+#   per default we are in body
+{#BODY#:
+

Empty file added.

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.