CLI / Commandes de lancement

La façon la plus simple de lancer NodeAtlas est de se positionner dans le répertoire hébergeant votre site et de lancer la commande \> node </path/to/>node-atlas/. Cependant il existe des options de lancement pour faire bien plus que lancer le site.

Chacune des commandes qui vont suivre peut être couplée avec les autres de cette manière :

\> node </path/to/>node-atlas/ --directory /hello-world/ --webconfig config.fr-fr.js --httpPort 80 --browse

--directory <path>

Il est possible de lancer NodeAtlas depuis un autre endroit que le dossier où est hébergé le site que vous souhaitez faire tourner. La commande --directory vous sera alors très utile.

\> node </path/to/>node-atlas/ --directory </path/to/your/website/directory/>

--webconfig <webconfigName>

Par défaut, NodeAtlas va lire votre fichier webconfig.json. Il est possible qu'en plus de ce fichier vous ayez créé un autre fichier webconfig.prod.json dont le nom de domaine est différent. Ou encore un webconfig.fr-fr.json avec des urls et des variations dans une autre langue. Plutôt que de renommer vos fichiers en webconfig.json avant de lancer le site, précisez simplement votre autre nom de configuration. Dans l'exemple suivant, notre fichier sera webconfig.alternatif.json.

\> node </path/to/>node-atlas/ --webconfig webconfig.alternatif.json

--browse [subpath]

Cette commande permet d'ouvrir votre navigateur à l'adresse sur laquelle le site va tourner. Très pratique quand vous ne vous souvenez plus du port pour votre version de développement. Cette commande ne sert à rien si elle est couplée avec --generate (voir plus loin).

\> node </path/to/>node-atlas/ --browse

Vous pouvez également cibler une page précise en ajoutant la fin de l'url.

\> node </path/to/>node-atlas/ --browse index.html

--httpHostname <httpHostname>

Il est parfois utile de demander son adresse IP via un ipconfig pour le paramettrer dans l'url afin de rendre son site entièrement disponible sur un périphérique du réseau local (smartphone par exemple). Vous pourrez le faire avec cette commande.

\> node </path/to/>node-atlas/ --httpHostname 192.168.1.1

--httpPort <httpPort>

Vous n'allez peut être pas vous ennuyer à changer votre port d'écoute sur tous vos projets et parfois vous allez devoir travailler sur deux sites différents en même temps. Avec cette commande vous n'aurez pas besoin de couper vos sites alternativement pour libérer le port d'écoute, il suffira d'en choisir un au lancement.

\> node </path/to/>node-atlas/ --httpPort 7778

--generate

Si vous modifiez un élément dans votre fichier de variation commun ou même dans un de vos composants de template appelé sur plusieurs pages, vous n'allez pas recharger chaque page pour mettre à jour vos fichiers de sortie. Il suffira alors d'utiliser --generate. Cette commande copiera l'intégralité du contenu du dossier assetsRelativePath dans generatesRelativePath si leur chemin est différent.

\> node </path/to/>node-atlas/ --generate

--lang <culture-country>

En utilisant --lang vous changerez la langue de utilisée par NodeAtlas. En réalité cette commande remplace le contenu du fichier languages/default.json par celui de languages/fr-fr.json si le paramètre passé est « fr-fr » comme dans l'exemple ci-dessous. Lancer NodeAtlas ultérieurement conservera la dernière langue utilisée.

\> node </path/to/>node-atlas/ --lang fr-fr

--init [path]

NodeAtlas contient un dossier templates qui contient des exemples de site prèt à l'usage. Pour les installer dans le répertoire dans lequel vous allez exécuter NodeAtlas il faut vous servir de --init suivi du dossier contenu dans templates que vous souhaitez utiliser. Par défaut, c'est la valeur hello-world qui est utilisée. Valeurs possible : hello-world.

\> node </path/to/>node-atlas/ --init hello-world

--httpSecure [pathName]

Si vous utilisez l'option --httpSecure, tous les chemins seront accédez en HTTPs. Vous devez définir les fichiers .crt and .key avec pathName si vous souhaitez que le serveur lui-même se lance en HTTPs. Par exemple, si vous avez les fichiers security/server.crt et security/server.key depuis la racine du site NodeAtlas, vous devez utiliser la commande suivante :

\> node </path/to/>node-atlas/ --httpSecure security/server