eric/bridget
1
0
Fork 0
mirror of https://github.com/Sped0n/bridget.git synced 2026-04-21 21:49:31 -07:00
Code Issues Packages Projects Releases Wiki Activity

blind commit (#249)

Browse Source
This commit is contained in:
Spedon
2024-01-21 21:33:20 +08:00
committed by GitHub
parent 480df04e55
commit cf2f36d232
1 changed files with 22 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
doc/getStarted.md
View File

@@ -36,9 +36,9 @@ If you are already using Git for your site, you can add the theme as a submodule
git submodule add https://github.com/Sped0n/bridget themes/bridget git submodule add https://github.com/Sped0n/bridget themes/bridget
``` ```
> ⚠️⚠️⚠️ > ⚠️⚠️⚠️
> >
> Please refer to the config section for the following content. > Please refer to the config section for the following content.
### Module (recommended) ### Module (recommended)
@@ -69,9 +69,9 @@ If you want to upgrade the theme, just run:
hugo mod get -u hugo mod get -u
``` ```
> ⚠️⚠️⚠️ > ⚠️⚠️⚠️
> >
> Please refer to the config section for the following content. > Please refer to the config section for the following content.
## Content Management ## Content Management
@@ -164,8 +164,9 @@ path = "github.com/Sped0n/bridget"
``` ```
- If you have <u>installation with Git</u> - If you have <u>installation with Git</u>
- `replacement`: replace the <u>path after the arrow</u>(`../..`) with the location of your local theme file (⚠️⚠️⚠️**relative path only**, example: `themes/bridget`)
- `path`: no change - `replacement`: replace the <u>path after the arrow</u>(`../..`) with the location of your local theme file (⚠️⚠️⚠️**relative path only**, example: `themes/bridget`)
- `path`: no change
- If you have <u>installation with Module</u>, **remove the `replacements` configuration**. - If you have <u>installation with Module</u>, **remove the `replacements` configuration**.
@@ -184,8 +185,6 @@ Detailed description in the comments.
> For users who have installation with module, please always set this option to `true`, unless you know what you are doing. > For users who have installation with module, please always set this option to `true`, unless you know what you are doing.
> >
> Or you might get the error related to `node_modules/swiper/swiper.scss`. > Or you might get the error related to `node_modules/swiper/swiper.scss`.
>
### `sitemap.toml` ### `sitemap.toml`
@@ -193,25 +192,24 @@ https://gohugo.io/templates/sitemap-template/#configuration
## Customization (AKA for developer) ## Customization (AKA for developer)
> Before heading to this section, please make sure you have **installation with Git**. > Before heading to this section, please make sure you have **installation with Git**.
### Option 1: *it just works* way ### Option 1: _it just works_ way
> If you want to modify js/ts file, please use option 2. > If you want to modify js/ts file, please use option 2.
1. Use hugo create a site and move the bridget theme into the theme directory. 1. Use hugo create a site and move the bridget theme into the theme directory.
2. Run `npm install` in the <u>bridget theme root dir</u>, not <u>your hugo site root dir</u>. 2. Run `npm install` in the <u>bridget theme root dir</u>, not <u>your hugo site root dir</u>.
3. After the command is done, copy the `node_modules` dir from <u>bridget theme root dir</u> to <u>your hugo site root dir</u>. 3. After the command is done, copy the `node_modules` dir from <u>bridget theme root dir</u> to <u>your hugo site root dir</u>.
4. In <u>your hugo site root dir</u>, write/modify configuration files according to your needs, remember to set `bundled` option to `false`, so hugo will not use prebuilt css file. 4. In <u>your hugo site root dir</u>, write/modify configuration files according to your needs, remember to set `bundled` option to `false`, so hugo will not use prebuilt css file.
5. Run `hugo server` in <u>your hugo site root dir</u>, and you are good to go. 5. Run `hugo server` in <u>your hugo site root dir</u>, and you are good to go.
### Option 2: recommended way ### Option 2: recommended way
1. Use hugo create a site and move the bridget theme into the theme directory. 1. Use hugo create a site and move the bridget theme into the theme directory.
2. Run `npm install` in the <u>bridget theme root dir</u>, not <u>your hugo site root dir</u>. 2. Run `npm install` in the <u>bridget theme root dir</u>, not <u>your hugo site root dir</u>.
3. Run `npm run dev` in the <u>bridget theme root dir</u>, we will use content in exampleSite to debug. 3. Run `npm run dev` in the <u>bridget theme root dir</u>, we will use content in exampleSite to debug.
4. Make your customization. 4. Make your customization.
5. After modification, run `npm run build` in the <u>bridget theme root dir</u> to build artifacts. 5. After modification, run `npm run build` in the <u>bridget theme root dir</u> to build artifacts.
6. In <u>your hugo site root dir</u>, write/modify configuration files according to your needs, remember to set `bundled` option to `true`, so hugo will use the artifacts you built in step 5. 6. In <u>your hugo site root dir</u>, write/modify configuration files according to your needs, remember to set `bundled` option to `true`, so hugo will use the artifacts you built in step 5.
7. Run `hugo server` in <u>your hugo site root dir</u>, and you are good to go. 7. Run `hugo server` in <u>your hugo site root dir</u>, and you are good to go.