NAME
Task::Sites::ShlomiFish - Specifications for modules needed for building www.shlomifish.org , whose sources are publically available, and which serves as examples for several technologies.
DESCRIPTION
Shlomi Fish maintains a homesite at http://www.shlomifish.org/. Installing this task from CPAN will install all of the CPAN modules that are required to build it.
The sources of this web-site are available in a public version control repository with detailed building instructions:
http://www.shlomifish.org/meta/site-source/
This site serves as an example for the Latemp static site generator ( http://web-cpan.shlomifish.org/latemp/ ) and for other open-source technologies such as some of my XML-Grammar-* modules.
AUTHOR
Shlomi Fish, <shlomif at iglu.org.il>
BUGS
Please report any bugs or feature requests to bug-task-sites-shlomifish at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Task-Sites-ShlomiFish. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
DEFENSE OF THE MOTIVATION FOR THIS MODULE
I received a lot of heat for maintaining this task on CPAN, which I feel is unjustified. Part of the reason was that I did not make the justification for it clear in the first versions I uploaded, so here it is.
First of all, I should note that the source code of my site is public, and I give detailed installation instructions here:
http://www.shlomifish.org/meta/site-source/
So people who are interested may wish to download the site's sources, play with them and learn from them.
Furthermore, the sources of my site serve as a sophisticated example for Latemp ( http://web-cpan.shlomifish.org/latemp/ ), Website Meta Language ( http://thewml.org/ ) and other technologies. So there is some public motivation to make installing its CPAN dependencies as easy as possible.
I'm sorry that I have not made all these facts clear in the module's documentation, but I still feel that all the heat I received was uncalled for.
After I said that, let me note that it is my opinion that if we don't want to have CPAN "contaminated" with modules that are of little public use, then we should implement a secondary sources mechanism in CPANPLUS.pm which will allow configuring remote sources with their own indices, which will provide different packages to what CPAN provides. Such mechanism will also allow organisations to set up repositories for their own private use.
Last time I raised the idea, someone objected and nothing was done to take it forward. I'm willing to work on implementing it myself assuming there's enough interest and that I'll know my effort will not go to waste.
Now regarding the fact that this module wastes space on CPAN. Looking at my CPAN directory, I see that the tar.gz of version 0.0201 of it occupies 2.1 KB. What a disaster! Seriously now, it occupies much less space than "XML-Grammar-ProductSyndication" which takes 159KB, from "XML-RSS" which takes 99 KB, from "Test-Run" which takes 83 KB, and from most of my other modules. Obviously, there's some extra overhead in indexing and in displaying on search engines, but taking it into proportion, it's not a burden on CPAN.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Task::Sites::ShlomiFishYou can also look for information at:
CPAN Ratings
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Task-Sites-ShlomiFish
Search CPAN
ACKNOWLEDGEMENTS
SEE ALSO
COPYRIGHT & LICENSE
Copyright 2006 Shlomi Fish.
This program is released under the X11 License: