fixed build
[www.git] / www / ppastats / ppastats.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="UTF-8">
5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <meta name="generator" content="Asciidoctor 1.5.4">
8 <title>PPAstats</title>
9 <link rel="stylesheet" href="./../style.css">
10 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
11 <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
12 <script src="../nav.js"></script>
13 </head>
14 <body class="article">
15 <div id="header">
16 <h1>PPAstats</h1>
17 </div>
18 <div id="content">
19 <div id="preamble">
20 <div class="sectionbody">
21 <div class="paragraph">
22 <p><code>ppastats</code> is a command line tool which produces HTML report for viewing
23 download statistics of an Ubuntu PPA.</p>
24 </div>
25 <div class="paragraph">
26 <p>Examples are available at: <a href="http://wpitchoune.net/ppastats/files/examples" class="bare">http://wpitchoune.net/ppastats/files/examples</a>.</p>
27 </div>
28 <div class="paragraph">
29 <p>The license of <code>ppastats</code> is GPL v2.</p>
30 </div>
31 <div class="paragraph">
32 <p><code>ppastats</code> works fine with Firefox 6/7, Google Chrome 12 and IE8.</p>
33 </div>
34 </div>
35 </div>
36 <div class="sect1">
37 <h2 id="_usage">Usage</h2>
38 <div class="sectionbody">
39 <div class="listingblock">
40 <div class="content">
41 <pre>ppastats jfi psensor-unstable -o /var/www/ppastats</pre>
42 </div>
43 </div>
44 <div class="paragraph">
45 <p>Generates the HTML report for the PPA: <code>ppa:jfi/psensor-unstable</code>.</p>
46 </div>
47 <div class="paragraph">
48 <p>Use <code>ppastats --help</code> for more options.</p>
49 </div>
50 </div>
51 </div>
52 <div class="sect1">
53 <h2 id="_installation">Installation</h2>
54 <div class="sectionbody">
55 <div class="sect2">
56 <h3 id="_ubuntu">Ubuntu</h3>
57 <div class="paragraph">
58 <p>For Ubuntu, the easiest way to install <code>ppastats</code> is to use its
59 dedicated PPA:</p>
60 </div>
61 <div class="listingblock">
62 <div class="content">
63 <pre>sudo apt-add-repository ppa:jfi/ppastats
64 sudo apt-get update
65 sudo apt-get install ppastats</pre>
66 </div>
67 </div>
68 </div>
69 <div class="sect2">
70 <h3 id="_compilation">Compilation</h3>
71 <div class="paragraph">
72 <p><code>ppastats</code> should compile on any modern Linux distribution, it
73 requires the <code>CURL</code> and <code>json-c</code> libraries.</p>
74 </div>
75 <div class="paragraph">
76 <p>Download the source archive from: <a href="http://wpitchoune.net/ppastats/files" class="bare">http://wpitchoune.net/ppastats/files</a>.</p>
77 </div>
78 <div class="paragraph">
79 <p>For compilation on Ubuntu:</p>
80 </div>
81 <div class="listingblock">
82 <div class="content">
83 <pre>apt-get install libcurl4-openssl-dev libjson0-dev
84 ./configure
85 make clean all</pre>
86 </div>
87 </div>
88 <div class="paragraph">
89 <p>and finally, install <code>ppastats</code>:</p>
90 </div>
91 <div class="listingblock">
92 <div class="content">
93 <pre>sudo make install</pre>
94 </div>
95 </div>
96 <div class="paragraph">
97 <p>Alternatively, the last development version can be retrieved using GIT:</p>
98 </div>
99 <div class="listingblock">
100 <div class="content">
101 <pre>git clone git://git.wpitchoune.net/ppastats.git</pre>
102 </div>
103 </div>
104 <div class="paragraph">
105 <p>To build the Ubuntu package:</p>
106 </div>
107 <div class="listingblock">
108 <div class="content">
109 <pre>git clone git://git.wpitchoune.net/ppastats-pkg-ubuntu.git
110 cd ppastats-pkg-ubuntu
111 git-buildpackage</pre>
112 </div>
113 </div>
114 </div>
115 </div>
116 </div>
117 <div class="sect1">
118 <h2 id="_download">Download</h2>
119 <div class="sectionbody">
120 <div class="ulist">
121 <ul>
122 <li>
123 <p><a href="files">Source archive</a></p>
124 </li>
125 </ul>
126 </div>
127 </div>
128 </div>
129 <div class="sect1">
130 <h2 id="_contact">Contact</h2>
131 <div class="sectionbody">
132 <div class="paragraph">
133 <p>Bugs and comments can be sent to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
134 </div>
135 <div class="paragraph">
136 <p>For announces or general information subscribe to <a href="http://plus.google.com/u/0/115217597639251170338?prsrc=3">ppastats Google+ page</a>.</p>
137 </div>
138 </div>
139 </div>
140 </div>
141 <div id="footer">
142 <div id="footer-text">
143 Last updated 2016-06-14 21:30:49 CEST
144 </div>
145 </div>
146 </body>
147 </html>