Giters

PierreAmmeloot / NodeAtlas

NodeAtlas is a MVC(2) JavaScript Framework Server-side that allows you to create Scalable website with SEO and W3C compliancy.

Home Page:http://node-atlas.js.org/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

node-atlas

Framework Javascript Serveur Évolutif par configuration ou APIs pour créer facilement des maquettes, sites ou applications web temps réel orientés composants et services.

NodeAtlas est un Framework Web MVC(2) côté serveur vous permettant de créer des sites évolutifs, conformes au W3C et bonnes pratiques SEO. Il permet de faire tourner des pages localisables et indexables ou de créer des maquettes HTML uniquement avec des vues. Mais activer les contrôleurs permet de développer de puissantes applications web orientées données et composants ou orienté service avec des fonctionalités modernes et temps réel !

For an international version of this document, follow this link.

Faites un don Travis CI Version 2.0.0-beta Package NPM Node.js Technical Debt Ratio Dependency Status Chat pour de l'Aide

NodeAtlas c'est :

  • La porte d'entrée aux Développeurs Front-end dans le monde de Node.js.
  • Du tout JavaScript ; pour les débutants venant du monde PHP, .NET, Ruby... ou pour les experts JS.
  • De l'évolutivité avec :
    • des vues sans se préoccuper des contrôleurs,
    • la prise en main progressive de contrôleurs et points d'ancrage,
    • de l'internationalisation (i18n) et de la localisations (l10n) rapide,
    • la puissance d'Express.js (serveur web) et Socket.io (échange client-serveur temps réel) pré-configuré, simple et ajustable,
    • les préprocesseurs EJS, PUG (JADE), Less et Stylus embarqués et prêt à l'emploi,
    • des outils interne de génération HTML serverless ou de bundles, minifications, offuscations, optimizations de CSS, JS et images,
    • encore ; de la manipulation de DOM côté serveur jQuery-like, du debug serveur dans le navigateur, de l'HTTPs facile à mettre en place.
  • De la combinaison d'instance NodeAtlas pour des architectures basés sur le service comme l'utilisation sous forme d'API REST,
  • Tous les modules NPM, middleware Express.js/Socket.io, des plugins utilisables (sessions, bases de données SQL/NoSQL, répartition de charge, proxy, développement à chaud).
  • Un guide pas à pas Français et International, avec un support communautaire sur Gitter (Chat) FR/EN.
  • Des passionnés de web et de JavaScript <3 !
  • Et peut-être bientôt vous ?

Site Officiel de NodeAtlas

Pour une documentation complète, vous pouvez vous rendre sur le Site Officiel de NodeAtlas (README.md mirroir ici).

Utilisation

Étape 1 - Installation

Installer NodeAtlas avec l'une des deux méthodes suivantes :

  • npm install node-atlas recommandée pour une utilisation en tant qu'API.
  • npm install -g node-atlas recommandée pour une utilisation à la ligne de commande.

Étape 2 - Configuration

Créer un fichier webconfig.json et ses fichiers de dépendances pour configurer votre site.

website.json exemple pour le développement :

{
 "languageCode": "en-gb",                /* Définir la langue principale. */
 "pageNotFound": "/page-404/",           /* Assigner une vue dédiée à la page 404. */
 "commonView": "common.htm",             /* Assigner le layout global aux vues. */
 "commonVariation": "common.json",       /* Assigner les fichiers de variations communes pour la localisation. */
 "commonController": "common.js",        /* Assigner les fonctions du contrôleur appelé sur toutes les pages. */
 "postSupport": false,                   /* Par défaut, empêcher les requêtes de page en POST. */
 "bundles": "bundles.json",              /* Définir les fichiers CSS et JS concaténés ensemble et minifiés dans un fichier exterieur. */
 "optimizations": "optimizations.json",  /* Définir les images à optimiser pour le web dans un fichier extérieur. */
 "htmlGenerationBeforeResponse": true,   /* Générer la page couramment affichée dans le dossier "serverless". */
 "stylesheetsBundlesEnable": true,       /* Minifier les CSS dans des fichiers ".min" avant de renvoyer la page. */
 "javascriptBundlesEnable": true,        /* Offusquer les JS dans des fichiers ".min" avant de renvoyer la page. */
 "enableLess": true,                     /* Utiliser des fichiers Less avec des fichiers ".map" pour la partie développement. */
 "routes": "route.json"                  /* Définir toutes les urls fournis par le site dans un fichier extérieur. */
}

website.prod.json exemple pour la production :

{
    "httpPort": 7777,                       /* Définir le vrai port HTTP pour l'application si le port 80 est déjà écouté. */
    "urlPort": 80,                          /* Définir le port d'accès pour l'application depuis le net (proxy). */
    "httpSecure": "security/server",        /* Définir le répertoire où trouver les fichiers "server.key" et "server.crt" pour le HTTPs. */
    "urlHostname": "www.my-website.com",    /* Définir le hostname pour l'application sur le net. */
    "urlRelativeSubPath": "example",        /* Définir un sous dossier d'exécution pour l'url de l'application. Par exemple : "https://www.my-website.com/example/". */
    "languageCode": "en-gb",
    "pageNotFound": "/page-404/",
    "commonView": "common.htm",
    "commonVariation": "common.json",
    "commonController": "common.js",
    "postSupport": false,
    "routes": "route.json",
}

routes.json example:

{
    "home": {                               /* Définir une clé à utiliser comme référence pour manipuler les paramètres définis ou d'url dans le code. */
        "url": "/",                         /* Définir l'url d'accès à la page derrière cette route. */
        "output": "home.html",              /* Définir le chemin d'accès pour enregistrer le rendu au format HTML de manière statique. */
        "view": "home.htm",                 /* Assigner une vue utilisée pour présenter l'information. */
        "variation": "home.json",           /* Assigner une variation spécifique utilisée pour localiser la page. */
        "controller": "home.js"             /* Assigner un contrôleur spécifique utilisé pour la page d'accueil (afficher les derniers articles, le nombre d'inscrit, etc.). */
    },
    "presentation": {
        "url": "/presentation/",
        "output": "presentation.html",
        "view": "default.htm",              /* Même vue utilisée avec... */
        "variation": "presentation.json"    /* ...une variation différente pour générer du contenu de page différent (voir "error"). */
    },
    "members": {
        "url": "/members/",
        "output": "members.html",
        "view": "members.htm",
        "variation": "members.json",
        "controller": "members.js"
    },
    "memberV2": {                           /* Une nouvelle version de rendu pour les pages "member". */
        "url": "/members/:member/",         /* La partie ":member" représente le membre courrament demandé... */
        "output": "members/bob.html",       /* ...et un faux utilisateur est utilisé pour un rendu statique dans le dossier des fichiers générés. */
        "view": "member.htm",
        "variation": "member.json",
        "controller": "member.js"
    },
    "member": {                             /* La vieille version de des pages "memberV2"... */
        "url": "/members-profile/:member/", /* ...avec une vieille route... */
        "redirect": "/members/:member/",    /* ...conservée pour rediriger sur la nouvelle page... */
        "statusCode": 301                   /* ...de manière permanente. */
    },
    "contact-us": {
        "url": "/contact-us/",
        "output": "contact-us.html",
        "view": "contact-us.htm",
        "variation": "contact-us.json",
        "controller": "contact-us.js",
        "postSupport": true                 /* Permettre d'accéder à la page par demande en POST pour envoyer un email avec un formulaire. */
    },
    "home-fr-fr": {
        "url": "/francais/",
        "output": "francais/bienvenue.html",
        "view": "home.htm",
        "variation": "home.json",
        "controller": "home.js",
        "languageCode": "fr-fr"             /* Un code de langue spécifique pour cette page. */
    },
    "presentation-fr-fr": {
        "url": "/francais/presentation/",
        "output": "francais/presentation.html",
        "view": "default.htm",
        "variation": "presentation.json",
        "languageCode": "fr-fr"
    },
    "members-fr-fr": {
        "url": "/francais/membres/",
        "output": "francais/members.html",
        "view": "members.htm",
        "variation": "members.json",
        "controller": "members.js",
        "languageCode": "fr-fr"
    },
    "memberV2-fr-fr": {
        "url": "/francais/membres/:member/",
        "output": "francais/members/bob.html",
        "view": "member.htm",
        "variation": "member.json",
        "controller": "member.js",
        "languageCode": "fr-fr"
    },
    "member-fr-fr": {
        "url": "/profile-de-membres/:member/",
        "redirect": "/membres/:member/",
        "statusCode": 301
    },
    "contact-us-fr-fr": {
        "url": "/francais/contactez-nous/",
        "output": "francais/contactez-nous.html",
        "view": "contact-us.htm",
        "variation": "contact-us.json",
        "languageCode": "fr-fr",
        "controller": "contact-us.js",
        "postSupport": true
    },
    "error-fr-fr": {
        "url": "/francais/*",               /* Toutes les pages commençant par "/francais/" pour la page d'erreur française. */
        "output": "francais/page-404.html",
        "view": "default.htm",              /* Vue partagée par différentes routes (voir "presentation"). */
        "variation": "page-404.json",
        "languageCode": "fr-fr",
        "statusCode": 404                   /* Un status 404 approprié pour les pages d'erreur. */
    },
    "error": {
        "url": "/page-404/",                /* Page d'erreur par défaut défini avec "pageNotFound". */
        "output": "page-404.html",
        "view": "default.htm",
        "variation": "page-404.json",
        "statusCode": 404
    }
}

autres fichiers...

Étape 3 - Création

Créer des fichiers pour développer votre site !

Structure de dossier NodeAtlas par défaut:

my-website/
├─ node_modules/             ⤆ Tous les modules node.js pour votre application.
│  └─ node-atlas/
│     ┊┉
│
├─ assets/                   ⤆ Tous les fichiers publiques peuvent être accédés en HTTP(s) sans route specifique définie.
│  ├─ javascript/
│  │  ┊┉
│  │
│  ├─ stylesheets/
│  │  ┊┉
│  │
│  ├─ media/
│  │  ┊┉
│  │
│  ┊┉
│
├─ views/                    ⤆ La partie vue avec chaque type de vue pour le rendu.
│  ├─ common.htm
│  ├─ home.htm
│  ├─ default.htm
│  ┊┉
│  └─ partials/              ⤆ Toutes les vues réutilisables.
│     ├─ header.htm
│     ├─ footer.htm
│     ┊┉ 
│
├─ variations/               ⤆ Tous les fichiers pour le remplissage de contenu avec "en-gb" par défaut…
│  ├─ common.json
│  ├─ home.json
│  ┊┉
│  │
│  └─ fr-fr/                 ⤆ …et également le "fr-fr".
│     ├─ common.json
│     ├─ home.json
│     ┊┉
│
├─ controllers/              ⤆ La partie contrôleur pour manipuler la vue, la variation et les modèles avec les bases de données ou les paramètres d'url.
│  ├─ common.js
│  ├─ home.js
│  ┊┉
│  ├─ modules/               ⤆ Tous les modules internes.
│     ├─ form-contact-us.js
│     ┊┉
│
├─ models/                   ⤆ La partie modèle avec des fichiers de modèle utilisés par les contrôleurs pour remplir les vues.
│  ┊┉
│
├─ serverless/               ⤆ Toutes les maquettes HTML générées et utilisables par les Back-end avec autre chose que Node.js.
│  ┊┉
│
├─ server.js                 ⤆ Fichier utilisé pour faire tourner et configurer NodeAtlas pour une utilisation sous forme d'API.
├─ webconfig.json            ⤆ Fichier utilisé pour faire tourner le site sur localhost pour le développement.
├─ webconfig.prod.json       ⤆ Fichier utilisé pour faire tourner le site sur le net pour la production.
├─ routes.json               ⤆ Fichier utilisé par "webconfig.json" et "webconfig.prod.json" pour définir les routes.
┊┉
├─ webconfig.prod.en-gb.json ⤆ Fichier exemple utilisé pour faire tourner uniquement les routes "en-gb" sur un port…
├─ routes.en-gb.json         ⤆ …avec le fichier de route anglais…
├─ webconfig.prod.fr-fr.json ⤆ …et faire tourner les routes "fr-fr" sur un autre port…
├─ routes.fr-fr.json         ⤆ …avec le fichier de route français.
┊┉

Étape 4 - Lancement ! ###

Lancer NodeAtlas depuis le dossier "my-website" dans votre environnement de développement :

  • avec un fichier server.js:
node server.js
  • with CLI command:
nodeatlas
  • pour générer les assets :
nodeatlas --generate

Lancer NodeAtlas dans votre environnement de production :

  • en standard:
nodeatlas --directory /var/www/my-website/ --webconfig webconfig.prod.json
  • avec Forever:
forever start /usr/local/lib/node_modules/node-atlas/ --directory /var/www/my-website/ --webconfig webconfig.prod.json

Documentation

À propos de NodeAtlas

Exemple de sites

NodeAtlas vs les autres

NodeAtlas Express Hapi Sails Restify LoopBack Meteor
Type Framework Web MVC(2) Librairie serveur HTTP Framework serveur HTTP Framework Web MVC Librairie HTTP REST Framework d'API Platforme d'app JavaScript côté client et serveur
Top Features Simplicité, Evolutivité, Modularité Routage HTTP, middleware Modularité, securité Familier à Rails, MVC Simplicité, Routage REST Connectivité d'Entreprise Framework Front-end et Back-end
Adapté pour Sites web, Apps web, APIs REST, Maquettage Apps web simple Apps web, APIs Apps web, APIs APIs REST Simple Apps web, APIs Apps web
Node Module Package Oui Oui Oui Oui Oui Oui Non
Extensions Plugin Atlas, Module Npm, Middleware Express Middleware Express Plugins Hapi Package et repository Meteor, Module Npm
Sources de données Builtin : En-memoire, fichier (JSON), REST. Avec module npm externe : NoSQL (MongoDB...), SQL (MySql...) En memoire, Fichier, PostgreSQL, MySQL, MongoDB En mémoire/fichier, SQL NoSQL, ATG, Email, REST, SOAP MongoDB, MySQL and PostgreSQL via 3rd-party Meteor packages
Langue principale Français Anglais Anglais Anglais Anglais Anglais Anglais

About

NodeAtlas is a MVC(2) JavaScript Framework Server-side that allows you to create Scalable website with SEO and W3C compliancy.

http://node-atlas.js.org/

License:GNU General Public License v2.0

Languages

Language:JavaScript 84.0%Language:HTML 15.5%Language:CSS 0.5%