Hugo 静态网站生成器完全指南

什么是 Hugo? Hugo 是一个用 Go 语言编写的开源静态网站生成器,以其极快的构建速度和简洁的使用方式而闻名。无论你是想建立个人博客、文档网站还是企业官网,Hugo 都能提供强大的支持。 Hugo 的核心优势 1. 闪电般的构建速度 Hugo 以其惊人的构建速度著称。即使网站包含数千个页面,也能在毫秒级完成构建。这得益于 Go 语言的高效性能。 2. 零依赖部署 Hugo 生成的是纯静态 HTML 文件,无需数据库、服务器端脚本或复杂的部署流程。只需上传文件到任何 Web 服务器即可。 3. 灵活的主题系统 Hugo 拥有丰富的主题库,你可以轻松选择喜欢的主题,或者自己开发定制主题。 4. 强大的内容管理 支持 Markdown 格式编写内容,内置分类、标签、日期等元数据管理功能。 快速开始 安装 Hugo # macOS (使用 Homebrew) brew install hugo # Windows (使用 Chocolatey) choco install hugo # Linux sudo apt-get install hugo 创建新网站 hugo new site my-website cd my-website 添加主题 git clone https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod 创建第一篇文章 hugo new posts/my-first-post.md 本地预览 hugo server -D 然后在浏览器中访问 http://localhost:1313/ 查看你的网站。 ...

2025-12-12 · 205 字 · MagicBude

PaperMod 主题完全使用指南

什么是 PaperMod? PaperMod 是一个为 Hugo 设计的极简主题,以其简洁的设计、快速的加载速度和丰富的功能配置而受欢迎。它提供了现代化的外观,同时保持了高性能和易用性。 为什么选择 PaperMod? 1. 极简设计 PaperMod 采用极简主义设计理念,页面清爽,专注于内容展示。没有多余的装饰,让读者专注于你的文章。 2. 高性能 主题经过优化,加载速度快,SEO 友好。生成的网站在 Google PageSpeed Insights 上通常能获得高分。 3. 丰富的功能 深色/浅色主题切换 多语言支持 内置搜索功能 社交媒体分享 代码高亮 响应式设计 4. 易于定制 通过简单的配置和 CSS 覆盖,可以轻松自定义主题外观。 安装 PaperMod 方法 1:使用 Git Submodule(推荐) git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod git submodule update --init --recursive 方法 2:直接克隆 git clone https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod 基础配置 1. 在 hugo.yaml 中启用主题 theme: PaperMod 2. 配置基本参数 params: title: "Your Site Title" description: "Site description" author: "Your Name" # 主题相关 defaultTheme: auto # auto/dark/light disableThemeToggle: false # 文章显示选项 ShowReadingTime: true ShowShareButtons: true ShowPostNavLinks: true ShowBreadCrumbs: true 主要功能配置 1. 首页配置 使用 profileMode 配置首页显示个人信息: ...

2025-12-12 · 354 字 · MagicBude

Markdown 写作技巧和最佳实践

什么是 Markdown? Markdown 是一种轻量级的标记语言,用简单的符号来格式化文本。它易学易用,广泛应用于博客、文档、README 文件等场景。 基础语法回顾 标题 # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 强调 *斜体* 或 _斜体_ **粗体** 或 __粗体__ ***粗斜体*** 或 ___粗斜体___ ~~删除线~~ 列表 无序列表: - 项目 1 - 项目 2 - 子项目 2.1 - 子项目 2.2 - 项目 3 有序列表: 1. 第一项 2. 第二项 3. 第三项 链接和图片 [链接文本](https://example.com) [链接文本](https://example.com "链接标题") ![图片描述](image.jpg) ![图片描述](image.jpg "图片标题") 高级技巧 1. 代码块 行内代码: 使用 `code` 表示行内代码 代码块: ```python def hello_world(): print("Hello, World!") ``` 支持的语言高亮包括:python、javascript、java、c++、bash 等。 ...

2025-12-12 · 352 字 · MagicBude

Git 和 GitHub 完全使用指南

什么是 Git? Git 是一个分布式版本控制系统,用于跟踪文件的变化历史。它允许多个开发者协作开发项目,同时保持代码的完整性和可追溯性。 什么是 GitHub? GitHub 是一个基于 Git 的代码托管平台,提供了在线仓库、协作工具、CI/CD 等功能。它是全球最大的开源项目托管平台。 Git 基础概念 仓库(Repository) 存储项目代码和历史记录的地方。分为本地仓库和远程仓库。 分支(Branch) 独立的开发线。主分支通常是 main 或 master,可以创建其他分支进行特性开发。 提交(Commit) 保存一次代码变化的快照,包含作者、时间和变化说明。 推送(Push) 将本地提交上传到远程仓库。 拉取(Pull) 从远程仓库下载最新代码到本地。 Git 安装和配置 安装 Git Windows: # 使用 Chocolatey choco install git # 或从官网下载安装 # https://git-scm.com/ macOS: # 使用 Homebrew brew install git Linux: # Ubuntu/Debian sudo apt-get install git # CentOS/RHEL sudo yum install git 配置用户信息 # 设置用户名 git config --global user.name "Your Name" # 设置邮箱 git config --global user.email "your.email@example.com" # 查看配置 git config --list 常用 Git 命令 初始化和克隆 # 初始化本地仓库 git init # 克隆远程仓库 git clone https://github.com/username/repository.git 查看状态和历史 # 查看工作区状态 git status # 查看提交历史 git log # 查看简洁的提交历史 git log --oneline # 查看具体改动 git diff 添加和提交 # 添加文件到暂存区 git add filename # 添加所有改动 git add . # 提交改动 git commit -m "commit message" # 一步提交(仅限已跟踪的文件) git commit -am "commit message" 分支操作 # 查看本地分支 git branch # 查看所有分支 git branch -a # 创建新分支 git branch branch-name # 切换分支 git checkout branch-name # 创建并切换分支 git checkout -b branch-name # 删除分支 git branch -d branch-name # 合并分支 git merge branch-name 推送和拉取 # 推送到远程仓库 git push origin branch-name # 拉取远程更新 git pull origin branch-name # 获取远程更新(不合并) git fetch origin 撤销操作 # 撤销工作区改动 git checkout -- filename # 撤销暂存区改动 git reset HEAD filename # 撤销最后一次提交 git reset --soft HEAD~1 # 强制撤销(谨慎使用) git reset --hard HEAD~1 GitHub 工作流程 1. 创建仓库 登录 GitHub 点击 “New repository” 填写仓库名称和描述 选择公开或私有 初始化 README 文件(可选) 2. 克隆到本地 git clone https://github.com/username/repository.git cd repository 3. 创建特性分支 git checkout -b feature/new-feature 4. 进行开发 编辑文件,进行开发工作。 ...

2025-12-12 · 498 字 · MagicBude

VSCode 高效开发技巧

什么是 VSCode? Visual Studio Code(简称 VSCode)是由微软开发的免费、开源的代码编辑器。它以轻量级、功能强大和丰富的扩展生态而著称,是现代开发者的首选编辑器。 为什么选择 VSCode? 1. 轻量级和快速 相比 IDE,VSCode 启动快,占用资源少,即使在低配置电脑上也能流畅运行。 2. 强大的扩展生态 拥有超过 50,000 个扩展,覆盖几乎所有编程语言和开发场景。 3. 内置功能丰富 集成终端 Git 集成 调试器 代码智能提示 代码格式化 4. 跨平台支持 支持 Windows、macOS 和 Linux。 必备快捷键 编辑快捷键 快捷键 功能 Ctrl+S 保存文件 Ctrl+Z 撤销 Ctrl+Y 重做 Ctrl+X 剪切 Ctrl+C 复制 Ctrl+V 粘贴 Ctrl+/ 注释/取消注释 Ctrl+Shift+K 删除整行 Alt+↑/↓ 上下移动行 Ctrl+D 选择相同单词 导航快捷键 快捷键 功能 Ctrl+P 快速打开文件 Ctrl+Shift+P 打开命令面板 Ctrl+G 跳转到指定行 Ctrl+F 查找 Ctrl+H 查找和替换 Ctrl+Shift+F 在文件中查找 Ctrl+` 打开/关闭终端 代码编辑快捷键 快捷键 功能 Ctrl+Space 触发代码补全 Ctrl+Shift+Space 触发参数提示 F2 重命名符号 Ctrl+K Ctrl+X 删除末尾空格 Ctrl+Shift+Enter 在上方插入行 Ctrl+Enter 在下方插入行 推荐扩展 1. Prettier - Code Formatter 自动格式化代码,保持代码风格一致。 ...

2025-12-12 · 216 字 · MagicBude