Documentation
La documentation ci-dessous fait partie de la distribution de BeeBase. Elle est également disponible sous forme de PDF.
[ << ] | [ >> ] | [Sommaire] | [Table des matières] | [Index] | [ ? ] |
3. Pour commencer
Ce chapitre décrit le matériel et les logiciels nécessaires pour exécuter BeeBase sur votre ordinateur, l'installer, le mettre à jour, démarrer et quitter.
3.1 Installer BeeBase sur Windows | Windows 10 et suivants | |
3.2 Installer BeeBase sur Mac OS | Mac OS Big Sur et suivants | |
3.3 Installer BeeBase sur Linux | Ubuntu, Debian, Fedora... | |
3.4 Installer BeeBase sur Amiga | Amiga OS3, UAE, Amiga OS4, MorphOS, AROS | |
3.5 Mise à jour d'une version précédente | BeeBase a déjà été installé ? | |
3.6 Démarrer BeeBase | Depuis le bureau ou l'interface en ligne de commande | |
3.7 Quitter BeeBase | Lorsque vous avez terminé | |
3.8 Nomenclature | Nomenclature et variables d'environnement |
3.1 Installer BeeBase sur Windows
BeeBase pour Windows fonctionne sur les ordinateurs compatibles Intel qui utilisent les systèmes Windows 10 [et ultérieurs] (64 bit).
L'installateur de BeeBase est distribué sous la forme d'un exécutable Windows, par exemple : `BeeBase-1.0-setup-x64.exe' que vous pouvez télécharger sur la page d'accueil de BeeBase https://beebase.sourceforge.io. Pendant l'installation, de nombreuses questions vous seront demandées à propos de l'emplacement d'installation de BeeBase, et de sa configuration. Au cas où vous auriez une version précédente de BeeBase installée sur votre ordinateur, la procédure d'installation permet la mise à jour vers la nouvelle version.
Après une installation réussie, le menu `Démarrer' de Windows devrait contenir un nouveau raccourci vers BeeBase. Vous pouvez maintenant supprimer le fichier d'installation de BeeBase, il n'est plus nécessaire.
3.2 Installer BeeBase sur Mac OS
BeeBase pour Mac OS prend en charge macOS Big Sur (version 11) et les versions suivantes du système d'exploitation Mac OS. Le logiciel est distribué au format binaire universel qui contient des binaires 64 bits pour les processeurs Intel et Arm.
Une image disque de BeeBase, c.-à-d. `BeeBase-1.0.dmg', peut être téléchargée depuis le site https://beebase.sourceforge.io.
Après le téléchargement et l'ouverture de l'image, glissez-déposez `BeeBase.app' dans le dossier `Applications' de l'ordinateur.
3.3 Installer BeeBase sur Linux
Vous pouvez installer et lancer BeeBase sur un ordinateur compatible Intel fonctionnant avec le système d'exploitation Linux.
BeeBase pour Linux est distribué à la fois sous la forme d'un paquet Debian (p. ex. `beebase_1.0_arm64.deb' pour Ubuntu et Debian) et sous la forme d'une archive RPM (p. ex. `BeeBase-1.0-fc34.aarch64.rpm' pour Fedora).
Les deux versions peuvent être téléchargées à partir de la page d'accueil de BeeBase https://beebase.sourceforge.io.
Habituellement BeeBase s'installe ou se met à jour lui-même automatiquement après le téléchargement sur votre ordinateur. Dans le cas où l'installation ne se lancerait pas automatiquement, les commandes suivantes exécutées les droits du super utilisateur (root) depuis un interpréteur de commande installent ou mettent à jour BeeBase sur un système Linux sous Debian :
dpkg --install beebase.deb apt-mark hold beebase.deb |
où beebase.deb est le paquet Debian téléchargé.
Sur un système dérivé de Redhat (RPM) les commandes sont :
rpm -Uvh BeeBase.rpm |
où BeeBase.rpm est le fichier RPM de BeeBase téléchargé,
Après une installation réussie vous devriez voir un nouvel élément dans le menu `Applications - Office' de votre bureau Linux.
3.4 Installer BeeBase sur Amiga
BeeBase pour Amiga fonctionne sur la version 3.0 (ou supérieure) de l'OS Amiga et exige un processeur 68020 ou supérieur. En outre, la version 3.8 (ou supérieure) de MUI doit être présente sur votre système. Un minimum de 4 Mo de RAM et de 10 Mo d'espace libre sur votre disque dur sont nécessaires. On m'a signalé que le binaire m68k de BeeBase pour Amiga se lance également sur UAE, MorphOS et Amiga OS4.
Des exécutables natifs pour MorphOS, Amiga OS4 et i386/x86_64 AROS sont disponibles dans l'archive distribuée.
BeeBase est distribué sous forme d'une archive lha (p. ex. `BeeBase-1.0.lha') peuvent être téléchargées à partir de la page d'accueil de BeeBase https://beebase.sourceforge.io. Pour l'installer BeeBase sur votre ordinateur, vous devez décompacter ces archives dans un répertoire provisoire. Ne pas les décompacter dans le répertoire cible !
Double cliquez sur le script d'installation de BeeBase `Install-BeeBase' et suivez les instructions. Le script demande le répertoire où le logiciel doit être copié. N'indiquez pas le chemin d'accès du répertoire où vous avez décompacté l'archive de BeeBase. Le script est également capable de mettre à jour une installation existante de BeeBase, il suffit pour cela de lui fournir le chemin d'accès du répertoire où vous avez précédemment installé BeeBase.
Après une installation réussie, vous trouverez sur votre système le (nouveau) répertoire contenant le programme BeeBase avec tous les fichiers nécessaires et quelques échantillons de projets. De plus, une assignation `BeeBase:' se rapportant à ce répertoire a été rajoutée sur votre fichier système `S:User-Startup'. Vous pouvez enlever les archives lha et les fichiers temporaires, ils ne sont plus nécessaires.
3.5 Mise à jour d'une version précédente
En installant BeeBase sur Linux, Windows ou Amiga, vous pouvez mettre à jour la version précédente ou la réinstaller comme décrit ci-dessus. Pendant une nouvelle installation, tous les fichiers nécessaires sont remplacés. Ce qui inclus tous les échantillons de projets dans le répertoire `Démos' . Il n'est donc pas recommandé de placer vos propres projets dans ce répertoire, ni d'employer l'un de ces projets pour gérer vos propres données : elles risqueraient d'être écrasées pendant la réinstallation ou la mise à jour de BeeBase.
Il est recommandé de gérer vos propres projets en les plaçant dans un répertoire séparé du répertoire d'installation de BeeBase.
Si votre système contient une version de MUIbase, il est recommandé de la supprimer, afin que les associations de fichiers soient correctement affectées à BeeBase.
3.6 Démarrer BeeBase
BeeBase peut être démarré à partir de votre environnement graphique ou à partir de la ligne de commande. Sur Windows vous trouverez BeeBase dans le menu `Démarrer'. Sur Mac OS vous pouvez lancer BeeBase avec le `Finder' depuis le répertoire `Applications'. Si vous utilisez Gnome ou KDE sur Linux, vous pouvez démarrer BeeBase en choisissant l'entrée correspondante dans le menu `Applications - Office'. Sur le Workbench (Amiga), vous pouvez double-cliquer sur l'icône BeeBase ou sur l'icône du projet BeeBase qui se chargera automatiquement après avoir démarré BeeBase (vous pouvez également sélectionner plusieurs projets de BeeBase à l'aide de la touche shift puis double-cliquer sur le dernier).
En démarrant BeeBase à partir de la ligne de commande Windows, Linux ou Amiga vous pouvez inclure des arguments dans la ligne de commande et charger des projets optionnels. Il y a deux manières pour démarrer BeeBase à partir d'une commande shell :
BeeBase [projet1 ...] BeeBase -n |
La première forme démarre BeeBase et charge les projets optionnels spécifiés par leurs noms de fichiers project1 .... La seconde forme démarre BeeBase sans interface graphique. Ce qui peut être utile pour démarrer BeeBase comme serveur en tâche de fond et pour accéder à son interface externe (par exemple ARexx sur Amiga, voir Interface ARexx).
3.7 Quitter BeeBase
Pour quitter BeeBase sélectionnez l'entrée du menu `Projet - Quitter' ou fermez tous les projets ouverts.
3.8 Nomenclature de fichiers sur Windows, Mac OS et Linux
BeeBase pour Windows, Mac OS et Linux a quelques conventions spéciales pour les noms de fichiers qu'on ne trouve habituellement pas dans d'autres logiciels (sur ces systèmes).
Lorsque BeeBase démarre, une variable d'environnement `BeeBase' est créée. Elle indique le répertoire d'installation de BeeBase. Sur Windows c'est le répertoire spécifié durant l'installation du logiciel. Sur Mac OS, c'est le répertoire `/Applications/BeeBase.app/Contents/Resources/share/BeeBase'. Sur Linux, c'est le répertoire `/usr/share/BeeBase'.
Lors de l'interprétation des noms de fichiers (entrés par l'utilisateur ou ceux présents dans cette documentation), un nom de fichier est analysé à la recherche de variables d'environnement. Si un nom de fichier contient le signe dollar `$' alors les caractères suivants jusqu'au premier caractère non alphanumérique sont interprétés comme étant une variable d'environnement et, si cette variable d'environnement est positionnée, cette partie du nom de fichier est remplacée par le contenu de la variable d'environnement (autrement, la partie du nom de fichier, y compris le signe `$', reste inchangée). Vous pouvez mettre des parenthèses autour de la variable d'environnement si elle contient des caractères non alphanumériques. Par exemple `$HOME/fichier' est interprété comme le chemin d'accès où `$HOME' a été remplacé par le nom de votre répertoire personnel.
En outre, les `assignations' style Amiga sont manipulées de la façon suivante. Si un nom de fichier contient deux points `:' alors, tout ce qui se trouve avant les deux points est traité comme une variable d'environnement (appelée `assignation') et est remplacé par son contenu si la variable d'environnement est positionnée. Les `Assignations' devraient être au moins composées de 2 caractères, pour ne pas les confondre avec les noms des volumes Windows.
Ces conventions permettent, par exemple, de se référer à la base de données cinématographique d'exemple qui se trouve à l'intérieur du répertoire d'installation de BeeBase en utilisant `BeeBase:demos/Movie.bbs'.
Un autre exemple : lorsque vous avez positionné une variable d'environnement `EXTERNAL_DATA' pointant vers un répertoire où vous stockez les données externes d'un de vos projets (comme des images, etc. ). Vous pouvez alors accéder aux données à l'intérieur de ce répertoire en utilisant `EXTERNAL_DATA:un-fichier' et stocker de tels noms de fichier dans le projet de base de données.
[ << ] | [ >> ] | [Sommaire] | [Table des matières] | [Index] | [ ? ] |
Ce document a été généré le 30 Septembre 2024 par texi2html