create static site Télécharger - create static site Téléchargement du code source

create static site

Autres catégories

1.0.0

Télécharger

Créer un site statique

Créez des sites Web statiques sans configuration de build.

Aperçu

 npx create-static-site my-site --template hugo
cd my-site
npm start

(npx est livré avec npm 5.2+ et supérieur)

Ensuite, ouvrez http://localhost:3000/ pour voir votre application.

Créer un site statique

Vous devrez avoir Node >= 6 sur votre machine de développement locale . Vous pouvez utiliser nvm (macOS/Linux) ou nvm-windows pour basculer facilement les versions de Node entre différents projets.

Pour créer une nouvelle application, exécutez :

npx create-static-site my-site --template [template]

Remplacez [template] par hugo ou jekyll .

Cela créera un répertoire appelé my-site dans le dossier actuel.
Dans ce répertoire, il générera la structure initiale du projet et installera les dépendances transitives :

 my-site
├── LICENSE
├── node_modules
├── package.json
├── README.md
├── static-scripts.config.js
├── .browserslistrc
├── .eslintrc.yml
├── .gitignore
├── .postcssrc.js
├── .stylelintrc.yml
├── site/ # Depends on the static site generator
└── src/
    ├── css/
    │   ├── styles.css
    │   └── imports
    │       └── resets.css
    ├── img/
    │   └── svg/
    │       ├── bitbucket.svg
    │       ├── github.svg
    │       └── gitlab.svg
    └── js/
        ├── scripts.js
        └── imports/
            └── index.js

Pas de configuration ni de structures de dossiers compliquées, juste les fichiers dont vous avez besoin pour créer votre site.
Une fois l'installation terminée, vous pouvez ouvrir le dossier de votre projet :

 cd my-site

Dans le projet nouvellement créé, vous pouvez exécuter certaines commandes intégrées :

`npm start` ou `yarn start`

Les utilisateurs de Jekyll devront d'abord exécuter bundle install

Exécute l'application en mode développement.
Ouvrez http://localhost:3000 pour l'afficher dans le navigateur.

La page se rechargera automatiquement si vous apportez des modifications au code.

`npm build` ou `yarn build`

Construit le site pour la production dans le dossier dist .

Philosophie

Une dépendance : il n'y a qu'une seule dépendance de construction. Il utilise Webpack, Babel, ESLint, PostCSS et d'autres projets étonnants, mais offre en plus une expérience cohérente et organisée.
Aucune configuration requise : vous n'avez rien à configurer. Une configuration raisonnablement bonne des versions de développement et de production est gérée pour vous afin que vous puissiez vous concentrer sur l'écriture du code.
Pas de verrouillage : vous pouvez « éjecter » vers une configuration personnalisée à tout moment. Exécutez une seule commande et toutes les dépendances de configuration et de construction seront déplacées directement dans votre projet, afin que vous puissiez reprendre là où vous vous étiez arrêté.

Qu'est-ce qui est inclus ?

Votre environnement aura tout ce dont vous avez besoin pour créer un site Web statique moderne :

Un générateur de site statique (Jekyll ou Hugo)
Extras de langage au-delà d'ES6, comme l'opérateur de propagation d'objets.
CSS avec préfixe automatique
Mises à jour sans tracas pour les outils ci-dessus avec une seule dépendance.

Le compromis est que ces outils sont préconfigurés pour fonctionner d'une manière spécifique . Si votre projet nécessite plus de personnalisation, vous pouvez « l'éjecter » et le personnaliser, mais vous devrez alors conserver cette configuration.

Sites statiques

Les sites statiques sont des sites Web construits à partir de fichiers statiques et inchangés. Le contenu étant statique, sa diffusion aux utilisateurs ne nécessite aucun temps de traitement du serveur. Cette fonctionnalité rend les sites statiques incroyablement rapides et performants.

Les générateurs de sites statiques constituent la manière moderne de créer des sites statiques. Ils convertissent des fichiers de contenu texte simples en fichiers statiques prêts pour le Web.

Ils sont fantastiques pour les développeurs car ils sont extrêmement rapides, sont conçus pour fonctionner avec le contrôle de version et nécessitent peu ou pas de configuration par rapport aux solutions CMS monolithiques existantes comme Wordpress.

Actuellement, create-static-site prend en charge deux générateurs de sites statiques :

Jekyll est le générateur de sites statiques écrit en Ruby et créé par le fondateur de GitHub, Tom Preston Werner.
Hugo est le générateur de sites statiques écrit en GoLang et créé par Steve Francia.

Contribuer

Nous serions ravis d'avoir votre coup de main sur create-static-site ! Voir CONTRIBUTING.md pour plus d'informations sur ce que nous recherchons et comment commencer.