标题:如何通过 GitHub Pages 创建一个静态网站
GitHub Pages 是 GitHub 提供的一项免费服务,允许用户从 GitHub 仓库中托管静态网站。对于开发者和非开发者来说,这都是一个极其便利的工具,用于创建和发布个人博客、项目文档或作品集。
一、什么是 GitHub Pages?
GitHub Pages 是基于 GitHub 仓库创建的静态网站托管服务。用户可以把 Markdown 或 HTML 文档转化为网站来展示,并拥有一个免费的 github.io 域名。这些网站通常托管在 GitHub 的服务器上,任何人都可以通过浏览器访问。
优点:
- 易于使用:即使你没有开发经验,也可以通过简单的步骤创建美观的网站。
- 免费托管:对于个人和开源项目,GitHub Pages 是完全免费的。
- 自动部署:每次你更新 GitHub 仓库,网站会自动重新部署,无需手动操作。
- 支持自定义域名:您可以将自己的域名连接到 GitHub Pages 网站。
- 支持多种框架:例如 Jekyll、Hugo、React 等,使网站构建更灵活。
二、如何搭建一个 GitHub Pages 网站?
步骤1:创建 GitHub 仓库
- 登录到 GitHub(没有账号的需要创建账号,这里就不详细介绍了)。
- 点击页面右上角的 “+” 图标,然后选择 “New repository”。
红色标注的地方就是你的名字,我这边是wxd-infinity
- 给你的仓库命名为
<your-username>.github.io
,确保仓库是公共的,然后点击“Create repository”。
步骤2:添加网站内容(使用git)
- 克隆你创建的仓库到本地:
git clone https://github.com/<your-username>/<your-username>.github.io
- 在本地仓库目录中,创建一个
index.html
文件。添加一些基本的 HTML 内容:<!DOCTYPE html> <html> <head><title>My GitHub Page</title> </head> <body><h1>Hello, World!</h1><p>Welcome to my GitHub Pages site.</p> </body> </html>
步骤3:上传内容到 GitHub(使用git)
- 提交更改:
git add . git commit -m "Initial commit"
- 推送到 GitHub:
git push origin main
如果你不想使用 Git 客户端来管理 GitHub Pages 的网站内容,你可以直接在 GitHub 网站上进行操作。以下是如何在 GitHub 网站上直接添加或更新网站内容的步骤:
步骤4:访问你的网站(不使用git)
- 发布后,您可以通过
<your-username>.github.io
访问您的网站。
通过 GitHub 网站直接编辑内容(不使用git)
步骤1:创建或访问现有的 GitHub 仓库(不使用git)
- 登录到 GitHub。
- 如果还没有仓库,点击页面右上角的 “+” 图标,然后选择 “New repository” 来创建一个名为
<your-username>.github.io
的仓库。如果已有该仓库,则直接访问该仓库。
步骤2:创建或编辑文件(不使用git)
-
进入仓库页面后,点击 “Add file” 按钮,然后选择 “Create new file”。
-
在文件名输入框中输入
index.html
,加入我们的 HTML 内容。比如:昨天的个人主页内容(我有进行了一定更改,大家按需使用)
个人主页文件结构
/my-website├── index.html├── about.html├── skills.html├── contact.html├── styles.css├── scripts.js
1. 新增内容和多页面
index.html
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>我的个人主页</title><link href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/css/bootstrap.min.css" rel="stylesheet"><link rel="stylesheet" href="styles.css">
</head>
<body><!-- Navbar --><nav class="navbar navbar-expand-lg navbar-dark bg-gradient fixed-top"><a class="navbar-brand" href="#">个人主页</a><button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"><span class="navbar-toggler-icon"></span></button><div class="collapse navbar-collapse" id="navbarNav"><ul class="navbar-nav ml-auto"><li class="nav-item active"><a class="nav-link" href="about.html">关于我</a></li><li class="nav-item"><a class="nav-link" href="skills.html">技能</a></li><li class="nav-item"><a class="nav-link" href="#">项目</a></li><li class="nav-item"><a class="nav-link" href="contact.html">联系</a></li></ul></div></nav><!-- Header --><header class="header text-white text-center py-5"><div class="container"><h1>欢迎来到我的个人主页</h1><p>探索我最新的项目和学习旅程</p></div></header><!-- Main Content --><main class="content container mt-5 pt-3"><!-- Landing Page Content --><section id="introduction" class="text-center"><h2>探索更多</h2><p>了解我的技能和项目,或联系我以获取更多信息。</p><img src="images/profile.jpg" alt="Profile Image" class="rounded-circle mb-3" style="width: 200px;"></section><section id="intro-links" class="row text-center"><div class="col-md-4"><h3>关于我</h3><p><a href="about.html" class="btn btn-outline-primary">了解更多</a></p></div><div class="col-md-4"><h3>我的技能</h3><p><a href="skills.html" class="btn btn-outline-primary">查看技能</a></p></div><div class="col-md-4"><h3>项目案例</h3><p><a href="#" class="btn btn-outline-primary">浏览项目</a></p></div></section></main><!-- Footer --><footer class="footer bg-dark text-white text-center py-2"><p>联系我:<a class="text-white" href="https://blog.csdn.net/wxdzuishaui?spm=1010.2135.3001.5343">我的博客</a></p></footer><!-- JavaScript --><script src="scripts.js"></script><script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script><script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>
about.html
<!DOCTYPE html>
<html lang="zh-CN">
<head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>关于我 - 我的个人主页</title> <link href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/css/bootstrap.min.css" rel="stylesheet"> <link rel="stylesheet" href="styles.css">
</head>
<body> <!-- Navbar --> <nav class="navbar navbar-expand-lg navbar-dark bg-gradient fixed-top"> <a class="navbar-brand" href="index.html">个人主页</a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarNav"> <ul class="navbar-nav ml-auto"> <li class="nav-item"><a class="nav-link" href="index.html">主页</a></li> <li class="nav-item active"><a class="nav-link" href="about.html">关于我</a></li> <li class="nav-item"><a class="nav-link" href="skills.html">技能</a></li> <li class="nav-item"><a class="nav-link" href="contact.html">联系</a></li> </ul> </div> </nav> <!-- Main Content --> <main class="content container mt-5 pt-5"> <section class="text-center mb-4"> <h2>关于我</h2> <p>你好!我是一个热爱前端开发的初学者,正在不断学习新技术以提升自己的技能。</p> <img src="images/profile.jpg" alt="Profile Image" class="rounded-circle mb-3" style="width: 200px;"> </section> <section class="mb-4"> <h3>我的背景</h3> <p>我在大学攻读计算机科学专业,并通过在线课程提升前端开发技能。目前,我致力于创建美观且用户友好的网页。</p> </section> <section> <h3>兴趣爱好</h3> <p>除了编程,我还喜欢阅读科技书籍,参与开源项目,并热衷于探索新的编程语言和框架。</p> </section> </main> <!-- Footer --> <footer class="footer bg-dark text-white text-center py-2"> <p>联系我:<a class="text-white" href="https://blog.csdn.net/wxdzuishaui?spm=1010.2135.3001.5343">我的博客</a></p> </footer> <script src="scripts.js"></script> <script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>
skills.html
<!DOCTYPE html>
<html lang="zh-CN">
<head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>我的技能 - 我的个人主页</title> <link href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/css/bootstrap.min.css" rel="stylesheet"> <link rel="stylesheet" href="styles.css">
</head>
<body> <!-- Navbar --> <nav class="navbar navbar-expand-lg navbar-dark bg-gradient fixed-top"> <a class="navbar-brand" href="index.html">个人主页</a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarNav"> <ul class="navbar-nav ml-auto"> <li class="nav-item"><a class="nav-link" href="index.html">主页</a></li> <li class="nav-item"><a class="nav-link" href="about.html">关于我</a></li> <li class="nav-item active"><a class="nav-link" href="skills.html">技能</a></li> <li class="nav-item"><a class="nav-link" href="contact.html">联系</a></li> </ul> </div> </nav> <!-- Main Content --> <main class="content container mt-5 pt-5"> <section class="text-center mb-4"> <h2>我的技能</h2> </section> <section class="mb-4"> <h3>编程语言</h3> <ul> <li>HTML - 熟练掌握</li> <li>CSS - 熟练掌握</li> <li>JavaScript - 掌握中</li> </ul> <div class="progress mb-2"> <div class="progress-bar bg-success" role="progressbar" style="width: 90%" aria-valuenow="90" aria-valuemin="0" aria-valuemax="100">HTML 90%</div> </div> <div class="progress mb-2"> <div class="progress-bar bg-info" role="progressbar" style="width: 85%" aria-valuenow="85" aria-valuemin="0" aria-valuemax="100">CSS 85%</div> </div> <div class="progress mb-2"> <div class="progress-bar bg-warning" role="progressbar" style="width: 70%" aria-valuenow="70" aria-valuemin="0" aria-valuemax="100">JavaScript 70%</div> </div> </section> <section> <h3>工具和框架</h3> <p>熟悉的框架与工具包括:Bootstrap、React、Git。</p> </section> </main> <!-- Footer --> <footer class="footer bg-dark text-white text-center py-2"> <p>联系我:<a class="text-white" href="https://blog.csdn.net/wxdzuishaui?spm=1010.2135.3001.5343">我的博客</a></p> </footer> <script src="scripts.js"></script> <script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>
contact.html
<!DOCTYPE html>
<html lang="zh-CN">
<head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>联系我 - 我的个人主页</title> <link href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/css/bootstrap.min.css" rel="stylesheet"> <link rel="stylesheet" href="styles.css">
</head>
<body> <!-- Navbar --> <nav class="navbar navbar-expand-lg navbar-dark bg-gradient fixed-top"> <a class="navbar-brand" href="index.html">个人主页</a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="navbarNav"> <ul class="navbar-nav ml-auto"> <li class="nav-item"><a class="nav-link" href="index.html">主页</a></li> <li class="nav-item"><a class="nav-link" href="about.html">关于我</a></li> <li class="nav-item"><a class="nav-link" href="skills.html">技能</a></li> <li class="nav-item active"><a class="nav-link" href="contact.html">联系</a></li> </ul> </div> </nav> <!-- Main Content --> <main class="content container mt-5 pt-5"> <section class="text-center mb-4"> <h2>联系我</h2> <p>想了解更多信息或有任何问题,请随时通过以下表单与我联系。</p> </section> <section class="bg-light p-4 rounded shadow-sm"> <form id="contactForm"> <div class="form-group"> <label for="name">姓名</label> <input type="text" class="form-control" id="name" placeholder="输入姓名"> </div> <div class="form-group"> <label for="email">邮箱</label> <input type="email" class="form-control" id="email" placeholder="输入邮箱"> </div> <div class="form-group"> <label for="message">留言</label> <textarea class="form-control" id="message" rows="4" placeholder="输入留言"></textarea> </div> <button type="submit" class="btn btn-primary">发送</button> </form> </section> </main> <!-- Footer --> <footer class="footer bg-dark text-white text-center py-2"> <p>联系我:<a class="text-white" href="https://blog.csdn.net/wxdzuishaui?spm=1010.2135.3001.5343">我的博客</a></p> </footer> <script src="scripts.js"></script> <script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.2/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>
2. 样式更新 styles.css
body {margin: 0;font-family: 'Roboto', sans-serif;background: linear-gradient(to right, #f5f7fa, #c3cfe2);
}.header, .footer {text-shadow: 2px 2px 4px #000000;background: linear-gradient(to right, #141E30, #243B55);
}.navbar-dark .navbar-brand, .navbar-dark .navbar-nav .nav-link {transition: color 0.15s;
}.navbar-dark .navbar-nav .nav-link:hover {color: #ff7e5f;
}.card {border: none;border-radius: 10px;box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);overflow: hidden;transition: box-shadow 0.3s;
}.card:hover {transform: scale(1.05);box-shadow: 0 8px 16px rgba(0, 0, 0, 0.2);
}.btn-outline-primary {transition: background-color 0.3s, color 0.3s;
}.btn-outline-primary:hover {background-color: #7b4397;color: #fff;
}.footer {background-color: #141E30;color: white;text-align: center;padding: 10px;width: 100%;box-shadow: 0 -3px 8px rgba(0, 0, 0, 0.2);
}.bg-gradient {background: linear-gradient(to right, #373b44, #4286f4);
}
3. 动效脚本 scripts.js
document.querySelectorAll('a[href^="#"]').forEach(anchor => { anchor.addEventListener('click', function(e) { e.preventDefault(); document.querySelector(this.getAttribute('href')).scrollIntoView({ behavior: 'smooth' }); });
});document.getElementById('contactForm').addEventListener('submit', function(event) { event.preventDefault(); const name = document.getElementById('name').value; const email = document.getElementById('email').value; const message = document.getElementById('message').value; if (name && email && message) { alert(`谢谢您的留言, ${name}!\n我们会尽快通过 ${email} 与您联系。`); this.reset();} else { alert('请填写所有字段。'); }
});const cards = document.querySelectorAll('.card');
cards.forEach(card => {card.addEventListener('mouseover', () => card.style.boxShadow = '0 8px 16px rgba(0, 0, 0, 0.2)');card.addEventListener('mouseout', () => card.style.boxShadow = '0 4px 8px rgba(0, 0, 0, 0.1)');
});// Adding fade-in effect
window.addEventListener('scroll', () => {document.querySelectorAll('.fade-in').forEach(element => {if (isElementInViewport(element)) {element.classList.add('visible');}});
});function isElementInViewport(el) {const rect = el.getBoundingClientRect();return (rect.top >= 0 &&rect.left >= 0 &&rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&rect.right <= (window.innerWidth || document.documentElement.clientWidth));
}
- 在页面下方的“Commit new file”部分,填写 commit 信息,然后点击“Commit new file”按钮以保存更改。
步骤3:查看和更新网站(不使用git)
-
更改会立即部署,如果之前没有创建分支,通常托管在
main
分支。 -
访问
<your-username>.github.io
来查看网站。
我的在这里 (https://sxdxwxd.github.io/wxd-infinity.github.io/)
如果需要更新内容,可以直接选中任何文件进行编辑,然后在编辑器中进行修改,接着更新描述后保存更改(commit)。
提示:
- 若要使用 Jekyll 之类的生成器,可以创建一个名为
_config.yml
的配置文件,并按照文档进行设置。 - 自定义域名可在 GitHub 仓库的设置中进行设置,需添加一个
CNAME
文件并配置 DNS 设置。
通过以上步骤,您即可轻松地搭建起一个 GitHub Pages 网站,随时分享您的项目和作品。