jablonka.czprosek.czf

weathermap

 Subversion Repositories:
[/] [docs/] [pages/] [cli-reference.html] - Blame information for rev 54

 

Line No. Rev Author Line
11simandl<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 
4<html lang="en" xml:lang="en">
5<head>
6 <link rel="stylesheet" type="text/css" media="screen" href="weathermap.css" />
7 <meta name="generator" content=
8 "HTML Tidy for Mac OS X (vers 12 April 2006), see www.w3.org" />
9 
10 <title>PHP Weathermap
11v0.91
12 - CLI Reference</title>
13<style type="text/css" media="print">
14/*<![CDATA[*/
15body { font-size: 12pt; }
16a { color: black; text-decoration: underline; font-weight: normal;}
17/*]]>*/
18</style>
19 
20</head>
21 
22<body>
23 <div id="frame">
24 
25<div class="navcontainer">
26 <ul id="navlist">
27 <li><a href="main.html">Main Page</a></li>
28 <li><a href="main.html#installation">Installation</a></li>
29 <li><a href="main.html#basics">Basics</a></li>
30 <li><a href="faq.html">FAQ and Tips</a></li>
31 <li><a href="main.html#example">Sample Map</a></li>
32 <li><a href="cli-reference.html">CLI Reference</a></li>
33 <li><a href="config-reference.html">Config Reference</a></li>
34 <li><a href="advanced.html">Advanced Topics</a></li>
35 <li><a href="editor.html">Editor</a></li>
36 <li><a href="cacti-plugin.html">Cacti Plugin</a></li>
37 <li><a href="http://www.network-weathermap.com/">Site</a></li>
38 </ul>
39</div>
40 
41<div id="header">
42 <h1>PHP Weathermap
43v0.91
44</h1>
45 <h4>Copyright &copy; 2005-2007 Howard Jones, <tt><a
46href="mailto:howie@thingy.com">howie@thingy.com</a></tt>. (<a
47href="http://www.network-weathermap.com/">Website</a>)</h4>
48</div>
49 
50 
51 <div id="enclose">
52 
53 <h2>Command-line options Reference</h2>The unix
54 <tt>man</tt>-style specification for weathermap is:
55 
56 <div class="shell">
57 <tt>./weathermap [--config <i>configfile</i>]
58 [--output <i>pngfile</i>] [--htmloutput <i>htmlfile</i>] [--image-uri <i>URI</i>]
59 [--debug] [--dumpafter] [--dumpconfig <i>newconfigfile</i>] [--sizedebug] [--define var=value]</tt>
60 </div>As you can see, <i>all</i> the parameters are optional!
61 By default the script will look for a configuration file
62 called <tt>weathermap.conf</tt>, and produce a PNG image file
63 called <tt>weathermap.png</tt>.
64 
65 <p><tt>--output</tt> is used to specify the name of the PNG
66 file that is created. This can also now be specified inside the configuration file, instead.</p>
67 
68 <p><tt>--config</tt> is used to specify the name of the
69 configuration file that is read.</p>
70 
71 <p><tt>--debug</tt> enables a lot of chatty debug output that
72 may be useful in the event of a problem. In case
73 <tt>--debug</tt> isn't verbose enough for you,
74 <tt>--dumpafter</tt> dumps the whole of the internal
75 structure used by weathermap at the end of a run. Note that particularly with PHP 4.x, it's possible that this will never end, as the way that references to objects are handled has changed between PHP 4 and PHP 5.</p>
76 
77 <p><tt>--dumpconfig</tt> writes out a new configuration file after reading in the specified one. This is useful when migrating older configuration files, as it will remove extra stuff made redundant by the newer <a href="#REF_DEFAULTS">'default link and node'</a> style of configuration. Obviously, you should be careful not to overwrite your existing configuration files!</p>
78 
79<p><tt>--sizedebug</tt> simply tells weathermap to draw the links with
80 the<i>maximum</i> bandwidth shown, not the current. It only works if BWLABEL is set to 'bits', but it is useful for checking you have the right sized links once you have finished your map.</p>
81 
82<p><tt>--define</tt> allows you to define additional internal variables for this run. It is equivalent to a <a href="config-reference.html#GLOBAL_SET">SET</a> line in the global section of the map configuration file.</p>
83 
84 <p><tt>--htmloutput</tt> specifies the name for an HTML file
85 to be generated to go with the PNG image file. This HTML can
86 include imagemap and DHTML features to make your weathermap
87 interactive to different degrees. This is governed by the
88 <tt><a href="config-reference.html#GLOBAL_HTMLSTYLE">HTMLSTYLE</a></tt> global
89 setting, and <tt>INFOURL</tt> and <tt>OVERLIBGRAPH</tt>
90 settings in NODE and LINK definitions. This can also now be specified inside the configuration file, instead.</p>
91 
92 <p><tt>--image-uri</tt> specifies the URI used in an HTML file
93 generated. If you are generating HTML in a different directory from the one the image is created, then weathermap will probably get the &lt;img src=""&gt; tag wrong. This option allows you to override the contents of the src attribute, if you know better.</p>
94 
95 </div>
96 </div>
97</body>
98</html>

Powered by WebSVN 2.2.1