logo
0
0
WeChat Login
liyao52033<1503027549@qq.com>
feat:修改README.md

要求

安装hugo

windows

首先安装scoop,打开 一个PowerShell终端 ( Windows PowerShell 5.1版本5.1以上或PowerShell),执行

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

然后安装hugo

scoop install hugo-extended

macos

brew install hugo-extended

linux

Ubuntu/debian

sudo apt install hugo-extended

centos

yum install hugo-extended -y

初始化项目

克隆模板

git clone https://cnb.cool/liyao52033/hugo-site

安装依赖

yarn

注意:如果您的站点已经有 git 存储库,您可以使用站点 git 存储库的路径来初始化您的站点,将go.mod中的module进行修改,例如module github.com/<user>/<my-docs-site>/

现在,您可以从以下选项中选择将 Lotus Docs 主题添加到新站点的首选方法

安装选项

主题可通过以下方法之一安装:

  • 作为hugo模块(推荐)
  • 作为 Git 子模块
  • 本地克隆主题文件

先修条件:

  • contentDir项目文件夹中的存在,scripts/add-frontmatter.js中config.contentDir目录需与此文件夹一致

安装为Hugo模块(推荐)

编辑 hugo.toml 配置文件,将主题Hugo Bootstrap模块作为模块加入:

baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' contentDir = 'content' enableEmoji = true [module] [[module.imports]] path = "cnb.cool/liyao52033/hugopress/v2" disable = false

作为 Git 子模块安装

从你的项目根节点执行以下 git 命令:

git init git submodule add https://cnb.cool/liyao52033/hugopress themes/hugopress

编辑 hugo.toml 配置文件:

baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' contentDir = 'content' enableEmoji = true [module] # uncomment line below for temporary local development of module # or when using a 'theme' as a git submodule replacements = "cnb.cool/liyao52033/hugopress -> hugopress" [[module.imports]] path = "cnb.cool/liyao52033/hugopress/v2" disable = false

本地安装

有些情况下,你可能更愿意自己定制和维护主题。在这种情况下,可以用git来克隆主题到 themes/hugopress 目录中:

git clone https://cnb.cool/liyao52033/hugopress themes/hugopress

编辑 hugo.toml 配置文件:

baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' [module] # uncomment line below for temporary local development of module, # when using a 'theme' as a git submodule or git cloned files replacements = "cnb.cool/liyao52033/hugopress -> hugopress" [[module.imports]] path = "cnb.cool/liyao52033/hugopress/v2" disable = false

创建新内容并预览网站

导航到你 Hugo 项目的根节点,在content/docs 目录中创建一个Markdown文件 ,然后执行

yarn run dev

这会自动创建fromtmatter并在本地预览您的网站,默认如下,也可以自动修改scripts/add-frontmatter.js

--- title: "Example Page" tags: categories: date: 2023-08-21T09:11:30.000Z url: /pages/6676cf type: docs description: cover: https://cnb.xiaoying.org.cn?random=/pages/ac8b70 private: false weight: 100 license: true twikoo: true footer: false ---

根据你的需求,修改上述前置选项。

登录页面

在forntmatter上添加登录页面的配置private: true即可 后端接口用的是supabase,需要在edgeone pages自建

1、先在supabase官网注册账号,然后获取Project URLAPI key

2、edgeone pages 一键部署后端接口

第一步,点击下面按钮一键部署

使用 EdgeOne Pages 部署

第二步,先选择Git平台,然后配置环境变量,点击立即创建

SUPABASE_URL= SUPABASE_ANON_KEY= ACCESS_PASSWORD= MAIN_DOMAIN=

3、配置部署后的域名

hugo.toml中配置

[params.login] domain="https://yourdomain.com"

脚本说明

"scripts": { "dev": "node scripts/add-frontmatter.js && hugo server --disableFastRender -D -F", //自动新增frontmatter并启动开发模式 "server:prod": "bash scripts/start.sh", // 生产模式预览 "build": "hugo --gc --minify -D -F", // 打包 "build:log": "hugo --gc --minify -D -F --logLevel debug", // 详细日志打包 "build:prod": "bash scripts/build.sh", // 注入环境变量再打包 "clean": "rm -rf resources dist .edgeone", // 清除缓存 "proxy": "node scripts/proxy.js", //启动代理 "update": "hugo mod get ./...", //更新主题 "deploy": "yarn run clean && edgeone pages deploy -n vuepress-vdoing" //部署到edgeone pages,文档 https://cloud.tencent.com/document/product/1552/127423 },