Comprendre et utiliser Gong-He pour dévélopper des applications métiers dans le domaine de la production.

La version actuelle est la 3.0 qui utilise l'encodage utf-8 dans l'ensemble des modules. Les versions majeures précédentes correspondent aux évolutions suivantes :

• Gong-He 3.0 : 2010, Homogénéisation des modules et changement d'encodage. La documentation en ligne est accessibles et directement intégrée dans l'outil de visualisation du code source. Le changement d'encodage oblige à revoir les modules utilisant du texte, le passage en version 3.0 indique une différence majeure avec la version précédente.
• Gong-He 2.0 : 2005, Le système de balise est entièrement revu pour distinguer les balises ouvrantes et les balises fermantes, le moteur est réécrit pour augmenter les performances. La configuration des macros passe par l'inclusion systématique d'un fichier d'initialisation.
• Gung-Ho 1.0 : 2001, Système de publication de données hétérogène pour la mise en place d'un intranet de gestion des traitements Autosys, l'éditeur ne proposant pas de fonctions de récupération des logs dans son interface, Gong-He permet d'afficher les données issues de la base, récupérer les logs en FTP et en UNC, exécuter des commandes en lignes.
• Bidule 1.0 : 1997, Base Intranet de Documentation & Utilitaires en Libre-Echange, conçu comme base documentaire de l'équipe système mais finalement utilisé pour les cahiers de consignes de la Production. Cette version est en Perl ASP et apporte le système de tags que l'on retrouve dans le module Structure.

Principes

Gong-He est un langage macro permettant d'effectuer les opérations courantes tout en restant ouvert pour les opérations spécifiques à travers des modules génériques ou propre à l'application. Ce n’est pas un langage en soi car il ne permet pas de construire d’algorithme, cette partie étant prise en charger pas le langage d’interprétation.

Document : Principe de compétence, Utilisateur, Administrateur, Graphiste, Communauté, Respect des normes, Les dates, Le format de caractères, Système de fichiers, Structure Gong-He, Arborescence Applicative, Lecture de fichiers, Ecriture, Eléments de la macro, Les données, La macro, Les coquilles, Les peaux, Les filtres, Multilinguisme,

Installation

Gong-He utilise un serveur web apache.

Document : Pré-requis, Téléchargement, Mise en place, Installation Apache, Windows, Linux, Utiliser Azoth, Mercurial, Installation, Clone, Mises à jour,

Première macro

Document : Test.ghd, Appel, Arborescence,

Prise en main

Document : Blocs fonctionnels, Sauts de ligne, Fonctions, Bloc de texte, Paramètres, Résolution d’erreur, Macro incomplète, Log système, Traitement complémentaire, Cache, Fonctions PHP, Valeur nulle, Test de valeur, Mise en forme, Calculs,

Balises

Les balises délimitent les blocs de données à traiter, l'imbrication des blocs permet de réaliser des transformations complexes à partir d'un bloc de données initial.

Document : {$Variables$}, {!Commentaires!}, {<Chargement de données<}, {>Envoi de données>}, {~Liens~}, {?Formulaire?}, {"Texte"}, {*Tampon*}, {`Commandes systèmes`}, {#Images#},

{$Variables$}

Les variables permettent de stocker des valeurs, de les utiliser et de les évaluer.

Document : Initialisation et affichage, Passage en url, Valeur par défaut, Evaluer une variable, Tests interne, Utilisation du post-traitement, Types de variables, Variables utiles, Document, Langue, Temps d’exécution, Emplacements, Conflits de variables, {+ Initialisation +}, Initialisation par colonne : C, Initialisation par colonne indexé sur la ligne : C[R], Initialisation par ligne : R, Initialisation par ligne indexé sur la colonne : R[C],

{!Commentaires!}

Les commentaires sont des portions de texte qui ne seront pas traités.

Document : Informations sur la macro, Suppression des saut de lignes,

{<Chargement de données<}

Le chargement de données permet d'intégrer dans la macro des données externes.

Document : Sources, Fichiers, Réseaux, Base de données, Fichier, Ordre de lecture, Emplacement précis, Fichier de langue, Image, Principe de chargement, Images par défaut, Bibliothèque d’images, Url, Appel à travers un proxy, Base de données,

{>Envoi de données>}

L'envoi de données permet d'extraire les données de la macro pour les stocker à l'extérieur.

Document : Fichiers, Base de données, Mail,

{∼Liens∼}

Document : Lien http, Lien Gong-He, Paramètres GH, Cible interne,

{?Formulaires?}

Les fonctions de formulaires proposent les moyens d’envoyer des arguments au serveur qui soient les plus appropriés au type de données.

Document : Form, Get, Post, Text, Password, Hidden, Textarea, Boutons Radio, Cases à cocher,

{"Texte"}

La balise texte permet de traiter les zones de texte avant affichage.

Document :

{*Tampon*}

Le tampon est une variable particulière exclusivement utilisée avec des fonctions. Elles sont obligatoirement initialisées dans la macro.

Document : Gabarit, Tampon nommé,

{`Commandes systèmes`}

Les commandes systèmes sont pratiques mais nécessite une protection de votre site web (authentification, gestion de groupes…), dans le cas contraire, il est fortement conseillé de le désinstaller en désactivant le module exec.

Document :

{#Images#}

Les images sont un cas particulier de Gong-He car elles ne peuvent pas être traitées comme des blocs données. On conserve donc les différentes informations dans un tampon relatif au nom de l’image.

Document : Création et affiche de l’image, Nouvelle image, Affichage, Transformations, Redimensionnement, Ajout de texte,

Mise en page

Comment mettre en forme, mettre en page et publier une macro Gong-He.

Document : Gabarits, Charte graphique, Création d’un gabarit, Installation, Télécharger un kit graphique, Mise en place,

Bibliothèque

Compare la liste des versions de modules sur Gong-He.net avec la liste locale.

Document : Macros de maintenance, CheckModules, LDAP, OCI8, pear, CheckUdate, Macros de présentation, Gabarits, Pages standards, Macros de développement, Syslog, Initialisation, Coquilles de données, Page HTML, Fichier texte, Feuille Excel, Envoi de mail, Coquilles de macro, Fichier source, Référence, Edition, Sauvegarde, Coquilles graphiques, Format SVG, Vignette,

Modules

Un module est un simple fichier PHP stocké au niveau de gong-he s’il s’agit d’un module inclus dans la distribution ou dans le répertoire application si il s’agit d’un usage spécifique.

Document : Liste, AnyGantt, Calendar, Colors, Core, DHTML X, Data, Databases, Dates, Doc, Exec, FTP, File, Form, Graphviz, Html, Image, Javascript, LDAP, Lang, Mail, Module, MojoZoom, MySQLi, Network, OCI8, Package, SQL, SSH2, Search Engine, Security, Sheet, SimpleGraph, SimpleXML, Skin, Socket, Structure, TCPIP, Template, TimeCode, Url, Variables, Yahoo, ZGRViewer, Zip, doconline, jil, pear, svg, texy, twitter,

Sécurité

La sécurité passe par 2 états : l’authentification et les permissions, la première étape permet de vérifier qu’un utilisateur dispose d’un compte permettant de se connecter sur le système, la deuxième étape est l’affectation des droits.

Document : Authentification, Login et Mail, Mot de passe, Mécanisme, Autorisations, Accès aux fichiers, Règles Apache, Protection par htaccess,

Développement

Ce chapitre indique comment développer des fonctions à travers les modules Gong-He.

Document : Modules, Création du module, Filtres, Fonctions, Appel de fonction, Variables par défaut, Traitements des données, Remontée d’erreur, Blocs particuliers, Champs de formulaire, Intégration de données, Images, Javascript, Copie de script, Intégration, Binaires, Validation de module,

Participer

Il existe différents moyens de contribuer de contribuer au projet en fonction de ses compétences et de son implication.

Document : Développeurs, Graphistes, Utilisateurs,

Aide

Comment s'en sortir ?

Document : Aide en ligne, Gong-He.net, Communauté, Derniers messages du forum, Re : Fonction Inlike et caractère d'échappement, Re : Fonction Inlike et caractère d'échappement, Re : Fonction Inlike et caractère d'échappement, Fonction Inlike et caractère d'échappement, Suivi du développement,