annotate README @ 518:dbefc648ad71 3.2

Merge
author Magnus Schieder <mschieder@intevation.de>
date Fri, 30 Nov 2018 12:56:42 +0100
parents 708e1ff71b52
children e8b7abbe07e5
rev   line source
417
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
1 Usage
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
2 =====
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
3
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
4 Call ``getan`` or ``getan.py`` in a terminal to start
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
5 with an empty list of tasks that you want to track time for.
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
6
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
7 Use the Insert-Key to add a new task to track.
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
8 (A *task* is called *project* within getan.)
438
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
9 You will have to enter a project "key" and a project "description".
417
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
10
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
11 Now select one of the projects with the arrow keys from your keyboard
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
12 and press enter to start the clock. See ``INTRODUCTION`` for more keyboard
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
13 commands.
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
14
418
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
15 The time log entries will be saved in an sqlite database,
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
16 by default getan will create ``~/.getan/time.db``.
417
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
17 The ``scripts/`` will help to generate reports from them.
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
18
438
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
19 Tree mode
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
20 ---------
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
21 Getan supports a hierarchy of projects. A top level project key
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
22 has only one character, once you starting using a second character
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
23 as project key, it will be the next level down in the hierarchy.
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
24 Example::
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
25
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
26 a Top level project
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
27 aa 1st second level project
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
28 ab 2nd second level project
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
29 aba Third level Project
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
30
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
31 Use the switch_project_order key which is ``f2`` by default
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
32 to cycle to the hierarchical view.
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
33
d56fee6fd7ca Documentation: Adds description of the available tree mode.
Bernhard Reiter <bernhard@intevation.de>
parents: 424
diff changeset
34
418
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
35 Customization
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
36 -------------
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
37
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
38 Use ``~/.getan/getanrc`` or the system-wide ``/etc/getanrc``
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
39 to customize keys and colors. See ``getan/config.py`` for
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
40 the recognized options. Example::
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
41
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
42 [keybindings]
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
43 # changes the insert function to be activated by the `)` key
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
44 insert: )
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
45
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
46 [theme]
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
47 header: light green, dark green
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
48 body: light green, black
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
49
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
50
cd990c7dc746 Version: Prepares for 2.0.post1 release.
Bernhard Reiter <bernhard@intevation.de>
parents: 417
diff changeset
51
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
52 Installation
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
53 ============
0
7eb7886ed8fd Initial import.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
54
336
a3d1fc6c0153 README updated: New urwid.org homepage and location simplified. Typo fixed.
Bernhard Reiter <bernhard@intevation.de>
parents: 291
diff changeset
55 Getan requires `urwid <http://urwid.org/>`_ in a version >= 1.0. Urwid is
367
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
56 a console user interface library written in Python. For console output e.g.
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
57 zeiterfassung.py Getan also requires `Jinja2 <http://jinja.pocoo.org/>_`.
261
cf905ed23de0 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 259
diff changeset
58
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
59 Install urwid
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
60 -------------
23
9c4e8ba3c4fa Added a new implementation of 'getan' based on urwid, a python console user interface library.
Ingo Weinzierl <ingo_weinzierl@web.de>
parents: 3
diff changeset
61
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
62 On Debian GNU/Linux >= Wheezy just run as root:::
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
63
507
32ddea6d5bdb README: use python3 for apt-get and setup.py calls
Thomas Arendsen Hein <thomas@intevation.de>
parents: 481
diff changeset
64 $ apt-get install python3-urwid
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
65
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
66 On other systems urwid may be installed via pip or directly put into the sources
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
67 of getan.
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
68
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
69 Using pip
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
70 ^^^^^^^^^
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
71
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
72 To install urwid via pip run as root::
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
73
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
74 $ pip install urwid
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
75
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
76 Or if you prefer using a virtualenv::
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
77
414
69ef6f89e930 Prepares release v2.0.
Bernhard Reiter <bernhard@intevation.de>
parents: 367
diff changeset
78 $ virtualenv getan-env
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
79 $ source getan-env/bin/activate
414
69ef6f89e930 Prepares release v2.0.
Bernhard Reiter <bernhard@intevation.de>
parents: 367
diff changeset
80 (getan-env)$ pip install -U pip # to get the latest pip
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
81 (getan-env)$ pip install urwid
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
82
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
83 Using urwid sources
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
84 ^^^^^^^^^^^^^^^^^^^
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
85
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
86 Urwid can be put as source to the getan directory when getan is run directly
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
87 from the sources. Urwid source can be downloaded from `pypi
336
a3d1fc6c0153 README updated: New urwid.org homepage and location simplified. Typo fixed.
Bernhard Reiter <bernhard@intevation.de>
parents: 291
diff changeset
88 <https://pypi.python.org/pypi/urwid/>`_.
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
89
337
96a8545eb247 README: updated for urwid 1.1.2. Better example shell commands for using urwid from source.
Bernhard Reiter <bernhard@intevation.de>
parents: 336
diff changeset
90 For urwid 1.1.2 the direct download link from pypi is
340
325499a01b65 Use text width of 80 chars per line in README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 337
diff changeset
91 `<https://pypi.python.org/packages/source/u/urwid/urwid-1.1.2.tar.gz>`_
325499a01b65 Use text width of 80 chars per line in README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 337
diff changeset
92 (sha256sum is
325499a01b65 Use text width of 80 chars per line in README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 337
diff changeset
93 f56568b4f8459b3265c65d9e275ef72df6cb16ad0c291f0feb027cc911ea0f26).::
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
94
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
95 $ cd getan-source
337
96a8545eb247 README: updated for urwid 1.1.2. Better example shell commands for using urwid from source.
Bernhard Reiter <bernhard@intevation.de>
parents: 336
diff changeset
96 $ v=urwid-1.1.2
96a8545eb247 README: updated for urwid 1.1.2. Better example shell commands for using urwid from source.
Bernhard Reiter <bernhard@intevation.de>
parents: 336
diff changeset
97 $ curl -O https://pypi.python.org/packages/source/u/urwid/$v.tar.gz
96a8545eb247 README: updated for urwid 1.1.2. Better example shell commands for using urwid from source.
Bernhard Reiter <bernhard@intevation.de>
parents: 336
diff changeset
98 $ sha256sum $v.tar.gz
96a8545eb247 README: updated for urwid 1.1.2. Better example shell commands for using urwid from source.
Bernhard Reiter <bernhard@intevation.de>
parents: 336
diff changeset
99 $ tar -xzvf $v.tar.gz
96a8545eb247 README: updated for urwid 1.1.2. Better example shell commands for using urwid from source.
Bernhard Reiter <bernhard@intevation.de>
parents: 336
diff changeset
100 $ ln -s $v/urwid urwid
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
101
367
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
102 Install Jinja2
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
103 --------------
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
104
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
105 On Debian GNU/Linux just run as root:::
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
106
507
32ddea6d5bdb README: use python3 for apt-get and setup.py calls
Thomas Arendsen Hein <thomas@intevation.de>
parents: 481
diff changeset
107 $ apt-get install python3-jinja2
367
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
108
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
109 On other systems jinja2 may be installed via pip or directly put into the
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
110 sources of getan.
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
111
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
112 Using pip
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
113 ^^^^^^^^^
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
114
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
115 To install jinja2 via pip run as root::
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
116
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
117 $ pip install jinja2
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
118
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
119 Or if you prefer using a virtualenv::
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
120
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
121 $ source getan-env/bin/activate
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
122 (getan-env)$ pip install jinja2
ea5a171abda7 Update README for installing jinja2
Björn Ricks <bjoern.ricks@intevation.de>
parents: 342
diff changeset
123
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
124 Install getan
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
125 -------------
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
126
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
127 A installation of getan is not required. It can also be run directly from the
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
128 sources. To install getan system wide the following command must be run as root
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
129 user::
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
130
507
32ddea6d5bdb README: use python3 for apt-get and setup.py calls
Thomas Arendsen Hein <thomas@intevation.de>
parents: 481
diff changeset
131 $ python3 setup.py install
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
132
508
708e1ff71b52 README: mention that python3-setuptools is needed
Thomas Arendsen Hein <thomas@intevation.de>
parents: 507
diff changeset
133 You may need to install setuptools first, on Debian GNU/Linux just run as root:::
708e1ff71b52 README: mention that python3-setuptools is needed
Thomas Arendsen Hein <thomas@intevation.de>
parents: 507
diff changeset
134
708e1ff71b52 README: mention that python3-setuptools is needed
Thomas Arendsen Hein <thomas@intevation.de>
parents: 507
diff changeset
135 $ apt-get install python3-setuptools
708e1ff71b52 README: mention that python3-setuptools is needed
Thomas Arendsen Hein <thomas@intevation.de>
parents: 507
diff changeset
136
708e1ff71b52 README: mention that python3-setuptools is needed
Thomas Arendsen Hein <thomas@intevation.de>
parents: 507
diff changeset
137
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
138 Starting getan
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
139 ==============
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
140
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
141 Getan can be directly run from sources or after a system wide installation from
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
142 the bin dir (e.g. /usr/bin).
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
143
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
144 Running from Sources
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
145 --------------------
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
146
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
147 To run getan from the sources run::
0
7eb7886ed8fd Initial import.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
148
23
9c4e8ba3c4fa Added a new implementation of 'getan' based on urwid, a python console user interface library.
Ingo Weinzierl <ingo_weinzierl@web.de>
parents: 3
diff changeset
149 $ ./getan.py
0
7eb7886ed8fd Initial import.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
150
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
151 or::
0
7eb7886ed8fd Initial import.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
152
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
153 $ ./getan.py /path/to/mytime.db
0
7eb7886ed8fd Initial import.
Sascha L. Teichmann <teichmann@intevation.de>
parents:
diff changeset
154
341
148300d6f126 Fix typos in README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 340
diff changeset
155 to choose a different sqlite3 database then the default time.db
288
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
156
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
157
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
158 Running from installation
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
159 -------------------------
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
160
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
161 After installing getan it can be run with::
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
162
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
163 $ getan
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
164
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
165 or::
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
166
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
167 $ getan /path/to/mytime.db
1c9c3c9454e3 Update README
Björn Ricks <bjoern.ricks@intevation.de>
parents: 261
diff changeset
168
424
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
169
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
170 CREDITS
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
171 =======
439
3103429ec963 Makes 'move' operation more consistent.
Bernhard Reiter <bernhard@intevation.de>
parents: 438
diff changeset
172 Getan is Free Software licensed under the terms of GNU GPL v>=3.
424
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
173 For details see LICENSE coming with the source of 'getan'.
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
174
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
175
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
176 Main development
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
177 ----------------
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
178 2014-(current maintainer) Bernhard E. Reiter <bernhard@intevation.de>
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
179 2011-2014 Björn Ricks <bjoern.ricks@intevation.de>
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
180 2010 Ingo Weinzierl <ingo.weinzierl@intevation.de>
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
181 2009-2014 Thomas Arendsen Hein <thomas@intevation.de>
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
182 2008-2010 Sascha L. Teichmann <sascha.teichmann@intevation.de>
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
183
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
184 Contributions
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
185 -------------
450
45b7b83efaed Prepares for release 2.2.
Magnus Schieder <mschieder@intevation.de>
parents: 439
diff changeset
186 Magnus Schieder
439
3103429ec963 Makes 'move' operation more consistent.
Bernhard Reiter <bernhard@intevation.de>
parents: 438
diff changeset
187 Frank Koormann
424
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
188 Stephan Holl
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
189 Tom Gottfried
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
190
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
191 Thanks
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
192 ------
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
193 To all users that gave feedback, especially at Intevation.
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
194
8b1916aabe65 Docs: adds CREDITS section with license info.
Bernhard Reiter <bernhard@intevation.de>
parents: 418
diff changeset
195
417
d6d9d319bd2e Prepares for PyPi publication.
Bernhard Reiter <bernhard@intevation.de>
parents: 414
diff changeset
196 .. vim: set ts=4 sw=4 tw=80 filetype=rst :
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)