ce document est réactualisé automatiquement

===================================
\ w4lk_01L_GAZOLYNE MAJISTRAAL v801 /
===================================

Bienvenue
---------

:: w4lk_01L_Gazolyne_Majistraal :: système de publication en ligne ::

:: W4lk :: organisation, association, but non lucratif ;
:: 01L_Gazolyne_Majistraal : nom du logiciel ;
-- 01L : langage interne pro-html (principe des balises) ;
-- Gazolyne : nom du moteur vital, ou Operating System (OS) ;
-- Majistraal : nom de l'exclamation liée au succès des algorithmes itératifs.

:: Le visiteur :: ouvre une session et obtient une copie perdue du site ;
:: L'utilisateur :: peut se loguer pour publier si autorisé ;
:: L'Admin :: l'utilisateur ouvre son Hub, une version blanche du site complet, avec toutes ses fonctions de mise en forme et d'administration.
:: SuperAdmin :: le webmaster du serveur qui a installé 01L possède tous les pouvoirs sur les bases de données.


Overview
=========

:: WebNews :: Journal en ligne créé par un utilisateur
:: Hub :: nom du Node (noeud de réseau) créé par l'utilisateur
:: Usages :: permet de créer son espace de travail collaboratif, Blog, Journal, base de données...
:: Particularités ::
- programme complet 144 Ko
- rapidité d'exécution des pages
- topologie système innovante
- entièrement paramétrable
- capacités d'organisation
- système de champ temporel

Organisation
--------------

Topics :: nom des répertoires où sont classés une liste d'articles ;
Articles :: chaque article peut être complété d'autant d'autres ;
-- corrolaire => il faut créer un Topic avant de créer un premier article
Public :: Topic spécial qui reste ouvert au public visiteur.
Trackbacks :: l'Admin peut autoriser / gérer les commentaires libres ouverts au public liés à chaque article ;
:: Tags :: classement transversal permettant de lier des articles par des mots-clefs, accessibles ensuite dans la rubrique « articles voisins » ;
-- Certains tags sont reconnus par le System :
-- "Une" (avec la majuscule) :: met l'article à la Une en page d'accueil ;
-- "Stay" (maj) :: exclu l'article du champ temporel ;
-- "video" (sans accent) :: menu spécial activable ;

Le système d'étendue temporelle
---------------------------------

:: Périodicité :: durée du renouvellement des articles (mensuel, hebdo...) ;
-- définie d'après la fréquence des articles (seuil = 50) ;
-- les anciens articles sont accessibles depuis l'agenda ;
:: champ temporel :: peut être défini par l'utilisateur ;
-- fonction back_in_time :: (clic sur date) renvoie le curseur du champ temporel à cette date ;
-- function back_in_future :: (==) relod le cache à la date courante.
:: agenda :: permet de visualiser les articles publiés par jour ;
-- permet de signaler des articles à paraître dans le futur ;

Les menus système
--------------------

:: Hubs :: Vue globale de l'activité des Hubs ;
:: "Home" :: (avec majuscule) renvoie une vue générale des articles classés par catégories avec les articles à la Une ;
:: "home" :: (sans majuscule) renvoie tous les articles dans l'ordre tels qu'ils apparaissent dans le flux RSS ;
:: Gallery :: (désactivable) répertorie toutes les images enregistrées sur le serveur ;
:: Tracks :: (désactivable) répertorie les articles ayant donné lieu à des trackbacks ;
:: disk_space :: (désactivable) espace disque utilisateur, gestion des répertoires ;
:: Hidden :: (menu Admin) articles non publiés ;
:: System :: (menu Admin) articles cachés, ex: éditorials... ;

Les Plug-in
---------------

[inclusion d'applications dans les articles ou le System]

:: Petitions :: permet d'inclure une pétition avec mail de confirmation ;
-- Un Topic « Petitions » (sans accent) peut être créé pour engendrer une liste de pétitions
:: MicroChat :: système très rapide de discussion spontanée ;
-- limité aux 20 derniers messages ;
-- activable par la commande room_name:chat ;
-- page qui recense toutes les Rooms ;

La syntaxe locale 01L
-------------------------

:: but :: dissocier la mise en forme de la base de textes, ainsi allégée ;
:: fonctionnement :: les parties à traiter sont entourés (embed) de crochets ;
-- un paramètre à deux ou trois caractères affecte une fonction ;
-- les images et vidéos activent leurs fonctions d'affichage ;
-- ex: .jpg=>images || .mp4=>vidéo || .swf=>flash ;
-- 12 formats supportés ;
:: exportation :: en Output (mails) la syntaxe est masquée ;
:: importation :: Transductor 3.0 (livré avec 01L) encode les pages HTML, images, liens, mise en forme, tableaux ;
-- automatiquement lors d'une tentative d'insertion d'article comportant du code HTML ; hormis « object » et « embed » pour les vidéos en Flash ;

Actvités entre les Nodes :
-----------------------------

:: import :: l'utilisateur peut importer des articles visités vers son Node ;
-- option proposée à l'utilisateur logué ;
-- taper #0000 (ID) dans le titre ;
:: export :: copie d'un article vers un autre Hub ;
-- définition de l'emplacement Topic / Subject ;
:: internal_messages :: les utilisateurs peuvent communiquer entre eux ;
-- le visiteur peut laisser un message privé à l'Admin ;

Autres fonctions :
--------------------

:: login :: triple fonction :
-- identifie un utilisateur par mot de passe ;
-- reconnaît automatiquement un utilisateur enregistré ;
-- inscrit un utilisateur non connu ;
:: flux RSS :: syndication des articles selon une convention, au format XML ;
:: Tags :: permet de trier les articles d'un topic avec un mot-clefs ;
-- permet d'étendre cette recherche à tous les topics ;
-- permet d'initier une recherche sur ce mot ;
:: moteur de recherche :: classement d'articles par nombre d'occurrences trouvées ;
-- ne taper qu'un ou deux mots ;
-- (pas de bouton ?) Taper Enter ;
-- pour étendre la recherche au-delà du champ temporel, faire précéder la recherche du signe « + » ; ex: +w4lk ;
:: déploiement :: permet d'envoyer un article à un ou plusieurs mails enregistrés ou ajoutés ;
:: Gestion des articles :: nombreuses options de post-classement par :
-- topics -- titres -- tags -- par moteur de recherche ;
:: Board :: Message volatile, de bienvenue, ou édito ;
:: pub 1 || pub 2 :: espaces pour des annonces ;
:: photo_gallery :: [commande:répertoire] affiche une gallerie photo, construit les miniatures ;
:: web_radio :: [commande:répertoire] (java/flash/php) ouvre un lecteur avec playlist ;


MANUEL DE L'UTILISATEUR
========================

Utilisation de l'Admin :
--------------------------

:: Le sous-menu "SuperAdmin" ::

-- [publication] :: autorise ou non l'utilisateur enregistré sur le réseau à créer des nouveaux topics / articles : dans ce cas le menu [add_topic] reste disponible.
-- [trackback] :: autorise le visiteur à laisser des commentaires associés aux articles ;
-- [public] :: autorise la publication d'articles au visiteur dans le menu 'public';
-- [time_system] :: permet de désactiver la fonction de champ temporel - et donc le calendrier ; affiche tous les articles.
-- [2-cols] :: permet de passer de 3 à 2 colonnes (gauche et centre).
-- [Preview] :: permet de désactiver la prévisualisation des articles dans un Topic ;
-- [shadow] :: active les ombres .PNG ; fichier choisi dans [config] ;
-- [charts] :: affiche le menu articles les plus visités ;
-- [tags] :: affiche le système de Tags ;
-- [detourage-img] :: active l'écoulement du texte autour des images ;
-- [gallery] :: active la gallerie Photo ;
-- [tracks] :: affiche le menu Tracks : articles ayant donné lieu à des trackbacks ;
-- [chrono-order] :: tri chronologique ou alphabétique des articles ;
-- [recents] :: affiche le menu des articles récents ;
-- [chat] :: affiche une Room de micro_chat nommée « pub » ;
-- [disk_space] :: ouvre au public l'accès à l'espace disque ;
-- [hub] :: permet de fermer le menu des Hubs ;
-- [pager] :: permet l'accès à l'interface simplifiée pour les mobiles ;
-- [longtopics] :: déplace les menus dans une colonne, pratique pour les longs titres ;
-- [folders] :: affiche les articles groupés en dossiers ;
-- [openlog] :: permet de fermer le formulaire de log-in ;
-- [restricted_area] :: interdit aux visiteurs l'accès aux articles ;
-- [see_also] :: affiche les articles voisins à la suite de l'article ;
-- [videos] :: navigue dans le dossier Videos du serveur et du Hub ;
-- [plug-in] :: liste des plugs-in ;
-- [art_backup] :: sauvegarde de la base de données à partir d'un ID ;
- SuperAdmin -
-- [master_config] :: (SuperAdmin) Hub d'accueil, dossier images, serveur, hub d'accueil, système de stats ;
-- [master_backup] :: (SuperAdmin) sauvegarde des bases de données via System ;
-- [master_dump] :: (SuperAdmin) sauvegarde ciblée des BD via Dump ;
-- [w4lk_network] :: répertoire-maître des sites 01L ;
-- [update_software] :: mise à jour des fichiers système depuis le Master_Server ;

:: Les menus Admin ::

-- [config] : configuration du node :
--- largeur_colone: [numeric_value] largeur de la page en px ;
--- first_menu: [Home] (défaut) [home][public][value] ;
--- bkg_fixed: [yes][no] ;
--- png_shadow: [yes][no] -- se réfère aussi à "png_clr" dans config : valeur de 0 à 5 ; ex: imgb/_mbr0.png ;
--- color_set: [node_name] ;
--- node_mode: [webnews] (defaut) [blog] (système simplifié: pas de menus) ;
-- [create_topic] : permet de créer un nouveau Topic (répertoire) ;
-- [email] :: modifie l'e-mail de l'Admine du Node ; disponible via "contact" ; est utilisé pour le rappel des identifiants ;
-- [ban] :: upload de la bannière, au format ".jpg" ;
-- [bkg] :: upload l'image de fond de page, au format ".jpg" ;
-- [Avatar] :: choix d'un avatar dans une collection proposée au format ".gif" ;
-- [descript] :: mots-clefs signalés aux moteurs de recherche (META) ;
-- [board] :: message d'accueil ; accepte le HTML ;
-- [links] :: liste des sites web amis ; système de classement et renommage ;
-- [feeds] :: liste des flux RSS INPUT ; incorpore le flux dans le site ;
-- [deploy] : envoi groupé d'un article via mail from contact ;

-- [My_arts] : articles publiés par l'utilisateur dans le Node ;
-- [All_arts] : articles publiés par les autres utilisateurs que l'Admin ;
-- [Hidden_arts] : articles non publiés ;
-- [System_arts] : articles à faire monter dans les panneaux ou dans d'autres articles ;
-- [disk_space] : espace disque utilisateur ; racine: /users/node_name/ ; utile pour les galleries photo, les vidéos, et la web_radio ;

:: Changer les couleurs du site ::

-- [txt] :: couleur texte de page ;
-- [bkg] :: couleur du fond de la page ;
-- le paramètre yes/no dans dans [config][bkg_fixed] fixe l'arrière-plan ;
-- [border] :: couleur des contours ;
-- [cadr_bkg] :: couleur du fond des cadres ;
-- [system_bkg] :: couleur de fond des bouttons et parties logistiques ;
-- [syst-color] :: couleur des lettres du système ;
-- [msg_bkg] :: couleur du fond des articles ;
-- [msg_color] :: couleur du texte des articles ;

-- [reset_color] :: efface tous les attributs de couleurs ;
-- [memorize][->] :: sauvegarde un Setting le temps des ajustements ;
-- [restore] :: restaure un Setting de couleurs précédemment sauvegardé ;
-- [designs] s'approprie les couleurs d'un autre hub et les enregistre ;
-- [config][color_set] :: fait hériter du design d'un autre Hub sans effacer le setting_local ;
-- [css] :: affiche la page CSS créée
-- [refresh] :: s'assure que le fichier css a été mis à jour lors du dernier réglage ;


Edition des articles
----------------------

:: accessible à l'auteur / Admin / Master_Admin ::

-- [edit] :: permet d'éditer l'article ;
-- [tits] :: permet d'éditer le titre / classement (Topic) / première image (visible dans la liste) ;

:: création d'un article ::

-- prévu pour insérer dans l'ordre texte, images, texte, vidéos, OK ;
-- [Publish] :: incorpore l'article dans le tri logiciel des visiteurs ;
-- [keyworks] :: affecter des Tags ;
-- [date] :: date de parution ; peut être dans le futur ;

:: upload_medias ::

-- Vidéos [.mp4][.m4a][.mov][.mpg] / [.wmv][.asf][.asw] / [.rmv][.ram][.rm] ;
-- Images [.jpg][.png][.gif] ;
-- Audio [.mp3] ;
-- Flash [.swf] ;
-- ... ou pointer vers un lien externe ;

:: auto_upload des images :: !!innovation!!

-- Entourer l'URL html de l'image des crochets (syntaxe des connecteurs) ex: [http://url.com/image.jpg]
-- Au moment de l'insertion, l'image est uploadée et renommée puis signalée (hub_ID_name) ex: [blog_12_image.jpg]
-- si l'image refuse d'être copiée, revenir au formulaire habituel d'upload


Mise en forme du texte – syntaxe locale
-------------------------------------------

-- EMBED :: (entourer) le bloc avec des crochets ou/et accolades.
-- Après un enregistrement ou un upload, la syntaxe d'un lien ou d'un Media est ajoutée automatiquement.
-- 01L recrée ensuite la mise en forme HTML ;

:: exemples ::

- activer un media (externe) : [http://.../video.mpg] => affiche un player vidéo ;
- signaler une URL : [http://.../url.html/] => renvoie un hyperlien ;
- associer une URL et un texte (§) : [http://...lien§cliquez ici] ;
- faire un lien vers un média (eh oui!) il faut utiliser l'extension ":w" => [http://.../video.mpg:w] ;
- activer un mail : [mail@mail.com]
- mettre en citation dans un cadre (accolades) :

citation

;

- l'extension ":t" formate le bloc en H2 : [Titre:t]
- l'extension ":b" formate le bloc en gras : [Bold:b]
- l'extension ":i" formate le bloc en italique : [Italique:i]
- l'extension ":c" colore le bloc (couleur 4) : [Color:c]
- l'extension ":u" permet de souligner le bloc : [Underscore:u]
- pour d'autres options voir les Plugs-in ;

:: Faire des tableaux ::

-- structure HTML :: (table)(tr)(td)(/td)(/tr)(tr)(td)(/td)(/tr)(/table) ;
-- structure 01L :: [ | ¬ | ] ;

-- exemple :: trois colonnes se signalent avec 2 séparateurs TD :
[ 1 | 2 | 3 ¬] ; (il doit y avoir au moins 1 "¬" pour activer le tableau)
-- idem pour les lignes (¬) ;
-- Il doit y avoir le même nombre de séparateurs verticaux (|) entre chaque séparateur horizontal (¬) ;
-- exemple 3 par ligne :
[ hg | hm | hd
¬mg | mm | md
¬bg | bm | bd ] ;

:: traitements de texte ::

- Au moment de l'insertion, mettre un espace avant le lien HTML pour l'activer du premier coup ;
- plusieurs [continue_to_edit] suppriment les espaces en début de ligne ;
- [clean_mail] corrige les sauts de lignes tous les 127 caractères des emails ;
- [clean_br] réduit la quantité de sauts de ligne ;
- [repair] corrige les erreurs typographiques courantes ;

:: Connecteurs ::

-- [1234:pub] :: (N° d'ID de l'article) renvoie un lien vers l'article ;
-- [1234:read] :: fait monter le texte d'un article ;
-- [name:plug] :: active un plug-in ;
-- [word:rech] :: renvoie résultat de recherche - hors champs temporel si "+word" ;
-- [file:scan] :: fait monter un texte au format file.txt situé dans users/txt/ (voir disk_space);
-- [name:chat] :: crée une Room de Chat et affiche son terminal sur place ;
-- [rep:radio] :: désigne un répertoire comme web-radio ;
-- [rep:gallery] :: utilise un répertoire comme gallerie-photo avec miniatures ;

:: transductor 4 ::

- [format_html] transcode le HTML en 01L ;
- protocole de conversion :
-- h1, h2, h3 => :t ;
-- bold, strong => :b ;
-- italic => :i ;
-- undescore => :u ;
-- red text => :r ;
-- stabilo (color #4) => :s ;
-- blocquote =>

citations

;
-- liens html => [url§texte]
-- images => [url] => importe image si http ;
-- tableaux => :b ;

-- hormis ce système aucun autre ne permet l'homogénéité de la présentation et à la fois la conservation des attributs de ise en forme, inclus les images et les liens ;
-- opération de séparation du texte et de la mise en forme, vers des attributs génériques ;

-- Définitions ::
- Le système sait pointer vers une URL et extraire les données ciblées par des définitions, qu'il convient d'enregistrer de façon générique pour tous les ciblages futurs vers ce site.
- 2 points (début et fin) de deux entrées (titre et corps) permettent d'obtenir du premier coup le matériel enregistrable sur la base : titre et texte formaté. Si l'utilisateur est logué, un champ permet d'envoyer ce résultat dans un des menus disponibles.

Cette fonction est spécialement utile en importation depuis le fil INPUT RSS, qui, quand il est incmplet (souvent il n'y a qu'une partie réduite du texte), permet de pointer, importer et convertir en une seule fois la source, après quoi il ne reste qu'à choisir le menu, et enregistrer.
(2 clics, record du monde, en se laissant la possibilité de faire mieux...)

Notions techniques utiles
----------------------------

-- largeur des images :: les images sont redimensionnées à la limite de la colone à partir de 70% de la largeur ;
-- encapsulement de vidéos :: s'il y a plusieurs vidéos sur une page, les suivantes sont 'encapsulées' pour éviter les plantages : cliquer sur [OPEN VIDEO] pour l'ouvrir ;
-- poids maximum des Médias qu'on peut uploader : 15Mo ;
-- les Flash s'affichent en 640*480, sur fond transparent.
-- la dernière ligne de chaque article est réservée à la source URL s'il y en a une, afin que la fonction "find_links" puisse répertorier l'ensemble des sources externes et les placer dans le menu "network".


Mises à jour
--------------

:: The Independant Daily WebNews :: [http://www.w41k.com] ;

-=-=-=-=-=-=-=-=-=-=
http://www.w41k.com/
w4lk::1995-2008 /
-=-=-=-=-=-=-=-=-=-=