GitHub Pages 简单网站搭建指南

GitHub Pages 简单网站搭建指南

simple_site Minimal tutorial on making a simple website with GitHub Pages 项目地址: https://gitcode.com/gh_mirrors/si/simple_site

1. 项目基础介绍

本项目是一个基于 GitHub Pages 的简单网站搭建教程，它通过使用 Markdown 和 Git 来创建一个静态网站。本项目旨在帮助初学者快速上手 GitHub Pages 的使用，无需复杂的技术背景。

主要编程语言

• Ruby
• HTML
• CSS

2. 项目使用的关键技术和框架

本项目主要使用了以下技术和框架：

• GitHub Pages：GitHub 提供的静态网站托管服务。
• Markdown：一种轻量级标记语言，用于编写网页内容。
• Jekyll：一个静态站点生成器，可以将 Markdown 转换为 HTML 页面。

3. 项目安装和配置

准备工作

在开始安装和配置之前，请确保您已经完成了以下准备工作：

• 安装了 Git。
• 在 GitHub 上创建了一个新的仓库。
• 确保您的电脑上已经安装了 Node.js 和 Ruby（含 DevKit）。

安装步骤

步骤 1：克隆项目

首先，您需要将项目克隆到本地电脑上。在命令行中执行以下命令：

git clone https://github.com/kbroman/simple_site.git

步骤 2：安装依赖

进入项目目录，安装项目所需的依赖。在项目根目录下执行以下命令：

gem install bundler
bundle install

步骤 3：配置项目

修改 _config.yml 文件，根据您的需求配置网站的基本信息，例如标题、描述等。

步骤 4：启动本地服务器

在项目根目录下，运行以下命令启动本地服务器：

bundle exec jekyll serve

然后在浏览器中访问 http://localhost:4000，您应该可以看到网站本地预览。

步骤 5：部署到 GitHub Pages

在本地测试无误后，您可以部署到 GitHub Pages 上。首先，确保您的 GitHub 仓库的名称符合格式 <username>.github.io，其中 <username> 是您的 GitHub 用户名。

然后，将 _config.yml 中的 baseurl 设置为 /（如果没有这一项则不需要添加）。

最后，将代码推送到 GitHub 仓库的 gh-pages 分支：

git checkout -b gh-pages
git push origin gh-pages

现在，您可以通过 <username>.github.io 访问您的网站了。

以上步骤可以帮助您成功搭建一个基于 GitHub Pages 的简单网站。如果您在过程中遇到任何问题，可以参考项目文档或搜索相关解决方案。祝您搭建成功！

simple_site Minimal tutorial on making a simple website with GitHub Pages 项目地址: https://gitcode.com/gh_mirrors/si/simple_site