1- # SITE SETUP
2- # Guide: https://docs.hugoblox.com/tutorial/
3- # Documentation: https://docs.hugoblox.com/
4- # This file is formatted using YAML syntax - learn more at https://learnxinyminutes.com/docs/yaml/
5-
6- # ==============================================================================
1+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
72# HUGO BLOX CONFIGURATION
8- # ==============================================================================
3+ # Schema: hugoblox.com/schema/v2
4+ # Tutorial: https://docs.hugoblox.com/tutorial/
5+ # Documentation: https://docs.hugoblox.com/
6+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
97hugoblox :
8+ schema : " 2.0"
9+
1010 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
11- # BRANDING
12- # Your site's identity - used in navbar, footer, SEO, and copyright
11+ # IDENTITY
12+ # Site-level branding (for people/profiles, use the author system in content/authors/)
1313 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
14- branding :
15- # Display name shown in navbar and general site display
14+ identity :
15+ # Site name - shown in navbar, footer, copyright, and browser title by default
1616 name : " Your Name"
17- # Optional: Browser tab title (defaults to name if not set)
18- # site_title: "Your Name | Research"
19- # Optional: Legal/copyright entity (defaults to name if not set)
20- # organization: "Your Full Legal Name"
17+ # Legal entity for copyright notices (defaults to name if not set)
18+ organization : " "
19+ # Schema.org type for structured data
20+ type : person # person | organization | local_business
21+ # Short tagline displayed on your site
22+ tagline : " "
23+ # Site meta description for search engines and social sharing
24+ description : " The highly-customizable Hugo Academic theme powered by Hugo Blox Builder. Easily create your personal academic website."
25+ # Social accounts (used for meta tags like Twitter Cards)
26+ social :
27+ twitter : " BuildLore" # Twitter/X handle for Twitter Cards (without @)
2128
2229 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
2330 # THEME
24- # Controls colors and appearance
31+ # Color and visual design system
2532 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
2633 theme :
2734 # Mode: 'light', 'dark', or 'system' (follows OS preference)
2835 mode : system
2936 # Theme pack: name from data/themes/ or { light: "x", dark: "y" } for mix-and-match
3037 pack : " default"
3138 # Optional: Override theme pack colors
32- # colors:
33- # primary: "indigo" # Tailwind palette name or hex (e.g., "#6366f1")
34- # secondary: "emerald"
35- # neutral: "stone" # Affects gray utilities (text-gray-*, bg-gray-*)
39+ colors :
40+ primary : " " # Tailwind palette name or hex (e.g., "indigo" or "#6366f1")
41+ secondary : " "
42+ neutral : " " # Affects gray utilities (text-gray-*, bg-gray-*)
43+ # Optional: Mode-specific color overrides
44+ colors_light : {}
45+ colors_dark : {}
46+ # Optional: Semantic surface color overrides
47+ surfaces :
48+ background : " "
49+ foreground : " "
50+ header :
51+ background : " "
52+ foreground : " "
53+ footer :
54+ background : " "
55+ foreground : " "
3656
3757 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
3858 # TYPOGRAPHY
39- # Controls fonts and text sizing
59+ # Font and text sizing
4060 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
4161 typography :
4262 # Font: 'sans' (Inter), 'serif' (Roboto Slab), or 'native' (system fonts)
@@ -46,77 +66,228 @@ hugoblox:
4666
4767 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
4868 # LAYOUT
49- # Controls spacing and visual structure
69+ # Spacing and shape tokens
5070 # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
5171 layout :
5272 # Border radius: 'none', 'sm', 'md', 'lg', or 'full'
5373 radius : " md"
5474 # Spacing density: 'compact', 'comfortable', or 'spacious'
5575 spacing : " comfortable"
76+ # Avatar shape in author profiles
77+ avatar_shape : circle # circle | square | rounded
5678
57- # ==============================================================================
58- # SEO & MARKETING
59- # ==============================================================================
60- marketing :
61- seo :
62- site_type : Person
63- local_business_type : ' '
64- description : ' The highly-customizable Hugo Academic theme powered by Hugo Blox Builder. Easily create your personal academic website.'
65- twitter : ' BuildLore'
66- llm :
67- allow :
68- - /
69- disallow : []
70- note : ' Guidance for AI crawlers - customize to match your public content.'
71- contact : ' '
72- policy_url : ' '
73- analytics :
74- google_analytics : ' '
75- baidu_tongji : ' '
76- plausible : ' '
77- fathom : ' '
78- pirsch : ' '
79- verification :
80- google : ' '
81- baidu : ' '
82-
83- # ==============================================================================
84- # SITE HEADER
85- # ==============================================================================
86- header :
87- navbar :
79+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
80+ # HEADER
81+ # Site header and navigation bar
82+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
83+ header :
8884 enable : true
89- block : ' navbar'
90- fixed_to_top : true
91- show_search : true
92- show_mode_toggle : true
93- show_theme_picker : true
94-
95- # ==============================================================================
96- # SITE FOOTER
97- # ==============================================================================
98- footer :
85+ # Header style variant
86+ style : navbar # navbar | navbar-simple | minimal
87+ # Stick to top on scroll
88+ sticky : true
89+ # Menu alignment
90+ align : center # left | center | right
91+ # Feature toggles
92+ search : true
93+ theme_toggle : true
94+ theme_picker : false
95+ language_switcher : true
96+ # Call-to-action button
97+ cta :
98+ enable : false
99+ text : " "
100+ url : " "
101+
102+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
103+ # FOOTER
104+ # Site footer
105+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
106+ footer :
107+ # Footer style variant
108+ style : minimal # minimal | columns | centered
109+ language_switcher : true
110+ # Custom footer text (HTML supported)
111+ text : " "
112+
113+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
114+ # COPYRIGHT
115+ # Legal notices and licensing
116+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
99117 copyright :
100- # Use {year} for current year, {name} for branding.organization , {license} for CC license link
101- notice : ' ยฉ {year} {name}. This work is licensed under {license}'
118+ # Copyright notice - supports { year} , {name}, {license} placeholders
119+ notice : " ยฉ {year} {name}. This work is licensed under {license}"
102120 license :
103- enable : true
121+ type : cc # cc | all_rights | custom
104122 allow_derivatives : false
105123 share_alike : true
106124 allow_commercial : false
107125
108- # ==============================================================================
109- # LOCALIZATION
110- # ==============================================================================
111- locale :
112- date_format : ' Jan 2, 2006'
113- time_format : ' 3:04 PM'
114-
115- # ==============================================================================
116- # SITE FEATURES
117- # ==============================================================================
118- features :
119- math :
126+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
127+ # SEO
128+ # Search engine optimization - overrides and technical settings
129+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
130+ seo :
131+ # Browser tab title override (defaults to identity.name if not set)
132+ title : " "
133+ # For local_business identity type only
134+ location :
135+ address :
136+ street : " "
137+ city : " "
138+ region : " "
139+ postal_code : " "
140+ country : " "
141+ coordinates :
142+ latitude : null
143+ longitude : null
144+ phone : " "
145+ # AI/LLM crawler guidance (llms.txt)
146+ ai :
147+ allow :
148+ - /
149+ disallow : []
150+ note : " Guidance for AI crawlers - customize to match your public content."
151+ contact : " "
152+
153+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
154+ # CONTENT
155+ # Content rendering and behavior
156+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
157+ content :
158+ # Math rendering
159+ math :
160+ enable : false
161+ # Table of contents
162+ toc :
163+ enable : true
164+ # Reading time estimates
165+ reading_time :
166+ enable : true
167+ # Academic citations
168+ citations :
169+ style : apa # apa | mla | chicago | ieee
170+
171+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
172+ # SEARCH
173+ # Site search
174+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
175+ search :
176+ enable : true
177+ # Trending/suggested search terms
178+ suggestions : []
179+ # Quick action shortcuts in search modal
180+ quick_actions : []
181+
182+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
183+ # COMMENTS
184+ # User comments system
185+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
186+ comments :
187+ enable : false
188+ provider : " " # giscus | disqus | commento
189+ giscus :
190+ repo : " "
191+ repo_id : " "
192+ category : " "
193+ category_id : " "
194+ disqus :
195+ shortname : " "
196+ commento :
197+ url : " "
198+
199+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
200+ # ANALYTICS
201+ # Traffic and behavior analytics
202+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
203+ analytics :
204+ google :
205+ measurement_id : " " # Google Analytics 4: G-XXXXXXXXXX
206+ google_tag_manager :
207+ container_id : " " # GTM-XXXXXXX
208+ plausible :
209+ domain : " "
210+ fathom :
211+ site_id : " "
212+ pirsch :
213+ site_id : " "
214+ clarity :
215+ project_id : " "
216+ baidu :
217+ site_id : " "
218+
219+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
220+ # VERIFICATION
221+ # Search engine site verification codes
222+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
223+ verification :
224+ google : " "
225+ bing : " "
226+ baidu : " "
227+ yandex : " "
228+ pinterest : " "
229+ naver : " "
230+
231+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
232+ # REPOSITORY
233+ # Source code repository for "Edit this page" links
234+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
235+ repository :
120236 enable : false
121- privacy_pack :
237+ url : " " # e.g., https://github.com/username/repo
238+ branch : main
239+ content_dir : content
240+
241+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
242+ # LOCALE
243+ # Regional formatting preferences
244+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
245+ locale :
246+ date_format : " Jan 2, 2006" # Go time format
247+ time_format : " 3:04 PM"
248+ address_format : en-us
249+
250+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
251+ # SECURITY
252+ # Security headers and policies (requires blox-plugin-netlify)
253+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
254+ security :
255+ csp :
256+ policy : " "
257+ report_only : false
258+ frame_options : deny # deny | sameorigin | allow
259+ permissions_policy : " "
260+
261+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
262+ # PRIVACY
263+ # Privacy and compliance features
264+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
265+ privacy :
266+ enable : false
267+ anonymize_analytics : true
268+
269+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
270+ # DEBUG
271+ # Development and debugging (hidden in production)
272+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
273+ debug :
122274 enable : false
275+ hud :
276+ position : bottom-left # top-left | top-right | bottom-left | bottom-right
277+ opacity : 1.0
278+ export_logs : true
279+
280+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
281+ # PRO
282+ # Pro subscription features and affiliate program
283+ # โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
284+ pro :
285+ # Hide "Powered by HugoBlox" attribution
286+ # Requires: Pro subscription to support HugoBlox via alternative means
287+ # Note: Even with Pro, you can keep this false to support open source!
288+ # Get Pro: https://hugoblox.com/pro
289+ hide_attribution : false
290+
291+ # Affiliate referral code for rewards program
292+ # Join affiliate program: https://hugoblox.com/affiliates
293+ affiliate_code : " "
0 commit comments