Changeset 3413 for pykota/trunk/docs/pykotme.sgml
- Timestamp:
- 09/27/08 22:02:37 (16 years ago)
- Files:
-
- 1 modified
Legend:
- Unmodified
- Added
- Removed
-
pykota/trunk/docs/pykotme.sgml
r2909 r3413 4 4 <title id="pykotme">Get print quotes before printing for real with <command>pykotme</command></title> 5 5 <para>Last modified on $Date$</para> 6 6 7 7 <para> 8 8 PyKota features a print quote generator, named <command>pykotme</command>. … … 12 12 knowingly. 13 13 </para> 14 14 15 15 <para> 16 16 To get a print quote, you have to launch <command>pykotme</command> 17 17 from the command line, passing your print job's content in any format 18 recognized by PyKota 18 recognized by PyKota 19 19 <footnote><para>PyKota now uses <ulink url="http://www.pykota.com/software/pkpgcounter">pkpgcounter</ulink> 20 20 which recognizes PostScript (both binary and DSC compliant), … … 23 23 or on its standard input (i.e. in a shell pipe or redirection). 24 24 </para> 25 25 26 26 <para> 27 27 Without any command line argument, <command>pykotme</command> 28 28 automatically reads your job's data from its standard input. 29 29 </para> 30 30 31 31 <para> 32 32 By default, <command>pykotme</command> … … 38 38 them with commas. 39 39 </para> 40 40 41 41 <para> 42 42 <command>pykotme</command>'s functionnality is also available through the … … 44 44 However without authentication <command>pykotme.cgi</command> will only 45 45 return the print job's size and not its cost, because the cost depends on 46 the value of the user's overcharging factor and the printer being used. 47 That's why if you want to 48 obtain the same functionnality with the <acronym>CGI</acronym> script than 46 the value of the user's overcharging factor and the printer being used. 47 That's why if you want to 48 obtain the same functionnality with the <acronym>CGI</acronym> script than 49 49 with the command line tool, you must configure your web server to force 50 50 users to authenticate whevenver they access to <command>pykotme.cgi</command>. 51 Then they will be able to choose one or more printers (all by default), 51 Then they will be able to choose one or more printers (all by default), 52 52 and also to enter their username, 53 53 and the exact cost of the print job will be computed. 54 54 </para> 55 55 56 56 <sect1> 57 57 <title>Examples</title> … … 59 59 Here are some examples of <command>pykotme</command> usage. 60 60 </para> 61 61 62 62 <para> 63 63 The simplest form : 64 <screen> 64 <screen> 65 65 port50-2:~$ pykotme pykota.ps 66 66 Your account balance : 16.25 67 67 Job size : 22 pages 68 68 Cost on printer apple : 1.35 69 port50-2:~$ 70 </screen> 69 port50-2:~$ 70 </screen> 71 71 </para> 72 72 73 73 <para> 74 74 More complex, with printer name wildcard and within a pipe : 75 <screen> 75 <screen> 76 76 port50-2:~$ a2ps -o - pykota/README | pykotme --printer "a*" 77 77 [pykota/README (plain): 6 pages on 3 sheets] … … 80 80 Job size : 3 pages 81 81 Cost on printer apple : 0.40 82 port50-2:~$ 82 port50-2:~$ 83 83 </screen> 84 84 </para> 85 85 </sect1> 86 86 87 87 <sect1> 88 88 <title>Reference</title> … … 95 95 <arg>-P <replaceable>printername</replaceable></arg> 96 96 <arg>--printer <replaceable>printername</replaceable></arg> 97 </group> 97 </group> 98 98 <group choice="opt"> 99 99 <arg><replaceable>filename1</replaceable></arg> … … 101 101 <arg><replaceable>...</replaceable></arg> 102 102 <arg><replaceable>filenameN</replaceable></arg> 103 </group> 103 </group> 104 104 </cmdsynopsis> 105 105 </para>