kienan
/
AlternC
mirror of https://github.com/kienanstewart/AlternC.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Enleve la tres ancienne aide plus du tout à jour 

Commence le debian_compliance pour le panel.
Start to be broken !
This commit is contained in:
Alan Garcia 2013-02-18 11:39:46 +00:00
parent c9529d3e42
commit ce9ffb559e
12 changed files with 15 additions and 476 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
.gitattributes vendored
View File

@ -5,15 +5,6 @@
/COPYING -text
/DEBIAN_COMPLIANCE -text
/README -text
aide/bin/build.sh -text
aide/bin/frames.dsl -text
aide/brouteur.sgml -text
aide/domain.sgml -text
aide/ftp.sgml -text
aide/index.sgml -text
aide/sommaire.sgml -text
aide/stats.sgml -text
aide/test.sgml -text
awstats/Makefile -text
awstats/alternc-awstats -text
awstats/alterncawstats.conf -text

20
aide/bin/build.sh
View File

@ -1,20 +0,0 @@
#!/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

144
aide/bin/frames.dsl
View File

@ -1,144 +0,0 @@
<!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>

65
aide/brouteur.sgml
View File

@ -1,65 +0,0 @@
<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>

69
aide/domain.sgml
View File

@ -1,69 +0,0 @@
<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>

37
aide/ftp.sgml
View File

@ -1,37 +0,0 @@
<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 :
<graphic fileref="files/ftp_list.png" format="png"></>
Vous pouvez créer, par exemple, un compte ftp pour philippe, que vous hébergez sur
<literal>http://virtuel.org/philippe/</literal>
Pour cela, il suffit de cliquer sur "Comptes FTP" puis "Créer un compte FTP" et enfin,
entrez les paramètres de connexion, à savoir, un nom d'utilisateur, un mot de passe, et un répertoire.
<graphic fileref="files/ftp_add.png" format="png"></>
</para>
<para>
Philippe peut donc modifier les fichiers de son dossier en utilisant les paramètres suivants :
<programlisting>
Serveur ftp : "virtuel.org"
Nom d'utilisateur : "virtuel.org_philippe"
Mot de passe : "philpas"
</programlisting>
</para>
</sect1>
</chapter>

42
aide/index.sgml
View File

@ -1,42 +0,0 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY chap1 SYSTEM "sommaire.sgml">
<!ENTITY hlpftp SYSTEM "ftp.sgml">
<!ENTITY hlpdomain SYSTEM "domain.sgml">
<!ENTITY hlpbrouteur SYSTEM "brouteur.sgml">
<!ENTITY hlpstats SYSTEM "stats.sgml">
]>
<book lang="fr">
<bookinfo>
<title>AlternC, Documentation Utilisateur</title>
<authorgroup>
<author>
<firstname></firstname><surname>AlternC Development Team</surname>
<affiliation><address><email>tech@alternc.org</email></address> </affiliation>
</author>
</authorgroup>
<date>2002-06-11</date>
<releaseinfo>0.1</releaseinfo>
<abstract>
<para>Bienvenue dans l'aide en ligne d'AlternC.</para>
</abstract>
<keywordset>
<keyword>AlternC</keyword>
<keyword>Hébergement</keyword>
</keywordset>
</bookinfo>
&chap1;
&hlpdomain;
&hlpftp;
&hlpbrouteur;
&hlpstats;
</book>

24
aide/sommaire.sgml
View File

@ -1,24 +0,0 @@
<chapter id="Sommaire"><title>Introduction</title>
<sect1 id="i1.1"><title>Introduction à AlternC</title>
<para>AlternC est un logiciel de gestion d'hébergeur de sites Internet, d'emails, de
noms de domaines et de tout service web disponible pour le public. Ce
logiciel utilise des programmes comme apache pour serveur web ou postfix
pour le courrier électronique. Il fournit une suite logicielle écrite en php4
qui permet de gérer intégralement un serveur depuis une interface web,
et permet d'allouer à chaque utilisateur un certain nombre de ressources
sur le serveur. </para>
</sect1>
<sect1><title>Fonctionnement de l'aide en ligne</title>
<para>
Cette aide en ligne est accessible par le lien "aide en ligne" du bureau virtuel.
vous pouvez aussi cliquer sur les "?" situés dans le bureau virtuel pour avoir
une aide contextuelle sur la page en cours.
</para>
</sect1>
</chapter>

37
aide/stats.sgml
View File

@ -1,37 +0,0 @@
<chapter id="stats"><title>Les statistiques Web.</title>
<sect1 id="stats.1"><title>Introduction / Mode d'emploi</title>
<para>
Sur AlternC, vous pouvez héberger des domaines / sous-domaines, sur lesquels vous hébergez un ou
plusieurs sites web. Maintenant que votre site est en marche, vous souhaitez savoir qui va voir votre
site, d'où ils viennent, quelles pages sont les plus vues etc. Pour cela, vous pouvez utiliser l'outil
de génération de statistiques web.
</para>
<para>
Ce menu vous permet de demander la génération quotidienne de pages html dans un dossier de votre espace disque.
Pour créer un jeu de statistiques associé à votre site web, cliquez sur "Statistiques web" puis sur
"Créer un jeu de statistiques".
<graphic fileref="files/sta_add.png" format="png"></>
Ensuite, choisissez dans la liste le nom de domaine dont vous souhaitez obtenir des statistiques,
Choisissez la langue dans laquelle vous souhaitez que ces statistiques soit générées.
Enfin, Entrez le nom du dossier dans lequel vous voulez voir apparaitre les pages HTML de statistiques.
</para>
<caution>Notez qu'il faut attendre le lendemain pour voir apparaitre comme par magie les premiers
fichiers de statistique dans le dossier désigné. En effet, ceux-ci sont générés tous les matins.</caution>
<para>
Dès le lendemain, vous pourrez aller sur la page web du dossier contenant vos statistiques pour y retrouver
les pages générées:
<graphic fileref="files/sta_view1.png" format="png"></>
Une page index, contenant un résumé des visites par mois, ainsi qu'un graphique le représentant,
ainsi qu'une page par mois, détaillant les visites, les mots-clés utilisés sur les moteurs de recherche,
les liens vers le site etc.
<graphic fileref="files/sta_view2.png" format="png"></>
</para>
</sect1>
</chapter>

16
aide/test.sgml
View File

@ -1,16 +0,0 @@
<chapter id="Test"><title>Coucou</title>
<sect1><title>le Coucou premier</title>
<para>Juste histoire de tester les manipulations à effectuer pour créer un fichier d'aide </para>
</sect1>
<sect1><title>le coucou en second</title>
<para>
A voir donc
</para>
</sect1>
</chapter>

2
bureau/class/config.php
View File

@ -52,7 +52,7 @@ Merci de revenir plus tard.";
// FIXME: Some constant, we put them here so that we can change them later ;) LFS
define('ALTERNC_MAIL', "/var/alternc/mail");
define('ALTERNC_HTML', "/var/alternc/html");
define('ALTERNC_PANEL', "/var/alternc/bureau");
define('ALTERNC_PANEL', "/usr/lib/alternc/panel");
define('ALTERNC_LOGS', "/var/alternc/logs");
define('ALTERNC_LOCALES', "/var/alternc/bureau/locales");

26
debian/rules vendored
View File

@ -48,20 +48,22 @@ install: build
# Install
cp -r etc/* debian/alternc/etc
cp -r install/* debian/alternc/usr/share/alternc/install
cp -r bureau/* debian/alternc/var/alternc/bureau
mkdir debian/alternc/usr/lib/alternc/panel
cp -r bureau/* debian/alternc/usr/lib/alternc/panel
(cd src && $(MAKE) install DESTDIR=$(CURDIR)/debian/alternc)
# we don't use the full VERSION intepreted but only what's in the changelog
sed -i -e "s/@@REPLACED_DURING_BUILD@@/${MAJOR}/" debian/alternc/var/alternc/bureau/class/local.php
sed -i -e "s/@@REPLACED_DURING_BUILD@@/${MAJOR}/" debian/alternc/usr/lib/alternc/panel/class/local.php
echo ${VERSION} > debian/alternc/usr/lib/alternc/panel/class/.svn-infos
# Fix permisions
chmod 755 debian/alternc/etc/alternc
chmod 644 debian/alternc/etc/alternc/phpmyadmin.inc.php
# Group and user 1999 reference alterncpanel
chown -R 1999:1999 debian/alternc/var/alternc/bureau
chown -R 1999:1999 debian/alternc/usr/lib/alternc/panel
chmod 1733 debian/alternc/var/alternc/sessions
chmod -R 644 debian/alternc/var/alternc/bureau
chmod -R a+X debian/alternc/var/alternc/bureau
chmod -R 644 debian/alternc/usr/lib/alternc/panel
chmod -R a+X debian/alternc/usr/lib/alternc/panel
chown -R www-data:www-data debian/alternc/var/alternc/html debian/alternc/var/log/alternc debian/alternc/var/alternc/tmp
chmod a+x debian/alternc/usr/share/alternc/install/alternc.install debian/alternc/usr/share/alternc/install/dopo.sh debian/alternc/usr/share/alternc/install/mysql.sh debian/alternc/usr/share/alternc/install/newone.php debian/alternc/usr/share/alternc/install/reset_root.php debian/alternc/usr/share/alternc/install/upgrade_check.sh debian/alternc/usr/share/alternc/install/upgrades/*.php debian/alternc/usr/share/alternc/install/upgrades/*.sh
@ -91,7 +93,7 @@ install: build
install -m 644 po/fr/LC_MESSAGES/alternc-admintools.mo debian/alternc/usr/share/locale/fr/LC_MESSAGES/
# Remove helpers files from l18n dir
find debian/alternc/var/alternc/bureau/locales/ \
find debian/alternc/usr/lib/alternc/panel/locales/ \
-maxdepth 1 -type f -exec rm -f {} \;
# Remove CVS directories
/usr/bin/find debian/alternc -depth -type d -name CVS -exec rm {} -rf \;
@ -113,14 +115,14 @@ install: build
cd ..
# Copy the desk files
cp -r awstats/bureau debian/alternc-awstats/var/alternc/
find debian/alternc-awstats/var/alternc/ -depth -iname ".svn" -exec rm -rf "{}" \;
rm -f debian/alternc-awstats/var/alternc/bureau/locales/Makefile
cp -r awstats/bureau debian/alternc-awstats/usr/lib/alternc/panel
find debian/alternc-awstats/usr/lib/alternc/panel/ -depth -iname ".svn" -exec rm -rf "{}" \;
rm -f debian/alternc-awstats/usr/lib/alternc/panel/locales/Makefile
# Fix permisions
chown -R root:www-data debian/alternc-awstats/var/alternc/bureau
chmod -R 644 debian/alternc-awstats/var/alternc/bureau
chmod -R a+X debian/alternc-awstats/var/alternc/bureau
chown -R root:www-data debian/alternc-awstats/usr/lib/alternc/panel
chmod -R 644 debian/alternc-awstats/usr/lib/alternc/panel
chmod -R a+X debian/alternc-awstats/usr/lib/alternc/panel
touch debian/alternc-awstats/var/cache/awstats/.placeholder
chown www-data:www-data debian/alternc-awstats/var/cache/awstats
chmod 755 debian/alternc-awstats/var/cache/awstats