[Perl-org-patches] [PATCH] Add a Tutorials Page - Resend - Inline

[Shlomi Fish]

Hi Matt!

See below for my response and the new patch:

On Monday 28 Sep 2009 18:32:18 Matt S Trout wrote:
> On Wed, Sep 23, 2009 at 12:01:40PM +0300, Shlomi Fish wrote:
> > Hi all!
> >
> > What this untested patch does is add the http://perl-begin.org/tutorial=
s/
> > page from perl-begin.org to http://learn.perl.org/tutorials/ . There are
> > more pages on perl-begin in that section, and they were not added yet. =
We
> > should also consider putting some comprehensive free-as-in-speech
> > tutorials on learn.perl.org as is the case on http://perl-begin.org/ to
> > preserve the look , feel and common navigation and avoid some
> > over-zealous firewalls.
> >
> > Furthermore, I think we should have a side bar on the left or the right
> > in addition to, or instead of the top navigation bar, which can hold ve=
ry
> > few links. See http://perl-begin.org/ for an example.
> >
> > Included is the inline patch. I hope my mailer did not mangle it.
> >
> > Regards,
> >
> >         Shlomi Fish
> >
> >
> > Index: learn/tpl/defaults
> > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> > --- learn/tpl/defaults	(revision 1470)
> > +++ learn/tpl/defaults	(working copy)
> > @@ -7,6 +7,7 @@
> >  page.sidebar =3D BLOCK; -%]
> >  <a href=3D"/">Home</a> |
> >  <a href=3D"/faq/">FAQ</a> |
> > +<a href=3D"tutorials/">Tutorials</a> |
> =

> Shouldn't this be /tutorials/ for consistency?
> =


Fixed.

> >  <!-- <a href=3D"/tips/">Tips</A> | -->
> >  <a href=3D"/library/">Online Library</A>
> >  [%- END -%]
> > Index: learn/tutorials/index.html
> > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> > --- learn/tutorials/index.html	(revision 0)
> > +++ learn/tutorials/index.html	(revision 0)
> > @@ -0,0 +1,150 @@
> > +[%
> > +page.title =3D "Perl Tutorials";
> > +page.banner =3D "Perl Tutorials";
> > +%]
> > +
> > +<h2 id=3D"note">Note</h2>
> > +
> > +<p>
> > +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 ta=
ke
> > care to learn all other +things on his own from other resources.
> > +</p>
> > +
> > +<p>
> > +If you prefer a tutorial in something else besides English, check the
> > +<a href=3D"./localized/">foreign languages page</a>
> > +</p>
> > +
> > +<h2 id=3D"our_list">Our List of Tutorials</h2>
> =

> Why the id tags on EVERYTHING?

id=3D"" are attributes - not tags. But as for your question, I've become us=
ed to =

assigning a meaningful id=3D"" attribute to every header so it can be serve=
d as =

an anchor to it. Another advantage is that it allows to construct a navigat=
ion =

menu to the page based on the <h2 id=3D"..."> <h3 id=3D"..."> <h4 id=3D"...=
"> =

hierarchy. And finally I have this jQuery script:

<<<<<<<<<
$("h1[id],h2[id],h3[id],h4[id],h5[id],h6[id]").each(function(i){ =

$(this).append( ' <span class=3D"selfl">[<a href=3D"#' + this.id + =

'">link</a>]</span>' ) })
>>>>>>>>>

(see: http://perl-begin.org/js/selfl.js )

> =

> > +<h3 id=3D"perl_for_newbies"><a href=3D"perl-for-newbies/">Perl for Perl
> > +Newbies Series</a></h3>
> =

> Broken link. And assuming this one is yours perhaps it should be further
>  down the list on the perl.org form?
> =


The reason it is the first here - http://perl-begin.org/tutorials/ - is =

because Adam Kennedy complained that by pressing the links to the tutorials =

from there, we ended up at sites with a different look and feel, and ones =

which were possibly blocked by web filters. So I decided to re-use my =

tutorial, which is mine and under the Public Domain and so I was able to pu=
t =

it there and integrate it with the site's look and feel. I don't know if an=
y =

of the other tutorials are free-as-in-freedom enough, but if you know of so=
me =

that are, I'll be happy to put them there too.

In any case, regarding the broken link I can either link to its location on =

perl-begin.org:

http://perl-begin.org/tutorials/perl-for-newbies/

Or I can have another patch mirroring it there, but it will be huge, and I'=
ll =

have to compress it and upload it to my server.

> > +<h3 id=3D"perl5_wiki"><a
> > href=3D"http://www.perlfoundation.org/perl5/index.cgi?recommended_onlin=
e_tu
> >torials">A +List of Recommended Online Tutorials</a></h3>
> > +
> > +<p>
> > +An authoritative list of recommended tutorials.
> > +</p>
> =

> It's on a wiki. How the fuck is it authoritative?
> =

> Also it's the shit ugly annoying TPF wiki most people try and avoid.
> =

> If that information isn't anywhere else a cleaned version of it should be
> maintained in perl.org svn with a link back to the wiki page for freshnes=
s.
> =


Removed, thanks.

> > +<h3 id=3D"haifau_perl_course"><a
> > href=3D"http://mila.cs.technion.ac.il/~yona/perl/">Haifa University Perl
> > Course</a></h3>
> > +
> > +<p>
> > +A perl course with online slides.
> > +</p>
> > +
> > +<h3 id=3D"picking_up_perl"><a
> > href=3D"http://www.ebb.org/PickingUpPerl/">Picking Up Perl</a></h3>
> > +
> > +<p>
> > +A comprehensive tutorial by <a href=3D"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>
> >
> >From 2001 and incomplete.
> =

> Do we really need multiple ancient tutorials?

The HaifaU tutorial is not ancient. I removed "Picking Up Perl" (and will a=
lso =

from perl-begin.org).

> =

> > +<h3 id=3D"lpw-perl-beginners"><a
> > +href=3D"http://www.slideshare.net/davorg/lpw-begin">LPW: Beginners Per=
l by
> > Dave +Cross</a></h3>
> > +
> > +<p>
> > +Presentation slides by Dave Cross.
> > +</p>
> =

> What's the point of just slides when there are actual tuts too?
> =


The slides are useful for an introduction too, I think.

> > +<h2 id=3D"advanced">Tutorials for Advanced Users</h2>
> > +
> > +<p>
> > +We don't know of any tutorials for advanced users in English, but
> > +<a href=3D"$(ROOT)/books/#with_prev_knowledge">there are some books ju=
st
> =

> This looks like a mistake?
> =


Hmmm... this is part of the perl-begin.org page. I removed it now.


> > +for that</a>, some of which are freely available online.
> > +</p>
> > +
> > +<h2 id=3D"other_lists">Other Lists</h2>
> =

> Lists of lists?
> =

> Pick half a dozen good ones, put them here, link to the TPF wiki version
> and the perlmonks one.
> =

> > +<h3 id=3D"dmoz_category"><a
> > href=3D"http://dmoz.org/Computers/Programming/Languages/Perl/FAQs,_Help=
,_an
> >d_Tutorials/">Dmoz Category</a></h3>
> > +
> > +<p>
> > +Links to many other online tutorials.
> > +</p>
> =

> Most of which are crap. Why are we even linking to this?
> =


Removed.

> > +<h3 id=3D"perl_com"><a
> > href=3D"http://www.perl.com/cs/user/query/q/6?id_topic=3D74">Perl.com's
> > +List of Perl Tutorials</a></h3>
> =

> Why link to this -and- a specific perl.com article?
> =


Removed.

> > +<h2 id=3D"attribution">Attribution</h2>
> > +
> > +<p>
> > +Based on <a href=3D"http://perl-begin.org/tutorials/">Perl-Begin.org's
> > +    tutorials page</a>.
> > +</p>
> =

> No. We can discuss a contributors page or something later but there's no
> justification for an "attribution" on a list of links like this.

I was just complying with the CC-by 2.0-or-later licence of =

http://perl-begin.org/tutorials/ :

http://creativecommons.org/licenses/by/2.0/

There were other contributors to this page besides just me.

The up-to-date-patch is attached - thanks!

Regards,

	Shlomi Fish

-- =

-----------------------------------------------------------------
Shlomi Fish       http://www.shlomifish.org/
Parody on "The Fountainhead" - http://shlom.in/towtf

Chuck Norris read the entire English Wikipedia in 24 hours. Twice.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: learn.perl.org-add-tutorials-r2.patch
Type: text/x-patch
Size: 4186 bytes
Desc: not available
Url : http://lists.scsys.co.uk/pipermail/perl-org-patches/attachments/20091=
001/385ec73a/learn.perl.org-add-tutorials-r2.bin