1kohei1 中文文档教程

Question

Gatsby's blog starter

使用此博客样板启动您的项目。 这个 starter 附带了主要的 Gatsby 配置文件，你可能需要这些文件来快速启动和运行用于 React 的快速应用程序生成器。

还有其他更具体的想法吗？ 您可能想查看我们充满活力的官方和社区创建的初学者集合。

Quick start

1. 创建一个 Gatsby 站点。

   使用 Gatsby CLI 创建一个新站点，指定博客启动器。

   # create a new Gatsby site using the blog starter
   gatsby new my-blog-starter https://github.com/gatsbyjs/gatsby-starter-blog
   

2. 开始开发。

   导航到新站点的目录并启动它。

   cd my-blog-starter/
   gatsby develop
   

3. 打开源代码并开始编辑！

   您的站点现在运行在 http://localhost:8000！

   _注意：您还会看到第二个链接：_http://localhost:8000/___graphql。 这是一个您可以用来试验查询数据的工具。 在 Gatsby 教程中了解有关使用此工具的更多信息。

   打开 my-blog-starter 目录在您选择的代码编辑器中并编辑 src/pages/index.js。 保存您的更改，浏览器将实时更新！

What's inside?

快速浏览您将在 Gatsby 项目中看到的顶级文件和目录。

.
├── node_modules
├── src
├── .gitignore
├── .prettierrc
├── gatsby-browser.js
├── gatsby-config.js
├── gatsby-node.js
├── gatsby-ssr.js
├── LICENSE
├── package-lock.json
├── package.json
└── README.md

1. /node_modules：此目录包含您的项目所依赖的所有代码模块（npm 包）都会自动安装。

2. /src：该目录将包含与您将在网站前端看到的内容（您在浏览器中看到的内容）相关的所有代码，例如您的站点标题或页面模板。 src 是“源代码”的约定。

3. .gitignore：此文件告诉 git 哪些文件不应跟踪/不应维护版本历史记录。

4. .prettierrc：这是 Prettier 的配置文件。 Prettier 是一种有助于保持代码格式一致的工具。

5. gatsby-browser.js：Gatsby 希望在该文件中找到 Gatsby 浏览器 API（如果有）。 这些允许自定义/扩展影响浏览器的默认 Gatsby 设置。

6. gatsby-config.js：这是 Gatsby 站点的主要配置文件。 在这里您可以指定有关您网站的信息（元数据），如网站标题和描述、您想要包含的 Gatsby 插件等。（查看 config docs 获取更多详细信息）。

7. gatsby-node.js：Gatsby 希望在该文件中找到 Gatsby 节点 API（如果有）。 这些允许自定义/扩展默认的 Gatsby 设置，影响站点构建过程的各个部分。

8. gatsby-ssr.js：Gatsby 希望在该文件中找到 Gatsby 服务器端渲染 API（如果有）。 这些允许自定义影响服务器端渲染的默认 Gatsby 设置。

9. LICENSE：Gatsby 根据 MIT 许可证获得许可。

10. package-lock.json（首先请参阅下面的 package.json）。 这是一个自动生成的文件，它基于为您的项目安装的 npm 依赖项的确切版本。 （您不会直接更改此文件）。

11. package.json：Node.js 项目的清单文件，其中包括诸如元数据之类的内容（项目名称、作者等）。 这个清单是 npm 知道要为你的项目安装哪些包的方式。

12. README.md：包含有关项目的有用参考信息的文本文件。

Learning Gatsby

寻找更多指导？ Gatsby 的完整文档位于网站上。 以下是一些起点：

• 对于大多数开发人员，我们建议从我们的使用 Gatsby 创建网站的深入教程开始. 它从对您的能力水平的零假设开始，然后遍历该过程的每一步。

• 要直接深入研究代码示例，请前往我们的文档。特别是，请查看指南、API 参考 和高级教程 部分。

Deploy