# Makagiga - LISEZ-MOI

## Sommaire

- Qu'est-ce que Makagiga?
  - Page d'accueil
  - Wiki
  - Contact
- Requis
- Installation
  - Installation de Java
    - Générique
    - Ubuntu/Kubuntu
  - Paquet Debian/Ubuntu - *.deb
  - Fichier RPM package - *.rpm
  - Paquet Zippé - *.zip file
  - Fichier Setup - *.exe file
  - Comment démarrer ? (Linux)
- Configuration
  - Application portable (pour un disque USB flash ou une carte flash)
  - Profils
- Options de ligne de commande
- License & Copyright

# Qu'est-ce que Makagiga?

Gestionnaire de tâches, lecteur RSS, bloc-notes, widgets, visualiseur d'image...

Makagiga est une application libre, gratuite, facile à utiliser, multi-platformes pour accomplir une variété de tâches, telles que l'édition de texte, des listes de tâches "à-faire", la lecture de fils RSS, et la simple visualisation d'image. Des extensions sont utilisées pour implanter de nombreuses autres possibilités. Il peut importer/exporter un fichier, sauvergarder des fichiers, faire des recherches Internet (Google, Wikipedia), et plus.

# Requis

Makagiga requiert un Java Runtime Environment ("Java") compatible avec Sun Java(tm) Standard Edition 6.0 (SE 6). Actuellement, seuls Linux et Windows 200x/XP sont officiellement supportés par le projet Makagiga. De toutes façons, vous pouvez essayer de lancer Makagiga sur les plate-formes suivantes : MacOS X, Solaris, Windows 9x, ... Vous pouvez vérifier votre version de Java en ligne.

# Installation

Note: Quitter Makagiga avant de démarrer l'installation.

## Installation de Java

### Générique

1. Télécharger le Java Runtime Environment (JRE) pour votre système d'exploitation
2. Voir Installation Instructions si vous ne savez pas comment l'installer

### Ubuntu/Kubuntu

1. Lancer `sudo apt-get install sun-java6-jre` pour installer le Java Runtime Environment (cette commande requiert le mot de passe administrateur)
2. Si vous souhaitez compiler Makagiga depuis les sources, ou développer des extensions, vous devez aussi lancer `sudo apt-get install sun-java6-jdk ant gettext doxygen`. Cela installera Java Development Kit (compilateur), Ant (comme "make"), Gettext Utilities (requis pour construire les traductions de langage), et Doxygen (générateur de documentation API). Vous pouvez aussi installer gratuitement et librement NetBeans IDE...

## Paquet Debian/Ubuntu - *.deb file

1. Lancer`sudo dpkg -i makagiga-YOUR_VERSION.deb` pour installer (requiert le mot de passe administrateur)
2. Lancer `sudo dpkg -r makagiga` pour désinstaller

## Paquet RPM - *.rpm file

1. Run `su -c "rpm -Uvh makagiga-YOUR_VERSION.rpm"` pour installer (requiert le mot de passe administrateur)
2. Run `su -c "rpm -e makagiga"` pour désinstaller

## Paquet Zippé - *.zip file

1. Décompresser: `unzip makagiga-YOUR_VERSION.zip`
2. Changer de répertoire: `cd makagiga-YOUR_VERSION`
3. ...lancer: `./run.sh`
4. ...ou installer: `./install.sh`
5. L'application sera installée dans le répertoire par défaut `/usr/local`. Pour changer le répertoire d'installation, utiliser la commande suivante : `./install.sh /my_prefix/my_apps`.
6. Lancer `YOUR_PREFIX/makagiga/uninstall.sh`, pour désinstaller

## Fichier Setup - *.exe file

Lancer `makagiga-YOUR_VERSION.exe` pour installer. Utiliser Control Panel pour désinstaller.

## Comment démarrer ? (Linux)

1. METHOD #1: Lancer la `makagiga` commande
2. METHOD #2: Sélectionner la Makagiga commande depuis le menu KDE/GNOME (Office section)

# Configuration

## Application portable

Depuis la version 1.9.1 Beta vous pouvez lancer Makagiga directement depuis un support de stockage inscriptible et amovible (disque USB ou carte flash). Pour cela, décompresser simplement le fichier `makagiga-VERSION.zip`, puis lancer `run-portable.bat` (Windows) ou `run-portable.sh` (Linux). Tous les fichiers de données seront stockés dans le même répertoire où Makagiga était décompressé. Si tout est OK, vous devez inscrire le texte "[Portable]" dans le titre de la fenpetre principale.

## Profils

Pour démarrer avec un profil personnalisé, vous devez utiliser l'option de ligne de commande`--profil`, ou la varible d'environnement `MAKAGIGA_PROFILE`. Noter que le "Nom du profil" est un nom de répertoiree, aussi il ne peut contenir "/", "\", "." ou autres caractères illégaux. Tous les profils sont stockés dans le répertoire utilisateur (e.g. `~/.makagiga/profiles`).

Exemple 1: `makagiga --profile "Nom du Profil"`

Exemple 2: `export MAKAGIGA_PROFILE="Nom du Profil"; makagiga`

Pour changer de répertoire avec les fichiers utilisateurs, vous devez utiliser l'option de ligne de commande `--user-files`, ou la variable d'environnement `MAKAGIGA_USER_FILES`. Le répertoire "fichiers utilisateur" doit déjà exister.

Exemple 1: `makagiga --user-files "/home/foo/Makagiga"`

Exemple 2: `export MAKAGIGA_USER_FILES="/home/foo/Makagiga"; makagiga`

Note: Vous ne pouvez pas utiliser à la fois les options`--profile` et `--user-files`.

# Options de ligne de commande

Lancer `makagiga --help` pour afficher cette liste :

    --autostart     Démarrer l'application dans une fenêtre minimisée ou cachée
    --full-screen   Démarrer l'application dans une fenêtre plein écran
    --portable      Utiliser cette option si l'application  est stockées dans un périphérique de stockage inscriptible et mobile (disque USB ou carte flash)
    --presentation  Démarrer l'application dans le mode une fenêtre in full screen "presentation" mode
    --profile       Démarrer l'application avec un profil. Exemple: --profile "Nom du profil"
    --safe-mode     Démarrer l'application en mode sécurisé
    --user-files    Répertoire avec les fichiers de configuration et de données.
                    Exemple: --user-files "/home/foo/Makagiga"
    --version       Montrer info de version et quitter

# License & Copyright

    Makagiga - Copyright 2005 Konrad Twardowski
    Image Filters - Copyright 2006 Jerry Huxtable

    License sous la License Apache, Version 2.0 (la "License");
    vous ne pouvez pas utiliser ce fichier sinon en conformité avec la License.
    vous pouvez obtenir une copie de la License à

      http://www.apache.org/licenses/LICENSE-2.0

    À moins d'une réquisition par la loi ou d'un accord avec le rédacteur, le logiciel distribué sous la License est distribué "TEL QUEL",
    SANS GARANTIES OU CONDITIONS D'AUCUNE SORTE, qu'elles soient exprimées ou induites.
    See the License for the specific language governing permissions and
    limitations under the License.

    Artwork

    Makagiga Logo by Małgorzata Kiszka

    Le Thème Oxygen Icon
    Creative Common Attribution-ShareAlike 3.0 license
    or the GNU Library General Public License (with following clarification):

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

        This library 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
        Library General Public License for more details.

        You should have received a copy of the GNU Library General Public
        License along with this library; if not, write to the Free Software
        Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA  02110-1301 USA

    Clarification:

      The GNU Lesser General Public License or LGPL is written for
      software libraries in the first place. We expressly want the LGPL to
      be valid for this artwork library too.

      KDE Oxygen theme icons is a special kind of software library, it is an
      artwork library, it's elements can be used in a Graphical User Interface, or
      GUI.

      Source code, for this library means:
       - where they exist, SVG;
       - otherwise, if applicable, the multi-layered formats xcf or psd, or
      otherwise png.

      The LGPL in some sections obliges you to make the files carry
      notices. With images this is in some cases impossible or hardly useful.

      With this library a notice is placed at a prominent place in the directory
      containing the elements. You may follow this practice.

      The exception in section 6 of the GNU Lesser General Public License covers
      the use of elements of this art library in a GUI.

      kde-artists [at] kde.org

    "Emotion" Icon Set by Yellowicon Studio
    www.everaldo.com
    www.yellowicon.com

    Old Icon Theme
    by Everaldo Coelho
    and the KDE Team

    Duke: The Java Mascot
    Berkeley Software Distribution (BSD) License

    SourceForge.net Logo
    (C) SourceForge, Inc.

(C) 2005-3000 Konrad Twardowski