tagging 1.0 (for good)

.gitignore

@@ -10,3 +10,15 @@ debian/alternc.postrm.debhelper
 debian/alternc.substvars
 debian/files
 po/fr/LC_MESSAGES/alternc-admintools.mo
+stable-1.0/build-stamp
+stable-1.0/debian/.svnignore
+stable-1.0/debian/alternc
+stable-1.0/debian/alternc-slave
+stable-1.0/debian/alternc-slave.debhelper.log
+stable-1.0/debian/alternc-slave.postrm.debhelper
+stable-1.0/debian/alternc-slave.substvars
+stable-1.0/debian/alternc.debhelper.log
+stable-1.0/debian/alternc.postrm.debhelper
+stable-1.0/debian/alternc.substvars
+stable-1.0/debian/files
+stable-1.0/po/fr/LC_MESSAGES/alternc-admintools.mo

stable-1.0/.svnignore

+build-stamp
\ No newline at end of file

stable-1.0/README.en

+AlternC: Hosting software suite 
+=================================================
+
+Introduction
+------------
+
+AlternC is a software suite helping system administrators in handling
+Web Services management. It should be easy to install, based only on 
+OpenSource softwares. AlternC is GPL licensed.
+
+This software consist of an automatic install and configuration system,
+a web control panel to manage hosted users and their web services such
+as domains, email accounts, ftp accounts, web statistics ...
+
+Technically, AlternC is based on Debian GNU/Linux distribution, 'Sarge'
+version, and it depends on other softwares such as Apache, Postfix, 
+Mailman ... It also contains an API documentation so that users can
+easily customize their web desktop.
+
+This project native tongue is French. However, the packages are 
+available at least in French and English. They may also be available in
+other languages (Some Spanish or German translation is in the pipe...)
+depending on YOUR help on this part of the project.
+Some part of the documentation are only available in french for now, but
+will certainly be translated in a near future.
+
+AlternC was initially developped by system administrators at Lautre.Net,
+then other guys came and helped us, such as Globenet, Netaktiv, 
+Neuronnexion or Koumbit.
+
+Install
+------------
+
+For now, AlternC can be installed as a Debian package. This package 
+depends on other softs used by AlternC. Just add those lines to your
+/etc/apt/sources.list file : 
+
+ deb http://debian.alternc.org debian/
+ deb-src http://debian.alternc.org debian/
+
+then apt-get install alternc
+
+You may download and install additionnal plugins after installing AlternC.
+Let's go to the developper page for more information.
+
+	https://alternc.org/

stable-1.0/README.fr

+AlternC: Architecture pour serveurs d'hébergement
+=================================================
+
+Introduction
+------------
+
+AlternC est un ensemble de logiciels d'hébergement facile à utiliser,
+facile à installer, basé uniquement sur des logiciels OpenSource,
+AlternC étant sous licence GPL.
+
+Ce logiciel contient un système d'installation et de configuration
+automatique, ainsi qu'un panneau de contrôle accessible par le web, pour
+la gestion des utilisateurs et des services web (domaines, mails,
+comptes ftp, statistiques ...)
+
+Techniquement, AlternC se base sur la distribution Debian GNU/Linux
+'Sarge', et utilise d'autres logiciels tels Apache, Postfix, Mailman ...
+Il contient aussi une documentation d'API, permettant une
+personnalisation facile et rapide du bureau, le 'panneau de contrôle
+web' d'AlternC.
+
+La langue natale de ce projet est le Français. Cependant, le paquet
+debian contient le bureau en Français, Anglais, Espagnol. 
+Les traductions dans
+d'autres langues auront lieu si vous nous y aidez. La documentation
+n'est actuellement disponible qu'en Français, mais une traduction
+multilingue devrait arriver un jour ...
+
+AlternC est développé par les administrateurs système de l'Autre Net,
+les membres de l'Autre Net, ainsi que d'autres structures / développeurs
+parmis lesquels Globenet, Neuronnexion ou Koumbit. 
+
+Installation
+------------
+
+Pour l'instant, AlternC doit être installé en package Debian. Ceci prend
+soin d'installer AlternC lui-même est toutes ses dépendances. Pour
+télécharger les packages Debian d'alternc, veuillez insérer les linges
+suivantes dans votre fichier /etc/apt/sources.list
+
+ deb http://debian.alternc.org debian/
+ deb-src http://debian.alternc.org debian/
+
+lancez ensuite
+	aptitude update
+	aptitude install alternc
+
+Note: vous pouvez aussi installer les modules additionnels d'AlternC par
+la suite. Pour plus d'information, rendez-vous sur le serveur de 
+développement à l'adresse : 
+
+	https://alternc.org/
+

stable-1.0/aide/bin/build.sh

+#!/bin/sh
+
+# $Id: build.sh,v 1.1.1.1 2003/03/26 17:41:29 root Exp $ 
+
+cd /data/bureau/admin/aide/
+# BUILD HTML
+rm -rf html
+mkdir html
+docbook2html --dsl /data/bureau/admin/aide/bin/frames.dsl -o html index.sgml
+rsync files/ html/files/ -a
+rsync inline/ html/ -a
+cd ..
+
+# Construction du fichier langue : 
+# fr_FR : 
+cd /data/bureau/admin/locale/fr_FR/LC_MESSAGES
+msgfmt -o alternc.mo alternc.po
+cd /data/bureau/admin/locale/en_US/LC_MESSAGES
+msgfmt -o alternc.mo alternc.po
+

stable-1.0/aide/bin/frames.dsl

+<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
+<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL>
+]>
+
+<style-sheet>
+<style-specification use="docbook">
+<style-specification-body>
+
+(define %stylesheet-version%
+  "DocBook HTML Frames Stylesheet version 2.0")
+
+
+(define %stylesheet% "docbook.css");
+
+
+
+(root
+ (make sequence
+   (process-children)
+   (with-mode manifest
+     (process-children))
+   (make-dhtml-toc)))
+
+
+
+(define (make-dhtml-toc)
+  (make entity
+    system-id: "toc.htm"
+    (make element gi: "HTML"
+          (make element gi: "HEAD"
+                (make element gi: "TITLE" (literal "DocBook TOC"))
+                ($standard-html-header$))
+          (make element gi: "BODY"
+                (with-mode dhtmltoc
+                           (process-children))
+                )))
+  )
+
+
+
+
+
+
+
+(define (dhtml-toc-entry nd gilist)
+  (let*
+
+      (
+       (subdivnodes (node-list-filter-by-gi (children nd) gilist))
+       (subdivs (and (> (node-list-length subdivnodes) 0) (not (node-list=? nd (sgml-root-element))) ) )
+
+       )
+
+
+    (if (node-list=? nd (sgml-root-element))
+                                        ; SEQUENCE 1 : ROOT element
+        (make sequence
+              (make element gi: "NOBR"            
+	      (make element gi: "A"
+                    attributes: (list (list "HREF" (href-to (current-node)))
+                                      (list "TARGET" "right")
+                                      )
+                    (element-title-sosofo (current-node))
+                    )
+              (make empty-element gi: "BR")
+              (make element gi: "UL"
+		    attributes: (list (list "CLASS" "TOC"))
+                    (process-children))
+              )
+	      )
+                                        ; SEQUENCE 2 : Children elements
+      (make sequence
+            (make empty-element gi: "LI")
+            (make element gi: "NOBR"            
+            (make element gi: "A"
+                  attributes: (list (list "HREF" (href-to (current-node)))
+                                    (list "TARGET" "right")
+                                    )
+                  (element-title-sosofo (current-node))
+                  ))
+                                        ; DIV ENFANT :
+            (make element gi: "UL"
+		  attributes: (list (list "CLASS" "TOC2"))
+                  (process-children))
+
+            ) ; sequence
+      ) ; if node-list ...
+
+    ))
+
+
+
+
+
+
+
+
+
+
+(mode dhtmltoc
+      (default (empty-sosofo))
+
+      (element set (dhtml-toc-entry (current-node)
+                                    (list (normalize "book"))))
+
+      (element book (dhtml-toc-entry (current-node)
+                                     (list (normalize "part")
+                                           (normalize "preface")
+                                           (normalize "chapter")
+                                           (normalize "appendix")
+                                           (normalize "reference"))))
+
+      (element preface (dhtml-toc-entry (current-node)
+                                        (list (normalize "sect1"))))
+
+      (element part (dhtml-toc-entry (current-node)
+                                     (list (normalize "preface")
+                                           (normalize "chapter")
+                                           (normalize "appendix")
+                                           (normalize "reference"))))
+
+      (element chapter (dhtml-toc-entry (current-node)
+                                        (list (normalize "sect1"))))
+
+      (element appendix (dhtml-toc-entry (current-node)
+                                         (list (normalize "sect1"))))
+
+      (element sect1 (dhtml-toc-entry (current-node) '()))
+
+      (element reference (dhtml-toc-entry (current-node)
+                                          (list (normalize "refentry"))))
+
+      (element refentry (dhtml-toc-entry (current-node) '()))
+
+      )
+
+
+
+</style-specification-body>
+</style-specification>
+
+<external-specification id="docbook" document="docbook.dsl">
+
+</style-sheet>

stable-1.0/aide/brouteur.sgml

+<chapter id="browser"><title>Le gestionnaire de fichiers</title>
+
+<sect1 id="browser.1"><title>Introduction / Description</title>
+
+<para>
+Sur AlternC, vous disposez d'un espace disque personnel sur lequel vous pouvez installer vos
+domaines, sous-domaines, comptes ftp, statistiques web etc. Cet espace est en fait un dossier
+sur le serveur, dans lequel vous pouvez stocker des fichiers, mais aussi des sous-dossiers,
+afin d'organiser au mieux votre espace disponible.
+</para>
+<para>
+Afin de pouvoir modifier facilement vos fichiers, vous pouvez utiliser le FTP, en créant un
+compte sur votre bureau virtuel. Plus d'info sur le FTP dans <link id="ftp">la section FTP de l'Aide.</link>.
+Vous pouvez aussi utiliser le gestionnaire de fichier pour gérer vos fichiers directement depuis le
+bureau virtuel. Pour cela, dans le menu principal, cliquez sur "Gestionnaire de fichiers"
+</para>
+
+<para>
+Le gestionnaire de fichier permet de gérer l'ensemble de vos fichiers, à savoir :
+<itemizedlist>
+	<listitem><para>Créer Supprimer et Renommer des fichiers</para></listitem>
+	<listitem><para>Créer Supprimer et Renommer des dossiers / Sous-dossiers</para></listitem>
+	<listitem><para>Editer les fichiers présents dans le compte (fichiers textes, html ...)</para></listitem>
+	<listitem><para>Visualiser les fichiers du compte (html, images, document ...)</para></listitem>
+	<listitem><para>Télécharger l'ensemble de votre compte dans un fichier compressé (plusieurs formats supportés)</para></listitem>
+	<listitem><para>Accéder aux autres fonctions du bureau, tels la création de comptes FTP ou la protection de
+        dossier par nom d'utilisateur et mot de passe.
+        </para></listitem>
+</itemizedlist>
+</para>
+
+</sect1>
+
+<sect1 id="browser.2"><title>Paramètres du gestionnaire de fichiers</title>
+
+<para>
+Vous pouvez régler les préférences du gestionnaire de fichier en cliquant sur "Régler mes préférences"
+en bas du gestionnaire.
+<graphic fileref="files/browser_set.png" format="png"></>
+Les éléments ci-dessous peuvent être réglés :
+<itemizedlist>
+<listitem><para>Type d'affichage du gestionnaire (1 colonne de fichiers, 2 colonnes, 3 colonnes)</para></listitem>
+<listitem><para>L'affichage ou pas des icones des fichiers</para></listitem>
+<listitem><para>L'affichage ou pas des types des fichiers (image jpeg, page html, ...)</para></listitem>
+<listitem><para>Le format de compression utilisé pour téléchargé tout le site au format compressé. (zip, tgz, tar.z, tar.bz2 supportés)</para></listitem>
+<listitem><para>La largeur et la hauteur de la fenêtre de l'éditeur de fichiers.</para></listitem>
+<listitem><para>Si vous préférer aller à l'éditeur de fichiers ou au gestionnaire après la création d'un nouveau fichier.</para></listitem>
+</itemizedlist>
+</para>
+
+<para>
+</para>
+
+<para>
+</para>
+
+<para>
+</para>
+
+<para>
+</para>
+
+</sect1>
+
+</chapter>

stable-1.0/aide/domain.sgml

+<chapter id="domain"><title>Les Noms de Domaines</title>
+
+<sect1 id="domain.1"><title>Introduction / Installation d'un nouveau domaine</title>
+
+<para>
+AlternC propose de l'hébergement de noms de domaine personnels sur votre compte.
+Un nom de domaine est toujours de la forme quelquechose.tld. Exemple : <literal>virtuel.org</literal>, <literal>masociete.com</literal> etc.
+</para>
+<para>
+Un nom de domaine, pour être hébergé chez un hébergeur de site, doit être proprement installé. Pour cela, il faut procéder par étape :
+<orderedlist>
+	<listitem><para>Acheter le nom de domaine voulu chez un registrar.</para>
+	<example><title>Exemple de registrar</title>
+	<para>On peut acheter par exemple un domaine en <literal>.fr</literal> auprès d'un partenaire de <ulink url="http://www.nic.fr">l'AFNIC</ulink>,
+	ou un <literal>.com .org .net</literal> auprès de <ulink url="http://www.gandi.net">Gandi</ulink>
+	</para></example>
+	</listitem>
+	<listitem><para>Lors de l'achat du nom de domaine, préciser le nom des serveurs DNS d'AlternC au registrar.</para>
+	<example><title>Exemple de DNS</title>
+	<para>Chaque hébergeur dispose d'au moins 2 serveurs DNS. Votre hébergeur vous donnera les noms et adresse Internet des siens.</para>
+	<para>Exemple : ns1.alternc.net (80.67.172.5) et ns2.alternc.net (80.67.172.9)</para></example>
+	</listitem>
+	<listitem><para>Installer le domaine sur AlternC.</para>
+	<para>Une fois acheté et ses DNS corrects, le domaine peut être installé sur
+	AlternC. Pour cela, cliquez sur le lien "Ajouter un domaine" dans le bureau virtuel.
+	</para>
+	</listitem>
+        </orderedlist>
+</para>
+
+</sect1>
+
+<sect1 id="domain.2"><title>Configuration d'un domaine / sous-domaine</title>
+
+<para>
+Lorsque vous avez installé un domaine sur AlternC, vous pouvez choisir dans quel dossier
+de votre espace disque vous souhaitez connecter ce domaine, ou tout sous-domaine associé.
+Pour cela, Cliquez sur le domaine dans le menu de gauche. Cela affiche l'ensemble des
+sous-domaines installé. Vous pouvez ensuite modifier l'emplacement de ces sous-domaines,
+ou en créer de nouveaux.
+</para>
+
+<para>
+Par défaut, les sous-domaines suivants sont installés : (exemple pour <literal>virtuel.org</literal>)
+<itemizedlist>
+        <listitem><para><literal>virtuel.org</literal> Ce sous-domaine est en fait le domaine
+        lui-même. Vous pouvez choisir comment vous voulez rediriger le domaine lui-même.
+        Le plus simple est de le rediriger vers l'URL http://www.virtuel.org ou vers
+        le même dossier que www.virtuel.org</para></listitem>
+        <listitem><para><literal>www.virtuel.org</literal> Ce sosu-domaine correspond à l'adresse
+        qu'utiliseront la plupart des internautes, l'adresse www de votre site web. Vous pouvez donc
+        l'héberger sur un dossier local. Par défaut, c'est la racine (nommé /) de votre espace
+        disque qui recoit ce domaine.</para></listitem>
+        <listitem><para><literal>mail.virtuel.org</literal> Ce sous-domaine particulier recoit le webmail
+        de votre domaine. Vous pouvez donc accéder à votre mail par l'adresse <literal>http://mail.virtuel.org</literal>
+        Si vous souhaitez connecter le webmail sur un autre nom, détruisez ce sous-domaine et recréez-en un
+        en lui affectant le type "webmail".
+        </para></listitem>
+        <listitem><para><literal>admin.virtuel.org</literal> Ce sous-domaine particulier recoit l'interface
+        du bureau virtuel. Ainsi, vous pouvez administrer votre domaine directement depuis le domaine lui-même.
+        Si vous souhaitez connecter le bureau d'administration sur un autre nom, détruisez ce sous-domaine et recréez-en un
+        en lui affectant le type "bureau virtuel".
+        </para></listitem>
+</itemizedlist>
+</para>
+
+</sect1>
+
+</chapter>

stable-1.0/aide/ftp.sgml

+<chapter id="ftp"><title>Comptes FTP</title>
+
+ <sect1 id="ftp.1"><title>Introduction</title>
+
+<para>
+Le FTP est un moyen pratique de pouvoir échanger des fichiers entre un serveur et une
+machine connectée à Internet. Pour cela, il faut disposer d'un compte FTP sur le serveur,
+constitué d'un nom d'utilisateur et d'un mot de passe.
+</para>
+
+<para>
+Sur AlternC, vous pouvez créer des comptes FTP, en précisant le nom d'utilisateur, le mot de passe,
+et le dossier dans lequel sera connecté ce compte FTP. Ainsi, chaque compte pourra accéder à son dossier
+et ses sous-dossiers, en lecture et en écriture.
+</para>
+
+<para>
+Par exemple, si vous disposez des dossiers suivants dans votre compte :