From: eldy <> Date: Sat, 3 Apr 2004 00:52:56 +0000 (+0000) Subject: Added Awstats XML database schema and a data and style sheet demo file. X-Git-Tag: AWSTATS_6_1_BETA~36 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e7a6b3688f045a69d1c002ee1927fe99028c817b;p=thirdparty%2FAWStats.git Added Awstats XML database schema and a data and style sheet demo file. --- diff --git a/README.TXT b/README.TXT index 4d8ff901..80781852 100644 --- a/README.TXT +++ b/README.TXT @@ -3,11 +3,11 @@ Advanced Web Statistics ------------------------------------ -AWStats (Advanced Web Statistics) is a powerful, full-featured web server -logfile analyzer which shows you all your Web statistics including: visitors, +AWStats (Advanced Web Statistics) is a powerful, full-featured web server +logfile analyzer which shows you all your Web statistics including: visitors, pages, hits, hours, search engines, keywords used to find your site, broken -links, robots and many more... - +links, robots and many more... + It works with IIS 5.0+, Apache and all major web, wap, proxy, streaming server log files (and even ftp servers or mail logs) on all Operating Systems. @@ -35,53 +35,54 @@ I - FEATURES AND REQUIREMENTS I - 1) Features A full log analysis enables AWStats to show you the following information: - * Number of VISITS and UNIQUE VISITORS - * Visits duration and last visits - * Authenticated users, and last authenticated visits - * Days of week and rush hours (pages, hits, KB for each day and hour) - * Domains/countries of hosts visitors (pages, hits, KB) - * Hosts list, last visits and unresolved IP addresses list - * Most viewed, entry and exit pages - * File types - * Web compression statistics (for mod_gzip or mod_deflate) - * Browsers used (pages, hits, kb for each browser) - * OS used (pages, hits, KB for each OS) - * Robot visits - * Worm attacks - * Search engines, keyphrases and keywords used to find your site - * HTTP errors (Page not found with last referer, etc,) - * Screen size report - * Number of times your site is "added to favourites bookmarks" + * Number of VISITS and UNIQUE VISITORS + * Visits duration and last visits + * Authenticated users, and last authenticated visits + * Days of week and rush hours (pages, hits, KB for each day and hour) + * Domains/countries of hosts visitors (pages, hits, KB) + * Hosts list, last visits and unresolved IP addresses list + * Most viewed, entry and exit pages + * File types + * Web compression statistics (for mod_gzip or mod_deflate) + * Browsers used (pages, hits, kb for each browser) + * OS used (pages, hits, KB for each OS) + * Robot visits + * Worm attacks + * Search engines, keyphrases and keywords used to find your site + * HTTP errors (Page not found with last referer, etc,) + * Screen size report + * Number of times your site is "added to favourites bookmarks" * Ratio of Browsers that support: Java, Flash, RealG2 reader, Quicktime reader, WMA reader, PDF reader - * Cluster report for load balanced servers ratio - * Other personalized reports... + * Cluster report for load balanced servers ratio + * Other personalized reports... It supports the following features as well: - * Can analyze all log formats + * Can analyze all log formats * Works from command line and from a browser as a CGI (with dynamic - filters capabilities for some charts) + filters capabilities for some charts) * Update of statistics can be made on demand from the web interface and - not only from your scheduler - * Unlimited log file size, support split log files (load balancing system) - * Support 'nearly sorted' log files even for entry and exit pages - * Reverse DNS lookup before or during analysis, supports DNS cache files - * Country detection from IP location or domain name - * WhoIS links - * A lot of options/filters and plugins can be used - * Multi-named web sites supported (virtual servers) - * Cross Site Scripting Attacks protection - * Several languages - * No need of rare perl libraries - * Dynamic reports as CGI output - * Static reports in one or framed HTML/XML pages, experimental PDF export - * Look and colors can match your site design (CSS) - * Help and tooltips on HTML reported pages - * Experimental PDF export - * Easy to use (Just one configuration file to edit) - * Free (GNU GPL) with sources (perl scripts) - * A Webmin module - * Available on all platforms + not only from your scheduler + * Unlimited log file size, support split log files (load balancing system) + * Support 'nearly sorted' log files even for entry and exit pages + * Reverse DNS lookup before or during analysis, supports DNS cache files + * Country detection from IP location or domain name + * WhoIS links + * A lot of options/filters and plugins can be used + * Multi-named web sites supported (virtual servers) + * Cross Site Scripting Attacks protection + * Several languages + * No need of rare perl libraries + * Dynamic reports as CGI output + * Static reports in one or framed HTML/XHTML pages + * Experimental PDF export + * Look and colors can match your site design (CSS) + * Help and tooltips on HTML reported pages + * Easy to use (Just one configuration file to edit) + * Analysis database can be stored in XML format for XSLT processing + * A Webmin module + * Free (GNU GPL) with sources (perl scripts) + * Available on all platforms I - 2) Requirements @@ -89,8 +90,8 @@ I - 2) Requirements To use AWStats CGI script, you need the following requirements: * Your server must log web access in a log file you can read. * To run awstats, from command line, your operating system must be able - to run perl scripts (.pl files). - + to run perl scripts (.pl files). + To run awstats as a CGI (for real-time statistics), your web server must also be able to run such scripts. If not, you can solve this by downloading last Perl version at: @@ -105,31 +106,32 @@ I - 3) Files docs/LICENSE GNU General Public Licence docs/* AWStats documentation (setup/usage...) wwwroot/cgi-bin/awstats.pl THE MAIN AWSTATS PROGRAM (CLI/CGI) - wwwroot/cgi-bin/awredir.pl A tool to track exit clicks - wwwroot/cgi-bin/awstats.model.conf An model configuration file + wwwroot/cgi-bin/awredir.pl A tool to track exit clicks + wwwroot/cgi-bin/awstats.model.conf An model configuration file wwwroot/cgi-bin/lang Directory with languages files wwwroot/cgi-bin/lib Directory with awstats reference info wwwroot/cgi-bin/plugins Directory with optional plugins wwwroot/icon/browser Directory with browsers icons - wwwroot/icon/clock Directory with clock icons + wwwroot/icon/clock Directory with clock icons wwwroot/icon/cpu Directory with cpu icons - wwwroot/icon/flags Directory with country flag icons - wwwroot/icon/os Directory with OS icons + wwwroot/icon/flags Directory with country flag icons + wwwroot/icon/os Directory with OS icons wwwroot/icon/other Directory with all others icons wwwroot/classes Java applet for graphapplet plugin wwwroot/css Samples of CSS files wwwroot/js Javascript sources for "Misc" feature tools/* Other provided tools - tools/webmin/awstats-x.x.wbm A Webmin module for AWStats + tools/xslt/* Demo to manipulate AWStats XML database + tools/webmin/awstats-x.x.wbm A Webmin module for AWStats II - INSTALL, SETUP AND USE AWSTATS ----------------------------------- -The documentation available for this release in HTML format is -in the docs/ directory. - +The documentation available for this release in HTML format is +in the docs/ directory. + You can find a most up-to-date documentation at: http://awstats.sourceforge.net diff --git a/docs/awstats_what.html b/docs/awstats_what.html index a642ba68..f9c17c3c 100644 --- a/docs/awstats_what.html +++ b/docs/awstats_what.html @@ -86,13 +86,16 @@ As AWStats works from the command line but also as a CGI, it can work with major * Cross Site Scripting Attacks protection,
* Several languages. See AWStats F.A.Q. for full list.
* No need of rare perl libraries. All basic perl interpreters can make AWStats working,
- * Graphical and framed reports,
+ * Dynamic reports as CGI output.
+ * Static reports in one or framed HTML/XHTML pages, experimental PDF export,
* Look and colors can match your site design, can use CSS,
* Help and tooltips on HTML reported pages,
* Easy to use (Just one configuration file to edit),
- * Absolutely free (even for web hosting providers), with sources (GNU General Public License)
+ * Analysis database can be stored in XML format for XSLT processing,
+ * A Webmin module,
+ * Absolutely free (even for web hosting providers), with sources (GNU General Public License),
* Available on all platforms,
- * AWStats has a XML Portable Application Description.
+ * AWStats has a XML Portable Application Description.

Requirements:
To use AWStats, you need the following requirements:
diff --git a/tools/xslt/README.txt b/tools/xslt/README.txt new file mode 100644 index 00000000..fd69f569 --- /dev/null +++ b/tools/xslt/README.txt @@ -0,0 +1,22 @@ +This directory is absolutely not required to make AWStats working. +All files here are demo files you can use if you want to manipulate AWStats XML +database to build report by yourself and without using AWStats output features. + + +The following file describe the structure of the AWStats XML database (built +when BuildHistoryOutput is set to 'xml'). +* awstats61.xsd File descriptor for AWStats xml database schema. + + +The following two files can be used to test a xslt processing to +transform an AWStats XML database (built when BuildHistoryOutput is set to 'xml'). +into a report. +* awstats61.datademo1.xml A xml data demo file to test xslt transform with style sheet. +* awstats61.datademo1.xslt A demo xsl style sheet to transform de xml data demo file. + + + +To build a report using this 2 files and a xslt processor, you must run the command: + +xsltproc awstats61.datademo1.xslt awstats61.datademo1.xml > output.html +