Skip to content

Commit cc4e9da

Browse files
committed
update README for refresh
1 parent 2e64734 commit cc4e9da

File tree

1 file changed

+63
-75
lines changed

1 file changed

+63
-75
lines changed

README.md

Lines changed: 63 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<h1 align="center">online-resume</h1>
1+
<h1 align="center">bot-ready-resume</h1>
22

33

44
<h4 align="center">A minimalist Hugo theme for your resume, refreshed for LLM crawlers.</h4>
@@ -7,7 +7,7 @@
77

88
## Live Demo
99

10-
:point_right: [online-resume][Demo] :point_left:
10+
:point_right: [bot-ready-resume][Demo] :point_left:
1111

1212
## Getting Started
1313

@@ -26,101 +26,89 @@ Features:
2626
- LLM-friendly output formats (llms.txt, markdown alt content, steering prompts for llms).
2727
- Modular & responsive content design.
2828

29-
### Usage
30-
31-
#### Quickly
32-
33-
- Create new hugo site and add the theme through git submodule.
34-
- `hugo new site resume`
35-
- `cd resume && git init`
36-
- `git submodule add git@github.com:nbovee/bot-ready-resume.git themes/online-resume`
37-
- Copy `hugo.yml` and `data.yml` files.
38-
- `cp themes/online-resume/exampleSite/hugo.yml .`
39-
- `cp themes/online-resume/exampleSite/data/data.yml ./data`
40-
- Edit `data/data.yml` file directly to update your resume.
41-
- Run `hugo server` and open in browser to preview the resume.
42-
43-
#### Customization
44-
45-
- `data/data.yml`: Edit the resume content.
46-
- `basic.initials`: Optional field to override auto-parsed initials used in favicons.
47-
- `llmPrompt`: Optional section to provide additional instructions for LLM consumption via llms.txt.
48-
- `contact`: For contact icons, use Font Awesome icon classes (e.g., `fa-brands fa-fw fa-github`). Search available icons at [Font Awesome](https://fontawesome.com/icons) using `fa-solid` for regular icons or `fa-brands` for brand logos. Additional custom icons are available in `static/assets/icons/css/all.css`.
49-
- `static/images/profile.png`: Your profile photo.
50-
- `static/images/favicon-32x32.png` and `static/favicon.ico`: Optional fallback favicons for older browsers (SVG favicons are auto-generated).
51-
- `hugo.yml`: Website and theme style settings.
52-
- `params.themeColor`: Theme color in OKLCH format (e.g., `"oklch(0.490 0.203 317.8)"`) or hex format (e.g., `"#1DA1F2"`). The remainder of colors are dynamically created in `colors.html`.
53-
- `params.llms.txt`: Enable/disable llms.txt output format.
54-
- `params.llmHeader`: Add LLM guidance as HTML comment in page head.
55-
- `params.bodyDelimiter`: Delimiter for body content items.
56-
- `params.siteCredit`: Show/hide site credits.
57-
- `outputFormats`: Configure markdown and llmstxt output formats.
29+
### Quick Start
5830

59-
## FAQ
31+
```bash
32+
# Create new Hugo site
33+
hugo new site my-resume
34+
cd my-resume
6035

61-
#### How to enable LLM-friendly output formats?
36+
# Add theme as submodule
37+
git init
38+
git submodule add https://github.com/nbovee/bot-ready-resume.git themes/bot-ready-resume
6239

63-
The theme can generate additional output formats optimized for LLM consumption:
64-
- Set `params.llms.txt: true` in `hugo.yml` to enable llms.txt output at `/llms.txt`.
65-
- Set `params.llmHeader: true` to add LLM guidance as an HTML comment in the page head.
66-
- Add custom instructions in `data.yml` under `llmPrompt.text`.
67-
- Configure `outputFormats` and `outputs` in `hugo.yml` to enable markdown and llms.txt formats.
40+
# Copy configuration files
41+
mkdir -p data
42+
cp themes/bot-ready-resume/exampleSite/hugo.yml .
43+
cp themes/bot-ready-resume/exampleSite/data/data.yml data/
6844

69-
#### How does dark mode work?
45+
# Start development server
46+
hugo server
47+
```
7048

71-
The theme includes an automatic dark mode toggle that:
72-
- Detects system color scheme preference on initial load.
73-
- Stores user preference in localStorage for subsequent visits.
74-
- Provides a manual toggle switch in the UI.
75-
- Automatically switches to light mode when printing.
76-
- Updates the favicon to match the current theme.
49+
Open your browser to `http://localhost:1313` to see your resume.
50+
Your will also have `llms.txt` at `http://localhost:1313/llms.txt`, and a markdown output at `http://localhost:1313/index.md`
7751

78-
#### How are favicons generated?
52+
Edit `data/data.yml` to customize your resume content.
53+
54+
### Customization
7955

80-
Favicons are automatically generated from the user's name in `data.yml`:
81-
- Uses the first letter of the first and last name (e.g., "John Doe" → "JD").
82-
- Can be overridden by setting `basic.initials` in `data.yml`.
83-
- Generates both light and dark theme variants.
84-
- Uses the theme color for accent elements.
85-
- Creates SVG favicons with asset fingerprinting for cache busting.
86-
- Includes PNG and ICO fallbacks for broader browser support.
56+
#### Essential Files
8757

88-
#### How to use OKLCH colors?
58+
- **`data/data.yml`** - Your resume content (name, experience, skills, etc.)
59+
- **`hugo.yml`** - Theme configuration and styling options
60+
- **`static/images/profile.png`** - Your profile photo
8961

90-
Set `params.themeColor` in `hugo.yml` using the OKLCH format: `"oklch(L C H)"` where:
91-
- L = Lightness (0-1)
92-
- C = Chroma (0-0.4)
93-
- H = Hue (0-360)
62+
#### Key Configuration Options
9463

95-
Example: `"oklch(0.490 0.203 317.8)"` for a purple theme. The theme will handle color space conversion and ensure proper contrast.
64+
**In `data/data.yml`:**
65+
- `basic.initials` - Override auto-generated favicon initials (optional)
66+
- `llmPrompt` - Add instructions for LLM consumption via llms.txt (optional)
67+
- `contact` - Use Font Awesome icon classes (e.g., `fa-brands fa-github`). Browse icons at [fontawesome.com/icons](https://fontawesome.com/icons)
9668

97-
#### How to change the order of the sections in the resume?
69+
**In `hugo.yml`:**
70+
- `params.themeColor` - Theme color in OKLCH (e.g., `"oklch(0.490 0.203 317.8)"`) or hex (e.g., `"#1DA1F2"`)
71+
- `params.llms.txt` - Enable llms.txt output format (`true`/`false`)
72+
- `params.llmHeader` - Add LLM guidance in HTML head (`true`/`false`)
73+
- `params.siteCredit` - Show/hide footer credits (`true`/`false`)
9874

99-
There is an `order` option in each section, you can adjust the order by modifying this, the smaller the value the more forward the position.
75+
See the [exampleSite](exampleSite/) directory for a complete configuration reference.
10076

101-
#### How to hide the specified section in the resume?
77+
## FAQ
10278

103-
If there is no content you want to keep in the section, you can remove it directly. If you want to keep the content, you can set the value of the `show` option of the section to `false`.
79+
#### How do I change section order or visibility?
10480

81+
Each section in `data/data.yml` has an `order` field (lower numbers appear first) and a `show` field (`true`/`false`).
10582

83+
#### How do I enable LLM-friendly output?
10684

107-
#### How to create a resume in other languages?
85+
The exampleSite includes LLM features by default. The theme generates:
86+
- `/llms.txt` endpoint for structured LLM consumption
87+
- Markdown alt content for accessibility
88+
- Optional HTML comment guidance for LLMs
10889

109-
For example, if you already have an English version resume and you want to create a Chinese version.
110-
- Copy a `data.yml` file in the `data` folder named `cn.yml` and edit the content.
111-
- Create `layouts/page` directories through `mkdir -p layouts/page`.
112-
- Copy `index.html` file in the theme layouts directory to above directory `cp themes/online-resume/layouts/index.html layouts/page/cn.html`
113-
- Change the `{{- partial "common.html" (dict "Site" .Site "data" .Site.Data.data) }}` in the `cn.html` to `{{- partial "common.html" (dict "Site" .Site "data" .Site.Data.cn) }}`.
114-
- Create `content` directory in root directory and create a markdown file named `cn.md`, add front matter `layout: cn` in `cn.md`.
115-
- Run `hugo server` and you can preview the Chinese version of your resume by visiting `https://YOUR_RESUME_URL/cn`.
90+
Enable/disable via `params.llms.txt` and `params.llmHeader` in `hugo.yml`.
11691

92+
#### How does dark mode work?
11793

118-
## Others
94+
Dark mode automatically detects system preference, stores user preference in localStorage, and provides a manual toggle. It switches to light mode when printing and updates the favicon accordingly.
11995

120-
- Original Hugo Version: [tarrex/hugo-theme-online-resume][Base Version]
96+
#### What are OKLCH colors?
12197

98+
OKLCH is a modern color space that provides better perceptual uniformity. Format: `"oklch(L C H)"` where L=Lightness (0-1), C=Chroma (0-0.4), H=Hue (0-360). Example: `"oklch(0.490 0.203 317.8)"` for purple. Hex colors also work.
12299

123-
[Demo]: https://nick.bov.ee/bot-ready-resume
100+
#### How do I add a language version?
124101

102+
Create a new data file (e.g., `data/cn.yml`), create a layout file that references it, and add a content page with the corresponding layout. See the README for detailed steps or check the Hugo multilingual documentation.
125103

126-
[Base Version]: https://github.com/tarrex/hugo-theme-online-resume
104+
#### How are favicons generated?
105+
106+
Favicons auto-generate from your name (e.g., "John Doe" → "JD"), using theme colors with light/dark variants. Override via `basic.initials` in `data.yml`. 1-3 characters works best.
107+
108+
109+
## Other
110+
111+
- This repository was originally forked from: [tarrex/hugo-theme-online-resume](https://github.com/tarrex/hugo-theme-online-resume)
112+
113+
114+
[Demo]: https://nick.bov.ee/bot-ready-resume

0 commit comments

Comments
 (0)