File: README.rst

package info (click to toggle)
sphinxcontrib-googleanalytics 0.5-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 112 kB
  • sloc: python: 29; makefile: 5
file content (59 lines) | stat: -rw-r--r-- 1,243 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
.. -*- restructuredtext -*-

===========================================
Google Analytics extension for Sphinx
===========================================

:author: Domen Kožar <domen@dev.si>


About
=====

This extensions allows you to track generated html files
with Google Analytics web service.


Installing from sphinx-contrib checkout
---------------------------------------

Checkout googleanalytics sphinx extension::

  $ git clone https://github.com/sphinx-contrib/googleanalytics

Change into the googleanalytics directory::

  $ cd googleanalytics

Install the module::

  $ python setup.py install


Enabling the extension in Sphinx_
---------------------------------

Just add ``sphinxcontrib.googleanalytics`` to the list of extensions in the ``conf.py``
file. For example::

    extensions = ['sphinxcontrib.googleanalytics']


Configuration
-------------

For now one optional configuration is added to Sphinx_. It can be set in
``conf.py`` file:

``googleanalytics_id`` <string>:
	UA id for your site, example::
		googleanalytics_id = 'UA-123-123-123'

``googleanalytics_enabled`` <bool>:
	True by default, use it to turn off tracking.


.. Links:
.. _gnuplot: http://www.gnuplot.info/
.. _Sphinx: http://sphinx.pocoo.org/