aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 222a40c0bdf395ed3c901ac19cc4a46cbadbe8a3 (plain)
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
# THIS PROJECT HAS BEEN ABANDONED #

The ManaTools Project has abandoned this project in favor of splitting
out each of the tools into their own projects, leveraging the common
[`python-manatools`](https://github.com/manatools/python-manatools) framework library.

The various ManaTools can be found [on GitHub](https://github.com/ManaTools).

# ManaTools #

ManaTools is a generic launcher application that can run
internal or external modules, such as system configuration tools.

ManaTools is also a collection of configuration tools that allows
users to configure most of their system components in a very simple,
intuitive and attractive interface. It consists of some modules
that can be also run as autonomous applications.

ManaTools started as a port of MCC (Mageia/Mandriva Control Center)
to libYui (Suse widget abstraction library), but its aim is to give
an easy and common interface to develop and add new modules based
on libYui. Every modules as well as ManaTools itself can be run
using QT, Gtk or ncurses interface.

# REQUIREMENTS #
* SUSE libyui *
    * https://github.com/libyui/libyui
    * Consider to check some not yet approved changes here https://github.com/anaselli/libyui

* libyui-mga - our widget extension *
    * https://github.com/xquiet/libyui-mga

* SUSE libyui-bindings - anaselli fork *
    * https://github.com/anaselli/libyui-bindings/tree/mageia
      This fork is necessary to include also libyui-mga extension.
    * For references, master is https://github.com/libyui/libyui-bindings

* at least one of the SUSE libyui plugins *
    * libyui-gtk     - https://github.com/libyui/libyui-gtk
    * libyui-ncurses - https://github.com/libyui/libyui-ncurses
    * libyui-qt      - https://github.com/libyui/libyui-qt
    * Consider here also to check some not yet approved changes at
      https://github.com/anaselli/libyui-XXX forks (where XXX is
      gtk, qt or ncurses)

* at least one of the MGA libyui widget extension plugins (according to the one above) *
    * libyui-mga-gtk     - https://github.com/xquiet/libyui-mga-gtk
    * libyui-mga-ncurses - https://github.com/xquiet/libyui-mga-ncurses
    * libyui-mga-qt      - https://github.com/xquiet/libyui-mga-qt

Note that libyui-mga and libyui-mga plugins are mainly developed
on https://bitbucket.org/_pmat_/libyui-YYY (where YYY is mga,
mga-gtk, mga-ncurses, mga-qt) and then synchronized on github.

# INSTALLATION #

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

To test gui dialogs run:
	make test TEST_GUI=1

To install this module with local::lib (see perldoc local::lib for
details). Note add also -MCPAN if you want to install from cpan locally.

	alias perl='perl -Mlocal::lib'
	perl Makefile.PL
	make
	make test
	make install

Since admin panel works with root privileges you can do the above
and install it locally then run tools as root adding your user environment
variables, to know which ones run perl -Mlocal::lib as user and
execute the output as root.

# Build and install locales #

To build and install locales

	make install_locales

To update locales (pot and pos)

	make update_n_merge

If you want to test your po changes install manatools usning local::lib
and pass --locales-dir path-to-your-locale-files to command line i.e.

	manaclock --locales-dir /home/myuser/perl5/share/locale/


# SUPPORT AND DOCUMENTATION #

After installing, you can find documentation for this module with the
perldoc command.

    perldoc ManaTools

# CONTRIBUTING #

Read MODULE_HACKING to understand how to write a Module.
Contact authors or Mageia team (http://www.mageia.org/en/contribute/)

# EMBEDDED MODULES #

* manaclock:       date/time manager
* manadm:          login manager configuration
* manahost:        hosts manager
* manalog:         journalct log reader
* manaproxy:       proxy manager
* rpmdragora:      rpm install manager
* manaservice:     service manager
* dragoraUpdate:   rpm update manager
* manauser:        user manager
* manawall:        firewall manager
* urpm-downloader: s/rpm downloader 
* contribfinder:   retrieve the contributor email for a given package name


# LICENSE AND COPYRIGHT #

Copyright (C) 2012-2017 Angelo Naselli, Matteo Pasotti, Maarten Vanraes

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 dated June, 1991 or at your option
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

A copy of the GNU General Public License is available in the source tree;
if not, write to the Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

# NOTES #

NOTE: some icons are under the license:
Creative Commons Attribution-No Derivative Works 3.0 Unported
http://creativecommons.org/licenses/by-nd/3.0/

NOTE 1:
To avoid file name duplication we renamed icons from drakxtools,
rpmdrake and userdrake, to fit new naming convention:
* drakedm-mdk   -> manadm
* time-mdk      -> manaclock
* drakhosts     -> manahost
* logdrake-mdk  -> manalog
* drakproxy-mdk -> manaproxy
* service-mdk   -> manaservice
* userdrake     -> manauser
* drakfirewall  -> manawall
* drakconf      -> mpan

NOTE 2:
clear22x22 icon is got from gnome gtk-clear