From f89dec7f99d99c17667fb6878c2e7d24a3272e84 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Fr=C3=A9d=C3=A9ric=20Marchal?= Date: Wed, 31 Mar 2010 12:45:52 +0000 Subject: [PATCH] Update the README file, especially the translations --- README | 141 +++++++++++++++++++++++++++++++++------------------------ 1 file changed, 81 insertions(+), 60 deletions(-) diff --git a/README b/README index e4d3c15..8b72d62 100644 --- a/README +++ b/README @@ -1,8 +1,83 @@ Sarg is a Squid Analysis Report Generator that allow you to view "where" your users are going to on the Internet. -Sarg generate reports in html, with many fields, like: users, IP Addresses, bytes, sites and times. +Sarg generates reports in html, with many fields, like: users, IP Addresses, bytes, sites and times. + +Source: http://sourceforge.net/projects/sarg/ + + +Installation +------------ + +1. run ./configure + + Useful configure options: + --prefix - The root directory of the installation + default: /usr/local + + --bindir - where sarg binary will be saved + default: /usr/local/bin + + --sysconfdir - where the configuration directory is + default: /usr/local/etc + + --mandir - where the sarg man page will be saved + default: /usr/local/share/man + + --enable-sargphp - where to install sarg-php (--disable-sargphp don't install sarg-php) + default: /var/www/html + + --enable-fontdir - where to find the fonts for the reports (--diable-fontdir don't install the fonts) + default: /usr/local/share/sarg/fonts + + --enable-imagedir - where sarg take the images to include in the reports + default: /usr/local/share/sarg/images + + --enable-extraprotection - compile sarg with extra GCC options for increased security + default: use standard compilation warnings and no protection + + For a complete list of all the options, run ./configure --help. + +3. make + +4. make install + +5. Go to /usr/local/sarg (or file entered with --sysconfdir on configure) + and change sarg.conf as you need. + +6. Notes about sarg: + + Date/Time report: + Every minute that a request is logged your time is incremented by the smaller + of 1 minute or the total time for the requests. + +Usage: sarg -h + + +Translations +------------ + +As of March 14th, 2010 (sarg 2.3), the translations have been ported to gettext. This makes it easier +to translate all the messages (the number of translated messages went from 144 to 448). Therefore, the +old language files are obsolete. The old translated message have been converted automatically to +gettext but due to the changes made to the strings in the program after the automatic conversion, +it is likely that the old messages are, at best, meaningless. + +Translations are handled at http://translationproject.org/domain/sarg.html. If your language is +not yet supported or the current translation is obsolete, please check with the team working +on your language at the Translation Project to be sure nobody is assigned to sarg. If necessary, +contact the coordinator of that team to join the team and be assigned to sarg. + +If no po file exists for you language, download the latest sarg.pot on this page +http://translationproject.org/domain/sarg.html and rename it as YourLanguageCode.po. See +http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes for the list of the +valid languages codes. + +Translate YourLanguageCode.po (see http://www.gnu.org/software/gettext/manual/gettext.html for more informations). + +Submit the translated po file to robot@translationproject.org. You must be a member of the team +working on the language for which you are submitting the po file or the robot will reject +your file. It is not necessary to fill the disclaimer to translate sarg. -Support to SmartFilter added - 09/02/2000 Special thanks to: Matteo Colombo - Italian language @@ -36,64 +111,10 @@ Alex Deiter - Russian UTF-8 language Josef Karliak - Czech UTF-8 Igor Ageikin - Russian UTF-8 fix -Note: as of March 14th, 2010, the translations have been ported to gettext. This makes it easier to -translate all the messages (the number of translated messages went from 144 to 448). Therefore, the -old language files are obsolete. The old translated message have been converted automatically to -gettext but due to the changes made to the strings in the program after the automatic conversion, -it is likely that the old messages are, at best, meaningless. - -Translating - . Make sure there is no file with your language code in subdirectory po. If one exists, - expand or review it. - . If no po file exists for you language, copy po/sarg.pot to po/YourLanguageCode.po. See - http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes for the list of the - valid languages codes. - . Translate YourLanguageCode.po (see http://www.gnu.org/software/gettext/manual/gettext.html for more informations). - . Send YourLanguageCode.po to fmarchal@users.sourceforge.net to be implemented. - - -If you use native squid log format, the elapsed time will be in reports (emulate_httpd_log off). - -1. run ./configure - - configure options: --bindir=where sarg binary will be saved - default: /usr/local/bin - - --sysconfdir - where the configuration directory is - default: /usr/local/etc - - --mandir - where the sarg man page will be saved - default: /usr/local/share/man - - --enable-sargphp - where to install sarg-php (--disable-sargphp don't install sarg-php) - default: /var/www/html - - --enable-fontdir - where to find the fonts for the reports (--diable-fontdir don't install the fonts) - default: /usr/local/share/sarg/fonts - - --enable-imagedir - where sarg take the images to include in the reports - default: /usr/local/share/sarg/images - --enable-extraprotection - compile sarg with extra GCC options for increased security - default: use standard compilation warnings and no protection - -3. make - -4. make install - -5. Go to /usr/local/sarg (or file entered with --sysconfdir on configure) - and change sarg.conf as you need. - -6. Notes about sarg: - - Date/Time report: - Every minute that a request is logged your time is incremented by the smaller - of 1 minute or the total time for the requests. - -Usage: sarg -h - -Source: http://sourceforge.net/projects/sarg/ +Suggestions or remarks +---------------------- -Any suggests and/or comments may be posted on sarg forum -http://sourceforge.net/projects/sarg/forums/forum/363374 or to Frederic Marchal +Any suggests or comments may be posted on the forum +http://sourceforge.net/projects/sarg/forums/forum/363374 or sent to Frederic Marchal (fmarchal@users.sourceforge.net) -- 2.47.2