create static site

Создать статический сайт

Создавайте статические веб-сайты без конфигурации сборки.

Обзор

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

(npx поставляется с npm 5.2+ и выше)

Затем откройте http://localhost:3000/, чтобы увидеть свое приложение.

Создание статического сайта

Вам понадобится Node >= 6 на вашей локальной машине разработки . Вы можете использовать nvm (macOS/Linux) или nvm-windows, чтобы легко переключать версии Node между разными проектами.

Чтобы создать новое приложение, запустите:

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

Замените [template] на hugo или jekyll .

Внутри текущей папки будет создан каталог с именем my-site .
Внутри этого каталога будет сгенерирована исходная структура проекта и установлены транзитивные зависимости:

 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

Никакой настройки или сложной структуры папок, только файлы, необходимые для создания сайта.
После завершения установки вы можете открыть папку вашего проекта:

 cd my-site

Внутри вновь созданного проекта вы можете запустить некоторые встроенные команды:

npm start или yarn start

Пользователям Jekyll сначала необходимо запустить bundle install

Запускает приложение в режиме разработки.
Откройте http://localhost:3000, чтобы просмотреть его в браузере.

Страница автоматически перезагрузится, если вы внесете изменения в код.

npm build или yarn build

Создает рабочий сайт в папке dist .

Философия

• Одна зависимость: существует только одна зависимость сборки. Он использует Webpack, Babel, ESLint, PostCSS и другие замечательные проекты, но поверх них обеспечивает целостный курируемый опыт.

• Конфигурация не требуется: вам не нужно ничего настраивать. Вам будет предоставлена ​​достаточно хорошая настройка как разработки, так и рабочей сборки, чтобы вы могли сосредоточиться на написании кода.

• Нет блокировки: вы можете «извлечь» пользовательскую настройку в любое время. Запустите одну команду, и все зависимости конфигурации и сборки будут перенесены непосредственно в ваш проект, так что вы сможете продолжить с того места, на котором остановились.

Что включено?

В вашей среде будет все необходимое для создания современного статического веб-сайта:

• Генератор статических сайтов (Джекилл или Хьюго)
• Дополнительные возможности языка помимо ES6, такие как оператор расширения объектов.
• CSS с автопрефиксом
• Беспроблемные обновления для вышеуказанных инструментов с одной зависимостью.

Компромисс заключается в том, что эти инструменты предварительно настроены для работы определенным образом . Если ваш проект требует дополнительной настройки, вы можете «извлечь» и настроить его, но тогда вам нужно будет поддерживать эту конфигурацию.

Статические сайты

Статические сайты — это веб-сайты, созданные с использованием статических неизменяемых файлов. Поскольку контент статичен, его доставка пользователям не требует времени на обработку сервером. Эта функция делает статические сайты невероятно быстрыми и производительными.

Генераторы статических сайтов — это современный способ создания статических сайтов. Они конвертируют простые текстовые файлы с содержимым в статические файлы, готовые для использования в Интернете.

Они отлично подходят для разработчиков, поскольку чрезвычайно быстры, созданы для работы с контролем версий и практически не требуют установки по сравнению с существующими монолитными решениями CMS, такими как Wordpress.

В настоящее время create-static-site поддерживает два генератора статических сайтов:

• Jekyll — это генератор статических сайтов, написанный на Ruby и созданный основателем GitHub Томом Престоном Вернером.
• Hugo — это генератор статических сайтов, написанный на GoLang и созданный Стивом Франсией.

Содействие

Мы будем рады вашей помощи в create-static-site ! Посетите CONTRIBUTING.md для получения дополнительной информации о том, что мы ищем и с чего начать.

Авторы

Спасибо этим замечательным людям (ключ смайлика):

Крисдмакрэ ? ? ? ? ? ✅	нкфиллипс ? ? ? ? ? ️ ?	Брайан Кляйн ? ?	Скотт Галлант ? ?	диджей ?	Себастьян Энгельс ? ?	Адам ?

Этот проект соответствует спецификации всех участников. Любой вклад приветствуется!

Благодарности

Этот проект во многом вдохновлен замечательным проектом create-react-app.