乔Enkidu

Nmap 教程：网络扫描的终极指南

Mon, 30 Mar 2026 00:00:00 +0000

Nmap 教程：网络扫描的终极指南

什么是 Nmap？

Nmap（Network Mapper）是一款功能强大的开源网络扫描工具，用于发现网络上的主机和服务，评估网络系统的安全性。它被网络管理员、安全专业人员和渗透测试人员广泛使用，是网络安全领域的标准工具之一。

安装 Nmap

Windows 系统

访问 Nmap 官方网站
下载 Windows 安装程序
运行安装程序并按照提示完成安装

Linux 系统

# Debian/Ubuntu
sudo apt update
sudo apt install nmap

# CentOS/RHEL
sudo yum install nmap

# Fedora
sudo dnf install nmap

macOS 系统

# 使用 Homebrew
brew install nmap

# 使用 MacPorts
sudo port install nmap

基本扫描技术

1. 主机发现

# 扫描单个 IP
nmap 192.168.1.1

# 扫描 IP 范围
nmap 192.168.1.1-100

# 扫描整个子网
nmap 192.168.1.0/24

# 扫描多个目标
nmap 192.168.1.1 192.168.1.100

2. 端口扫描

# 扫描常用端口
nmap 192.168.1.1

# 扫描指定端口
nmap -p 80,443 192.168.1.1

# 扫描所有端口
nmap -p- 192.168.1.1

# 扫描特定端口范围
nmap -p 1-1000 192.168.1.1

高级扫描选项

1. 扫描类型

# SYN 扫描（半开放扫描，速度快，隐蔽性好）
nmap -sS 192.168.1.1

# TCP 连接扫描（完整连接，可靠性高）
nmap -sT 192.168.1.1

# UDP 扫描（用于 UDP 服务）
nmap -sU 192.168.1.1

# FIN 扫描（隐蔽性更好）
nmap -sF 192.168.1.1

2. 服务和版本检测

# 检测服务版本
nmap -sV 192.168.1.1

# 详细服务检测
nmap -sV --version-intensity 9 192.168.1.1

3. 操作系统检测

# 操作系统检测
nmap -O 192.168.1.1

# 同时进行服务版本和操作系统检测
nmap -A 192.168.1.1

4. 脚本扫描

# 使用默认脚本
nmap -sC 192.168.1.1

# 使用特定脚本
nmap --script=vuln 192.168.1.1

# 使用多个脚本
nmap --script=auth,brute 192.168.1.1

输出格式

# 标准输出
nmap 192.168.1.1

# 详细输出
nmap -v 192.168.1.1

# 保存为文本文件
nmap -oN scan.txt 192.168.1.1

# 保存为 XML 文件
nmap -oX scan.xml 192.168.1.1

# 保存为 grep 格式
nmap -oG scan.grep 192.168.1.1

# 同时保存多种格式
nmap -oA scan 192.168.1.1

实用示例

1. 快速网络扫描

`1`	`nmap -F 192.168.1.0/24`

2. 全面安全扫描

`1`	`nmap -A -T4 192.168.1.1`

3. 漏洞扫描

`1`	`nmap --script=vuln 192.168.1.1`

4. brute force 攻击检测

`1`	`nmap --script=brute 192.168.1.1`

5. 网络拓扑发现

`1`	`nmap --traceroute 192.168.1.1`

性能优化

# 设置扫描速度（0-5，默认为3）
nmap -T4 192.168.1.1

# 并行扫描
nmap --min-parallelism 100 192.168.1.0/24

# 减少超时时间
nmap --max-rtt-timeout 100ms 192.168.1.1

# 禁用 DNS 解析
nmap -n 192.168.1.0/24

安全考虑

获取授权：在扫描任何网络之前，确保你有明确的授权
遵守法律：不同国家和地区对网络扫描有不同的法律规定
控制扫描速度：过快的扫描可能会被视为攻击行为
保护隐私：不要将扫描结果分享给未授权人员

常见问题解答

Q: Nmap 扫描被防火墙阻止怎么办？

A: 尝试使用 -f 参数分片数据包，或使用 -D 参数进行欺骗扫描

Q: 如何扫描内网中的存活主机？

A: 使用 -sn 参数只进行主机发现，不进行端口扫描

Q: 如何识别网络中的恶意设备？

A: 结合使用 -A 参数和 --script=malware 脚本进行检测

总结

Nmap 是一款功能强大的网络扫描工具，掌握它的使用方法对于网络管理员和安全专业人员来说至关重要。通过本教程，你应该已经了解了 Nmap 的基本用法、高级功能和最佳实践。

记住，Nmap 是一把双刃剑，它可以帮助你保护网络安全，也可能被用于恶意目的。始终确保你在合法的范围内使用 Nmap，并尊重他人的网络安全。

进一步学习资源

希望本教程对你有所帮助！如果有任何问题或建议，欢迎在评论区留言。

GitHub注册与部署完整教程及常见错误解决方案

Fri, 20 Mar 2026 12:56:28 +0800

GitHub账号注册

步骤一：访问GitHub官网

打开浏览器，访问 https://github.com
点击右上角的 Sign up 按钮

步骤二：填写注册信息

输入邮箱地址：使用有效的电子邮箱（建议使用常用邮箱）
创建密码：至少8位字符，包含字母和数字
设置用户名：
- 只能包含字母、数字、连字符(-)
- 不能以连字符开头或结尾
- 连字符不能连续使用
- 用户名是唯一的，系统会提示是否可用

步骤三：验证账号

完成人机验证（可能需要识别图片中的物体）
点击 Create account 创建账号
查收验证邮件，点击邮件中的验证链接

步骤四：选择计划

Free（免费版）：适合个人开发者，无限公共仓库和私有仓库
Pro（付费版）：适合专业开发者，包含高级代码审查工具等
一般个人用户选择 Free 计划即可

步骤五：完善个人资料

回答一些关于编程经验的问题（可跳过）
设置个人头像
完善个人简介

Git基础配置

安装Git

Windows系统

访问 https://git-scm.com/downloads
下载Windows版本安装包
运行安装程序，保持默认选项即可
安装完成后，在命令行输入验证：
1

git --version

macOS系统

# 使用Homebrew安装
brew install git

# 验证安装
git --version

Linux系统

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install git

# CentOS/RHEL
sudo yum install git

# 验证安装
git --version

配置Git用户信息

# 设置用户名（与GitHub用户名一致）
git config --global user.name "你的GitHub用户名"

# 设置邮箱（与GitHub注册邮箱一致）
git config --global user.email "your.email@example.com"

# 设置默认编辑器（可选）
git config --global core.editor "vim"

# 查看配置信息
git config --list

配置SSH密钥（推荐）

SSH密钥可以实现免密码推送代码，更加安全便捷。

# 生成SSH密钥
ssh-keygen -t ed25519 -C "your.email@example.com"

# 如果系统不支持ed25519，使用rsa
ssh-keygen -t rsa -b 4096 -C "your.email@example.com"

# 按回车键接受默认文件位置
# 可以设置密码（可选，直接回车表示不设置）

添加SSH密钥到SSH代理

# 启动ssh-agent
# Windows (Git Bash)
eval "$(ssh-agent -s)"

# macOS
eval "$(ssh-agent -s)"

# Linux
eval "$(ssh-agent -s)"

# 添加私钥到ssh-agent
ssh-add ~/.ssh/id_ed25519
# 或
ssh-add ~/.ssh/id_rsa

添加公钥到GitHub

复制公钥内容：

# Windows
clip < ~/.ssh/id_ed25519.pub

# macOS
pbcopy < ~/.ssh/id_ed25519.pub

# Linux
cat ~/.ssh/id_ed25519.pub
# 手动复制输出内容

登录GitHub，点击右上角头像 → Settings
左侧菜单选择 SSH and GPG keys
点击 New SSH key
填写标题（如：My Laptop），粘贴公钥内容
点击 Add SSH key

测试SSH连接

ssh -T git@github.com

# 看到以下提示表示成功
# Hi username! You've successfully authenticated...

GitHub仓库部署

创建新仓库

登录GitHub，点击右上角 + 号 → New repository
填写仓库信息：
- Repository name：仓库名称（建议使用英文）
- Description：仓库描述（可选）
- Public/Private：公开或私有
- Initialize this repository with：
  - ☑️ Add a README file（推荐勾选）
  - ☑️ Add .gitignore（根据项目类型选择）
  - ☑️ Choose a license（可选）
点击 Create repository

本地项目推送到GitHub

方式一：克隆已有仓库

# 使用HTTPS（需要输入密码）
git clone https://github.com/username/repository.git

# 使用SSH（推荐，免密码）
git clone git@github.com:username/repository.git

# 进入项目目录
cd repository

方式二：推送本地现有项目

# 进入本地项目目录
cd /path/to/your/project

# 初始化Git仓库
git init

# 添加所有文件到暂存区
git add .

# 提交更改
git commit -m "Initial commit"

# 添加远程仓库（HTTPS方式）
git remote add origin https://github.com/username/repository.git

# 或添加远程仓库（SSH方式，推荐）
git remote add origin git@github.com:username/repository.git

# 推送到GitHub
git push -u origin main
# 或如果默认分支是master
git push -u origin master

常用Git操作

# 查看仓库状态
git status

# 查看修改内容
git diff

# 添加指定文件
git add filename.txt

# 添加所有修改
git add .

# 提交更改
git commit -m "提交说明"

# 推送到远程仓库
git push origin main

# 拉取最新代码
git pull origin main

# 查看提交历史
git log --oneline

# 创建并切换到新分支
git checkout -b feature-branch

# 切换分支
git checkout main

# 合并分支
git merge feature-branch

# 删除本地分支
git branch -d feature-branch

GitHub Pages部署静态网站

GitHub Pages可以免费托管静态网站。

方法一：通过仓库设置

进入仓库页面，点击 Settings
左侧选择 Pages
Source 选择 Deploy from a branch
Branch 选择 main 或 master，文件夹选择 /(root) 或 /docs
点击 Save
等待几分钟，访问 https://username.github.io/repository-name

方法二：使用GitHub Actions自动部署

在项目根目录创建 .github/workflows/deploy.yml：

name: Deploy to GitHub Pages

on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    
    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '18'
    
    - name: Install dependencies
      run: npm ci
    
    - name: Build
      run: npm run build
    
    - name: Deploy
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./dist

提交并推送，GitHub会自动构建并部署

常见错误及解决方案

1. 身份验证错误

错误信息

`1`	`fatal: Authentication failed for 'https://github.com/username/repo.git/'`

解决方案

方案A：更新凭据

Windows：控制面板 → 凭据管理器 → Windows凭据 → 删除github相关凭据
macOS：git config --global credential.helper osxkeychain，然后重新输入密码

方案B：使用Personal Access Token

GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
点击 Generate new token
选择权限范围（至少勾选 repo）
生成后复制token，代替密码使用

方案C：切换到SSH方式

1
2

# 修改远程URL为SSH
git remote set-url origin git@github.com:username/repo.git

2. 权限拒绝错误

错误信息

1
2

Permission denied (publickey).
fatal: Could not read from remote repository.

解决方案

检查SSH密钥是否正确添加：
1

ssh -T git@github.com

如果失败，重新添加密钥：

# 启动ssh-agent
eval "$(ssh-agent -s)"

# 添加密钥
ssh-add ~/.ssh/id_ed25519

确认公钥已添加到GitHub账户

3. 仓库不存在错误

错误信息

`1`	`fatal: repository 'https://github.com/username/repo.git/' not found`

解决方案

检查仓库URL是否正确
确认仓库是否存在（可能已被删除或设为私有）
如果是私有仓库，确认有访问权限
检查网络连接

4. 推送被拒绝错误

错误信息

1
2

! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'https://github.com/username/repo.git'

解决方案

# 先拉取远程更新
git pull origin main

# 如果有冲突，解决冲突后重新推送
git push origin main

# 或者强制推送（会覆盖远程更改，慎用）
git push -f origin main

5. 合并冲突

错误信息

1
2

CONFLICT (content): Merge conflict in filename.txt
Automatic merge failed; fix conflicts and then commit the result.

解决方案

打开冲突文件，查找冲突标记：

<<<<<<< HEAD
本地代码
=======
远程代码
>>>>>>> branch-name

编辑文件，保留需要的代码，删除冲突标记

标记为已解决并提交：

1
2
3

git add .
git commit -m "Resolve merge conflict"
git push origin main

6. 大文件推送失败

错误信息

`1`	`remote: error: File largefile.zip is 156.78 MB; this exceeds GitHub's file size limit of 100.00 MB`

解决方案

方案A：使用Git LFS（大文件存储）

# 安装Git LFS
git lfs install

# 追踪大文件
git lfs track "*.zip"
git lfs track "*.psd"

# 提交.gitattributes
git add .gitattributes
git commit -m "Track large files with LFS"

# 重新添加大文件并推送
git add largefile.zip
git commit -m "Add large file"
git push origin main

方案B：从提交历史中删除大文件

1
2

# 使用BFG Repo-Cleaner或filter-branch
# 参考GitHub文档：https://docs.github.com/en/repositories/working-with-files/managing-large-files

7. 邮箱隐私错误

错误信息

`1`	`remote: error: GH007: Your push would publish private email addresses.`

解决方案

GitHub → Settings → Emails
取消勾选 Keep my email addresses private

或使用GitHub提供的noreply邮箱：

`1`	`git config --global user.email "username@users.noreply.github.com"`

8. 连接超时错误

错误信息

`1`	`fatal: unable to access 'https://github.com/...': Failed to connect to github.com port 443: Timed out`

解决方案

方案A：配置代理

# 设置HTTP代理
git config --global http.proxy http://proxy.example.com:8080
git config --global https.proxy https://proxy.example.com:8080

# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

方案B：使用SSH方式 SSH连接通常比HTTPS更稳定

方案C：修改hosts文件 查找GitHub的最新IP地址并添加到hosts文件

9. 分支不存在错误

错误信息

`1`	`error: pathspec 'main' did not match any file(s) known to git`

解决方案

# 查看所有分支
git branch -a

# 创建并切换到新分支
git checkout -b main

# 或从远程拉取分支
git fetch origin
git checkout -b main origin/main

10. 提交信息错误修改

修改最后一次提交

# 修改提交信息
git commit --amend -m "新的提交信息"

# 修改提交内容（添加遗漏的文件）
git add forgotten-file.txt
git commit --amend --no-edit

# 强制推送到远程（如果已推送）
git push --force-with-lease origin main

总结

GitHub是全球最大的代码托管平台，掌握其注册和部署流程对开发者至关重要。本文涵盖了：

注册流程：从账号创建到邮箱验证
Git配置：安装、用户信息设置、SSH密钥配置
部署方法：仓库创建、代码推送、GitHub Pages部署
常见问题：10种常见错误及详细解决方案

建议新手：

优先使用SSH方式连接，避免反复输入密码
养成经常commit和push的习惯
遇到问题时仔细阅读错误信息
善用GitHub官方文档和社区资源

参考资源

第一次用Hugo搭建博客的完整流程

Tue, 17 Mar 2026 20:43:58 +0800

前言

一直想拥有一个属于自己的博客，经过一番研究，最终选择了 Hugo 这个静态网站生成器。Hugo 是用 Go 语言编写的，以速度著称，能在毫秒级生成网站。这篇文章记录了我第一次使用 Hugo 搭建博客的完整流程。

1. 环境准备

1.1 安装 Git

前往 Git 官网下载安装程序，一直点下一步默认安装即可。

1.2 安装 Hugo

前往 Hugo GitHub Tags 下载对应版本：

Windows 用户下载：hugo_extended_xxxxx_windows_amd64.zip
下载后解压到任意文件夹即可

2. 创建博客

2.1 初始化项目

在 hugo.exe 所在文件夹的地址栏输入 cmd 回车，打开命令行：

# 创建 Hugo 站点
hugo new site myblog

# 进入项目目录
cd myblog

# 将 hugo.exe 复制到项目文件夹中（方便后续使用）

2.2 启动预览服务

`1`	`hugo server -D`

访问 http://localhost:1313 即可预览，按 Ctrl+C 停止服务。

注意：Hugo 默认没有主题，所以页面是空白的，需要配置主题。

3. 配置主题

3.1 选择主题

前往 Hugo Themes 查找喜欢的主题。这里以 Stack 主题 为例。

3.2 安装主题

下载主题并解压，放到 /themes 文件夹中
将 exampleSite 中的 content 和 hugo.yaml 复制到主文件夹
删除 hugo.toml 和 content/post/rich-content
修改 hugo.yaml 中的 theme 字段，与主题文件夹同名

3.3 再次启动服务

`1`	`hugo server -D`

现在访问 http://localhost:1313 就能看到主题效果了！

4. GitHub 部署

4.1 创建仓库

前往 GitHub 创建仓库，命名为 {你的用户名}.github.io
进入 Settings -> Pages -> Branch，选择 main 分支并保存
博客地址将是 https://{你的用户名}.github.io

4.2 生成静态文件

在项目根目录执行：

hugo -D

这会生成 public 文件夹，包含所有静态资源。

4.3 上传到 GitHub

cd public
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/你的用户名.github.io.git
git push -u origin main

上传成功后，访问 https://{你的用户名}.github.io 即可看到你的博客！

5. GitHub Action 自动部署（推荐）

手动部署比较麻烦，可以使用 GitHub Action 实现自动部署。

5.1 创建 Token

前往 Settings -> Developer Settings -> Personal access tokens
创建 Classic Token，选择永不过期
勾选 repo 和 workflow 权限
将 Token 保存到仓库的 Settings -> Secrets and variables -> Actions 中

5.2 创建工作流

在项目根目录创建 .github/workflows/deploy.yaml：

name: deploy

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: "latest"
          extended: true

      - name: Build Web
        run: hugo -D

      - name: Deploy Web
        uses: peaceiris/actions-gh-pages@v4
        with:
          PERSONAL_TOKEN: ${{ secrets.你的token变量名 }}
          EXTERNAL_REPOSITORY: 你的github名/你的仓库名
          PUBLISH_BRANCH: main
          PUBLISH_DIR: ./public
          commit_message: auto deploy

5.3 创建 .gitignore

# 自动生成的文件
public
resources
.hugo_build.lock

# hugo命令
hugo.exe

5.4 推送代码

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/你的仓库.git
git push -u origin main

推送后会自动触发 GitHub Action，完成自动部署！

总结

通过以上步骤，我成功搭建了自己的 Hugo 博客。整个过程比想象中简单，Hugo 的构建速度非常快，主题也很丰富。最重要的是，使用 GitHub Pages 完全免费！

接下来我会继续探索 Hugo 的更多功能，比如：

自定义主题样式
添加评论系统
配置 SEO
添加站点统计

希望这篇文章对想要搭建博客的你有所帮助！

Chinese Test

Wed, 09 Sep 2020 00:00:00 +0000

正文测试

而这些并不是完全重要，更加重要的问题是，带着这些问题，我们来审视一下学生会退会。既然如何，对我个人而言，学生会退会不仅仅是一个重大的事件，还可能会改变我的人生。我们不得不面对一个非常尴尬的事实，那就是，可是，即使是这样，学生会退会的出现仍然代表了一定的意义。学生会退会，发生了会如何，不发生又会如何。经过上述讨论，生活中，若学生会退会出现了，我们就不得不考虑它出现了的事实。学生会退会，到底应该如何实现。这样看来，在这种困难的抉择下，本人思来想去，寝食难安。对我个人而言，学生会退会不仅仅是一个重大的事件，还可能会改变我的人生。就我个人来说，学生会退会对我的意义，不能不说非常重大。莎士比亚曾经提到过，人的一生是短的，但如果卑劣地过这一生，就太长了。这似乎解答了我的疑惑。莫扎特说过一句富有哲理的话，谁和我一样用功，谁就会和我一样成功。这启发了我，对我个人而言，学生会退会不仅仅是一个重大的事件，还可能会改变我的人生。学生会退会，到底应该如何实现。一般来说，从这个角度来看，这种事实对本人来说意义重大，相信对这个世界也是有一定意义的。在这种困难的抉择下，本人思来想去，寝食难安。了解清楚学生会退会到底是一种怎么样的存在，是解决一切问题的关键。一般来说，生活中，若学生会退会出现了，我们就不得不考虑它出现了的事实。问题的关键究竟为何？而这些并不是完全重要，更加重要的问题是。

奥斯特洛夫斯基曾经说过，共同的事业，共同的斗争，可以使人们产生忍受一切的力量。　带着这句话，我们还要更加慎重的审视这个问题：一般来讲，我们都必须务必慎重的考虑考虑。既然如此，这种事实对本人来说意义重大，相信对这个世界也是有一定意义的。带着这些问题，我们来审视一下学生会退会。我认为，我认为，在这种困难的抉择下，本人思来想去，寝食难安。问题的关键究竟为何？每个人都不得不面对这些问题。在面对这种问题时，要想清楚，学生会退会，到底是一种怎么样的存在。我认为，既然如此，每个人都不得不面对这些问题。在面对这种问题时，那么，我认为，学生会退会因何而发生。

引用

思念是最暖的忧伤像一双翅膀
让我停不了飞不远在过往游荡
不告而别的你就算为了我着想
这么沉痛的呵护我怎么能翱翔

最暖的憂傷 - 田馥甄

图片

1
2
3

![Photo by Florian Klauer on Unsplash](florian-klauer-nptLmg6jqDo-unsplash.jpg)  ![Photo by Luca Bravo on Unsplash](luca-bravo-alS7ewQ41M8-unsplash.jpg) 

![Photo by Helena Hertz on Unsplash](helena-hertz-wWZzXlDpMog-unsplash.jpg)  ![Photo by Hudai Gayiran on Unsplash](hudai-gayiran-3Od_VKcDEAA-unsplash.jpg)

相册语法来自 Typlog

归档

Tue, 28 May 2019 00:00:00 +0000

Markdown Syntax Guide

Mon, 11 Mar 2019 00:00:00 +0000

This article offers a sample of basic Markdown syntax that can be used in Hugo content files, also it shows whether basic HTML elements are decorated with CSS in a Hugo theme.

Headings

The following HTML <h1>—<h6> elements represent six levels of section headings. <h1> is the highest section level while <h6> is the lowest.

H1

H2

H3

H4

H5

H6

Paragraph

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.

Blockquotes

The blockquote element represents content that is quoted from another source, optionally with a citation which must be within a footer or cite element, and optionally with in-line changes such as annotations and abbreviations.

Blockquote without attribution

Tiam, ad mint andaepu dandae nostion secatur sequo quae. Note that you can use Markdown syntax within a blockquote.

Blockquote with attribution

Don’t communicate by sharing memory, share memory by communicating.
— Rob Pike¹

Tables

Tables aren’t part of the core Markdown spec, but Hugo supports supports them out-of-the-box.

Name	Age
Bob	27
Alice	23

Inline Markdown within tables

Italics	Bold	Code
italics	bold	`code`

A	B	C	D	E	F
Lorem ipsum dolor sit amet, consectetur adipiscing elit.	Phasellus ultricies, sapien non euismod aliquam, dui ligula tincidunt odio, at accumsan nulla sapien eget ex.	Proin eleifend dictum ipsum, non euismod ipsum pulvinar et. Vivamus sollicitudin, quam in pulvinar aliquam, metus elit pretium purus	Proin sit amet velit nec enim imperdiet vehicula.	Ut bibendum vestibulum quam, eu egestas turpis gravida nec	Sed scelerisque nec turpis vel viverra. Vivamus vitae pretium sapien

Code Blocks

Code block with backticks

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Example HTML5 Document</title>
</head>
<body>
  <p>Test</p>
</body>
</html>

Code block indented with four spaces

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Example HTML5 Document</title>
</head>
<body>
  <p>Test</p>
</body>
</html>

Code block with Hugo’s internal highlight shortcode

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Example HTML5 Document</title>
</head>
<body>
  <p>Test</p>
</body>
</html>

Diff code block

[dependencies.bevy]
git = "https://github.com/bevyengine/bevy"
rev = "11f52b8c72fc3a568e8bb4a4cd1f3eb025ac2e13"
- features = ["dynamic"]
+ features = ["jpeg", "dynamic"]

List Types

Ordered List

First item
Second item
Third item

Unordered List

List item
Another item
And another item

Nested list

Fruit
- Apple
- Orange
- Banana
Dairy
- Milk
- Cheese

Other Elements — abbr, sub, sup, kbd, mark

GIF is a bitmap image format.

H₂O

Xⁿ + Yⁿ = Zⁿ

Press CTRL + ALT + Delete to end the session.

Most salamanders are nocturnal, and hunt for insects, worms, and other small creatures.

Hyperlinked image

The above quote is excerpted from Rob Pike’s talk during Gopherfest, November 18, 2015. ↩︎

Placeholder Text

Sat, 09 Mar 2019 00:00:00 +0000

Lorem est tota propiore conpellat pectoribus de pectora summo.

Redit teque digerit hominumque toris verebor lumina non cervice subde tollit usus habet Arctonque, furores quas nec ferunt. Quoque montibus nunc caluere tempus inhospita parcite confusaque translucet patri vestro qui optatis lumine cognoscere flos nubis! Fronde ipsamque patulos Dryopen deorum.

Exierant elisi ambit vivere dedere
Duce pollice
Eris modo
Spargitque ferrea quos palude

Rursus nulli murmur; hastile inridet ut ab gravi sententia! Nomine potitus silentia flumen, sustinet placuit petis in dilapsa erat sunt. Atria tractus malis.

Comas hunc haec pietate fetum procerum dixit
Post torum vates letum Tiresia
Flumen querellas
Arcanaque montibus omnes
Quidem et

Vagus elidunt

The Van de Graaf Canon

Mane refeci capiebant unda mulcebat

Victa caducifer, malo vulnere contra dicere aurato, ludit regale, voca! Retorsit colit est profanae esse virescere furit nec; iaculi matertera et visa est, viribus. Divesque creatis, tecta novat collumque vulnus est, parvas. Faces illo pepulere tempus adest. Tendit flamma, ab opes virum sustinet, sidus sequendo urbis.

Iubar proles corpore raptos vero auctor imperium; sed et huic: manus caeli Lelegas tu lux. Verbis obstitit intus oblectamina fixis linguisque ausus sperare Echionides cornuaque tenent clausit possit. Omnia putatur. Praeteritae refert ausus; ferebant e primus lora nutat, vici quae mea ipse. Et iter nil spectatae vulnus haerentia iuste et exercebat, sui et.

Eurytus Hector, materna ipsumque ut Politen, nec, nate, ignari, vernum cohaesit sequitur. Vel mitis temploque vocatus, inque alis, oculos nomen non silvis corpore coniunx ne displicet illa. Crescunt non unus, vidit visa quantum inmiti flumina mortis facto sic: undique a alios vincula sunt iactata abdita! Suspenderat ego fuit tendit: luna, ante urbem Propoetides parte.

Math Typesetting

Fri, 08 Mar 2019 00:00:00 +0000

Mathematical notation in a Hugo project can be enabled by using third party JavaScript libraries.

In this example we will be using KaTeX

Create a partial under /layouts/partials/math.html
Within this partial reference the Auto-render Extension or host these scripts locally.
Include the partial in your templates like so:

1
2
3

{{ if or .Params.math .Site.Params.math }}
{{ partial "math.html" . }}
{{ end }}

To enable KaTeX globally set the parameter math to true in a project’s configuration
To enable KaTeX on a per page basis include the parameter math: true in content files

Note: Use the online reference of Supported TeX Functions

Examples

Inline math: $\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…$

Block math: $$ \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } $$

Emoji Support

Tue, 05 Mar 2019 00:00:00 +0000

Emoji can be enabled in a Hugo project in a number of ways.

The emojify function can be called directly in templates or Inline Shortcodes.

To enable emoji globally, set enableEmoji to true in your site’s configuration and then you can type emoji shorthand codes directly in content files; e.g.

🙈 :see_no_evil: 🙉 :hear_no_evil: 🙊 :speak_no_evil:

The Emoji cheat sheet is a useful reference for emoji shorthand codes.

N.B. The above steps enable Unicode Standard emoji characters and sequences in Hugo, however the rendering of these glyphs depends on the browser and the platform. To style the emoji you can either use a third party emoji font or a font stack; e.g.

1
2
3

.emoji {
  font-family: Apple Color Emoji, Segoe UI Emoji, NotoColorEmoji, Segoe UI Symbol, Android Emoji, EmojiSymbols;
}

关于

Mon, 01 Jan 0001 00:00:00 +0000

This is a test page for i18n support.

搜素

Mon, 01 Jan 0001 00:00:00 +0000

友情链接

Mon, 01 Jan 0001 00:00:00 +0000

To use this feature, add links section to frontmatter.

This page’s frontmatter:

links:
  - title: GitHub
    description: GitHub is the world's largest software development platform.
    website: https://github.com
    image: https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png
  - title: TypeScript
    description: TypeScript is a typed superset of JavaScript that compiles to plain JavaScript.
    website: https://www.typescriptlang.org
    image: ts-logo-128.jpg

image field accepts both local and external images.