1 |
<H1>Clipping</H1> |
2 |
|
3 |
|
4 |
<P>This is an open source, web-based application, which stores information about:</P> |
5 |
|
6 |
<UL> |
7 |
|
8 |
<LI> customer: name, phone, email, notes |
9 |
|
10 |
<LI> source: description, notes |
11 |
|
12 |
<LI> type: description, notes |
13 |
|
14 |
<LI> news: section, page, title, abstract, full_text |
15 |
|
16 |
</UL> |
17 |
|
18 |
<H2>Technology</H3> |
19 |
|
20 |
<P>This project is based on the following Free/Open Source Software (version numbers are the minimum recommended):</P> |
21 |
|
22 |
<UL> |
23 |
<LI> Linux (2.4.18) |
24 |
<LI> Apache (1.3.22) |
25 |
<LI> PostgreSQL (7.2) with pl-pgsql enabled |
26 |
<LI> Perl (5.6.1) with |
27 |
<a href="http://template-toolkit.org/">Template Toolkit</a> and |
28 |
<a href="http://search.cpan.org/author/MERGL/pgsql_perl5-1.9.0/">PostgreSQL-Perl</a> modules |
29 |
</UL> |
30 |
|
31 |
<H2>Installation</H2> |
32 |
|
33 |
<UL> |
34 |
<LI> This project requires the following Perl modules: |
35 |
<UL> |
36 |
<LI> <a href="http://search.cpan.org/author/MERGL/pgsql_perl5-1.9.0/">PostgreSQL-Perl</a> |
37 |
<LI> <a href="http://www.template-toolkit.org/">Template Toolkit</a> |
38 |
</UL> |
39 |
<LI> Copy the entire clipping directory to the cgi-bin directory in your server |
40 |
<LI> Modify the database configuration in bin/clipping.pm |
41 |
<LI> Give exec permission: chmod +x bin/clipping.pl |
42 |
|
43 |
<LI> To activate the PostgreSQL pl-pgsql language: createlang pl-pgsql <db name> |
44 |
<LI> To create tables, views and functions: |
45 |
<UL> |
46 |
<LI> psql < db/clipping_create.sql |
47 |
<LI> psql < db/clipping_view.sql |
48 |
<LI> psql < db/clipping_proc.sql |
49 |
<LI> psql < db/clipping_stats.sql |
50 |
</UL> |
51 |
</UL> |
52 |
|
53 |
<H2>Support</H2> |
54 |
|
55 |
<P>You can get support from the open source community, but make sure you read Eric Raymond's <a href="http://catb.org/~esr/faqs/smart-questions.html">How to make questions the smart way</a> first. This text will provide you with valuable tips to have your questions answered.</P> |
56 |
|
57 |
<P>(If you like this text, you may like to read |
58 |
<a href="http://www.catb.org/~esr/writings/taoup/html/">The Art of Unix Programming</a> and |
59 |
<a href="http://catb.org/~esr/faqs/hacker-howto.html">How to Become a Hacker</a>)</P> |
60 |
|
61 |
<H3>FAQs and online documentation</H3> |
62 |
|
63 |
<UL> |
64 |
<LI> <a href="http://www.linux.org/docs/">Linux</a> and |
65 |
<a href="http://www.tldp.org">The Linux Documentation Project</a> |
66 |
<LI> <a href="http://httpd.apache.org/docs-project/">Apache</a> |
67 |
<LI> <a href="http://www.postgresql.org/devel-corner/">PostgreSQL</a> |
68 |
<LI> <a href="http://learn.perl.org">Perl</a> |
69 |
</UL> |
70 |
|
71 |
<H3>Mailing lists</H3> |
72 |
|
73 |
<UL> |
74 |
<LI> <a href="http://www.linux.org">Linux</a> |
75 |
<LI> <a href="http://httpd.apache.org">Apache</a> |
76 |
<LI> <a href="http://www.postgresql.org">PostgreSQL</a> |
77 |
<LI> <a href="http://www.perl.org">Perl</a> |
78 |
</UL> |
79 |
|
80 |
<H3>IRC channels</H3> |
81 |
|
82 |
<P>You'll find several IRC channels, such as #linux, #apache, #postgresql and #perl at <a href="http://www.freenode.org">Freenode</a>.</P> |
83 |
|
84 |
<H3>Books</H3> |
85 |
|
86 |
<P>If you want to be a productive Perl programmer, make yourself a favor |
87 |
and get the following books:</P> |
88 |
|
89 |
<UL> |
90 |
<LI> Programming Perl |
91 |
<LI> Effective Perl Programming |
92 |
<LI> Advanced Perl Programming |
93 |
<LI> Perl Cookbook |
94 |
</UL> |
95 |
|
96 |
<H3>Commercial support</H3> |
97 |
|
98 |
<P>We'll be more than glad to help you with installation, customization, training and consulting. Please, <a href="http://www.phperl.com/contact.phtml">contact us</a>!</P> |
99 |
|
100 |
<H2>Thanks</H2> |
101 |
|
102 |
<P>This project was possible thanks to the effort of thousands of volunteers who created great softwares such as Linux, Apache, PostgreSQL, Perl and the internet itself.</P> |
103 |
|
104 |
<P>Consider donating your time or money (or both) to one of these organizations:</P> |
105 |
|
106 |
<UL> |
107 |
<LI> <a href="http://www.fsf.org">Free Software Foundation</a> |
108 |
<LI> <a href="http://www.opensource.org">Open Source Initiative</a> |
109 |
<LI> <a href="http://www.li.org">Linux International</a> |
110 |
<LI> <a href="http://www.apache.org">Apache Foundation</a> |
111 |
<LI> <a href="http://www.postgresql.org">PostgreSQL.org</a> |
112 |
<LI> <a href="http://www.perl-foundation.org">Perl Foundation</a> |
113 |
</UL> |
114 |
|
115 |
<H2>Copyright</H2> |
116 |
|
117 |
<P><B>Clipping</B> - Copyright (c) 2003 PhPerl.com</P> |
118 |
|
119 |
<P>This program is free software; you can redistribute it and/or |
120 |
modify it under the terms of the GNU General Public License |
121 |
as published by the Free Software Foundation; either version 2 |
122 |
of the License, or (at your option) any later version.</P> |
123 |
|
124 |
<P>This program is distributed in the hope that it will be useful, |
125 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
126 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P> |
127 |
|
128 |
<P>See the |
129 |
<a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</a> |
130 |
for more details.</P> |