Guide de démarrage rapide

Ce guide de démarrage rapide vous guidera à travers les étapes nécessaires à la création de votre première page Web à l'aide de contenttack-express. contenttack-express est un framework d'application Web Node.js basé sur Node.js Express, qui fournit un certain nombre de fonctionnalités pour créer facilement des sites Web.

The steps to be followed are given below:

1. Créer une pile
2. Créer un type de contenu
3. Créez votre première page
4. Configurer l'environnement de publication
5. Configurer et connecter contenttack-express
6. Publier du contenu

1. Créer une pile

   Une pile est comme un conteneur qui contient le contenu de votre site. Pour créer une nouvelle pile, connectez-vous à votre compte Contentstack et cliquez sur le bouton d'action + Nouvelle pile . Entrez un nom et une description appropriés (facultatif) pour la pile.

2. Create a content type

   Un type de contenu est la structure de votre page. Puisque nous prévoyons de créer une page d'accueil simple, la page ne contiendra que quelques champs: Titre et Corps . Vous pouvez ajouter/supprimer plus de champs en fonction de vos besoins. Regardons une courte vidéo pour découvrir le processus de création d'un type de contenu ( Accueil ).

3. Créez votre première page

   Vous pouvez créer des pages pour votre site Web en créant des entrées en utilisant le type de contenu défini. Pour créer la page d'accueil de votre site Web, cliquez sur le type de contenu Accueil et ajoutez du contenu dans les champs indiqués.

   Avec cette étape, nous avons presque fini de définir la structure et le contenu de votre site. Configurons maintenant l'environnement de publication.

4. Configurer l'environnement de publication

   Un environnement de publication est votre serveur Web sur lequel vous souhaitez déployer votre contenu. Pendant que vous créez un environnement, cliquez sur l'option Avancé et sélectionnez l'option Déployer le contenu sur le(s) serveur(s) pour synchroniser le contenu publié sur votre serveur Web.

5. Configurer et connecter contenttack-express

   1. Prérequis Vous avez besoin de Node.js v16 ou version ultérieure pour utiliser Contentstack.
   2. Installer l'interface de ligne de commande Exécutez cette commande dans un terminal ou une invite de commande pour obtenir et installer globalement la dernière version du framework sur votre système:
      $ npm install -g contentstack-cli   

      Remarque: Vous aurez peut-être besoin de privilèges d'administrateur pour effectuer cette installation.

   3. Connecter Dans le terminal, accédez à votre espace de travail et exécutez le connecter commande.
      $ contentstack connect
      

      Cela vous demandera de saisir la clé API de la pile et le jeton d'accès. Vous pouvez les trouver dans le Détails de la pile page.
      Enter your stack api key: {API_KEY}
      Enter your stack access token: {ACCESS_TOKEN}
      

      Remarque : nous avons cessé de prendre en charge les jetons d'accès pour toutes les piles créées après le 16 décembre 2020. Cependant, pour les piles créées avant le 16 décembre 2020, nous continuerons à prendre en charge les jetons d'accès.

      Cela validera la pile. Une fois validé, vous serez invité à entrer dans le répertoire racine du projet et à sélectionner l'environnement de publication (« développement ») que nous avons créé lors des étapes précédentes.
      Enter name of the directory to contain the project: (my-site)
      Select the publishing environment: 
      1. development    

      Cela configurera automatiquement votre projet pour l'environnement de publication sélectionné ainsi que le thème de base du site Web. Nous sommes maintenant prêts à démarrer l'application.
   4. Démarrez votre candidature Pour démarrer votre application, accédez simplement au dossier de développement de votre site et démarrez-le à l'aide de Node.js. Dans ce cas, les étapes seraient les suivantes:
      $ cd my_new_site
      $ npm start    

      Nous avons terminé la configuration de l'environnement de publication ! Cependant, la page d'accueil de votre site générera une erreur « 404 ». C'est parce que le contenu n'a pas encore été publié. Publie la page d'accueil.

6. Publish content

   Accédez au type de contenu Accueil et publiez l'entrée sur le environnement de « développement ». Ensuite, visitez la page http://localhost:4000 dans votre navigateur pour visualiser le contenu publié.

   Le framework Web de Contentstack applique automatiquement le thème et la conception de la page par défaut. Pour personnaliser la conception de votre page, consultez le guide de thème pour personnaliser la conception de votre page.