RandomChugokujin/leikah
GitHub: RandomChugokujin/leikah
一个基于 Hugo 和 Docsy 的道德黑客技术文档网站,解决渗透测试知识碎片化与检索困难问题。
Stars: 1 | Forks: 0
# [LEIKAH](https://leikah.haoyingcao.xyz/en/)
代表 **Literally Everything I Know About Hacking**。
LEIKAH 是一个使用 [Hugo](https://gohugo.io/) 静态网站生成器和 [Doscy](https://github.com/google/docsy) 模板构建的道德黑客技术文档网站。
## 目标
- 记录道德黑客中使用的技巧、工具、命令及其对应的示例输出
- 提供上下文知识,帮助读者理解在何种情况下最佳使用每种技巧以及如何进行故障排除
## 面向人群
如果你是以下人群之一,这个网站适合你:
- 你是网络安全行业专业人士
- 你是学习道德黑客的学生(OSCP、CPTS、CRTO 等)
## 本地运行网站
构建和本地运行网站需要较新版本的 `extended` [Hugo](https://gohugo.io) 以及较新版本的 [go](https://go.dev/dl/)。
你可以在 Docsy 的
[入门指南](https://www.docsy.dev/docs/getting-started/#prerequisites-and-installation) 中找到更多关于如何为你的环境安装 Hugo 的信息。
在克隆网站仓库后,从仓库根目录运行:
```
npm install && hugo server
```
然后,在浏览器中导航到 `http://localhost:1313`,你应该能够查看网站的本地版本。
## 故障排除
当你本地运行网站时,可能会遇到以下错误:
```
$ hugo server
WARN 2023/06/27 16:59:06 Module "project" is not compatible with this Hugo version; run "hugo mod graph" for more information.
Start building sites …
hugo v0.101.0-466fa43c16709b4483689930a4f9ac8add5c9f66+extended windows/amd64 BuildDate=2022-06-16T07:09:16Z VendorInfo=gohugoio
Error: Error building site: "C:\Users\foo\path\to\docsy-example\content\en\_index.md:5:1": failed to extract shortcode: template for shortcode "blocks/cover" not found
Built in 27 ms
```
如果你的 Hugo 版本过时,就会出现此错误。从 docsy 主题版本 `v0.12.0` 开始,需要 Hugo 版本 `0.146.0` 或更高。
请参阅此 [章节](https://www.docsy.dev/docs/get-started/docsy-as-module/installation-prerequisites/#install-hugo) 的用户指南了解安装 Hugo 的说明。
或者,你可能会遇到以下错误:
```
$ hugo server
INFO 2021/01/21 21:07:55 Using config file:
Building sites … INFO 2021/01/21 21:07:55 syncing static files to /
Built in 288 ms
Error: Error building site: TOCSS: failed to transform "scss/main.scss" (text/x-scss): resource "scss/scss/main.scss_9fadf33d895a46083cdd64396b57ef68" not found in file cache
```
如果你没有安装 Hugo 的 extended 版本,就会出现此错误。
请参阅此 [章节](https://www.docsy.dev/docs/get-started/docsy-as-module/installation-prerequisites/#install-hugo) 的用户指南了解安装 Hugo 的说明。
或者,你可能会遇到以下错误:
```
$ hugo server
Error: failed to download modules: binary with name "go" not found
```
如果你的系统中没有可用的 `go` 编程语言,请确保已安装 `go` 1.12 或更高版本。
标签:CPTS, CRTO, Docsy, Doscy, Hugo, OSCP, Ruby, SEO, 安全从业, 安全文档, 技术备忘, 技术文档, 故障排除, 数据可视化, 本地开发, 知识库, 网站搭建, 网络安全, 网络安全研究, 隐私保护, 静态网站生成器