Gatsby Starter Portfolio Minimal 项目启动与配置教程

1. 项目目录结构及介绍

在克隆或下载 Gatsby Starter Portfolio Minimal 项目后，你将看到以下目录结构：

gatsby-starter-portfolio-minimal/
├── config/                     # 配置文件目录
│   └── index.js                # 站点配置文件
├── content/                    # 内容文件目录
│   ├── about.mdx               # 关于我页面内容
│   ├── contact.mdx             # 联系我页面内容
│   ├── index.mdx               # 主页内容
│   ├── imprint.mdx             # 印记页面内容
│   └── ...                     # 其他页面内容
├── src/                        # 源代码目录
│   ├── components/             # React组件目录
│   ├── layouts/                # 布局组件目录
│   ├── pages/                  # 页面组件目录
│   ├── templates/              # 页面模板目录
│   ├── assets/                 # 静态资源目录
│   └── ...                     # 其他源代码文件
├── static/                     # 静态文件目录
├── .babelrc.js                 # Babel配置文件
├── .eslintrc.js                # ESLint配置文件
├── .gitignore                  # Git忽略文件
├── .lintstagedrc.js            # Lint-staged配置文件
├── .prettierrc                 # Prettier配置文件
├── gatsby-browser.js           # Gatsby浏览器插件
├── gatsby-config.js            # Gatsby配置文件
├── netlify.toml                # Netlify配置文件
├── package-lock.json           # 包锁定文件
├── package.json                # 包管理文件
└── README.md                   # 项目说明文件

每个目录和文件都有其特定的作用：

• config/：包含项目的配置信息。
• content/：存放Markdown格式的页面内容，使用MDX格式可以添加React组件。
• src/：源代码目录，包括React组件、布局和页面。
• static/：用于存放静态文件，如图片、PDF等。
• 其他配置文件如.babelrc.js、.eslintrc.js等，用于配置Babel、ESLint等工具。

2. 项目的启动文件介绍

项目的启动主要通过package.json文件中的脚本来完成。以下是一些主要的启动命令：

• npm install：安装项目依赖。
• gatsby develop：启动开发服务器，用于本地开发。
• gatsby build：构建项目，用于生产环境部署。

在package.json文件中，你将看到如下脚本：

{
  "scripts": {
    "build": "gatsby build",
    "develop": "gatsby develop",
    ...
  },
  ...
}

3. 项目的配置文件介绍

项目的配置主要通过config/index.js和gatsby-config.js文件进行。

• config/index.js：定义了站点的元数据，如标题、描述、社交媒体链接等。

module.exports = {
  siteMetadata: {
    title: `Your Name's Portfolio`,
    description: `A personal portfolio built with Gatsby Starter Portfolio Minimal`,
    social: {
      twitter: `your_twitter_username`,
      linkedin: `your_linkedin_username`,
      ...
    },
    ...
  },
  ...
};

• gatsby-config.js：用于配置Gatsby插件和其他设置。

module.exports = {
  plugins: [
    `gatsby-plugin-react-helmet`,
    `gatsby-plugin-mdx`,
    `gatsby-plugin-postcss`,
    ...
  ],
  ...
};

通过编辑这些配置文件，你可以自定义你的个人网站。