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 和其他令人惊叹的项目，但在它们之上提供了有凝聚力的策划体验。

• 无需配置：您无需配置任何内容。我们将为您处理开发和生产构建的合理良好配置，以便您可以专注于编写代码。

• 无锁定：您可以随时“弹出”自定义设置。运行单个命令，所有配置和构建依赖项都将直接移至您的项目中，以便您可以从上次停下的地方继续。

包含什么？

您的环境将拥有构建现代静态网站所需的一切：

• 静态站点生成器（Jekyll 或 Hugo）
• ES6 之外的语言附加功能，例如对象扩展运算符。
• 自动添加前缀 CSS
• 通过单一依赖即可轻松更新上述工具。

代价是这些工具被预先配置为以特定方式工作。如果您的项目需要更多自定义，您可以“弹出”并自定义它，但随后您将需要维护此配置。

静态站点

静态网站是使用静态、不变的文件构建的网站。由于内容是静态的，因此将其交付给用户不需要服务器处理时间。此功能使静态站点变得异常快速和高性能。

静态站点生成器是构建静态站点的现代方式。它们将简单的基于文本的内容文件转换为可供网络使用的静态文件。

它们对于开发人员来说非常棒，因为它们速度极快，专为与版本控制一起使用而构建，并且与 Wordpress 等现有的整体 CMS 解决方案相比，几乎不需要任何设置。

目前， create-static-site支持两种静态站点生成器：

• Jekyll是用 Ruby 编写的静态站点生成器，由 GitHub 创始人 Tom Preston Werner 创建。
• Hugo是用 GoLang 编写的静态站点生成器，由 Steve Francia 创建。

贡献

我们很乐意在create-static-site方面得到您的帮助！有关我们正在寻找的内容以及如何开始的更多信息，请参阅 CONTRIBUTING.md。

贡献者

感谢这些优秀的人（表情符号键）：

克里斯德马克雷 ？ ？ ？ ？ ？ ✅	菲利普斯 ？ ？ ？ ？ ？ ️ ？	布莱恩·克莱因 ？ ？	斯科特·加兰特 ？ ？	DJ ？	塞巴斯蒂安·恩格斯 ？ ？	亚当 ？

该项目遵循所有贡献者规范。欢迎任何形式的贡献！

致谢

这个项目很大程度上受到了精彩的 create-react-app 项目的启发。