[{"data":1,"prerenderedAt":227},["ShallowReactive",2],{"navigation":3,"\u002Fblog\u002F2026-08-21-seles-docs-site":22,"\u002Fblog\u002F2026-08-21-seles-docs-site-surround":223},[4],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Blog","\u002Fblog","blog",[9,13,17],{"title":10,"path":11,"stem":12},"OurObit.org memorial service launches","\u002Fblog\u002F2026-05-16-ourobit-memorial-service-launches","blog\u002F2026-05-16-ourobit-memorial-service-launches",{"title":14,"path":15,"stem":16},"OurObit.org survey: fridge magnet design","\u002Fblog\u002F2026-06-14-ourobit-keepsake-survey","blog\u002F2026-06-14-ourobit-keepsake-survey",{"title":18,"path":19,"stem":20},"Building the SELES documentation site","\u002Fblog\u002F2026-08-21-seles-docs-site","blog\u002F2026-08-21-seles-docs-site",false,{"id":23,"title":18,"author":24,"body":28,"date":214,"description":215,"extension":216,"image":217,"meta":218,"minRead":219,"navigation":220,"path":19,"seo":221,"stem":20,"__hash__":222},"blog\u002Fblog\u002F2026-08-21-seles-docs-site.md",{"name":25,"avatar":26},"Charles Burnett",{"src":27,"alt":25},"\u002Fprofile.png",{"type":29,"value":30,"toc":205},"minimark",[31,36,48,62,66,72,87,97,103,113,119,123,132,191,195,198,202],[32,33,35],"h2",{"id":34},"background","Background",[37,38,39,40,47],"p",{},"SELES (Spatially Explicit Landscape Event Simulator) is landscape simulation software by Andrew Fall of Gowlland Technologies Ltd. Read more about SELES ",[41,42,46],"a",{"href":43,"rel":44},"http:\u002F\u002Fgowlland.ca\u002Fabout_seles.html",[45],"nofollow","here",". Some years ago I created a documentation site for SELES using MediaWiki. Earlier this summer Andrew told me that there was still a need for online docs, and I promised to stand one up—and I decided to use BC Government design standards and code as a case study.",[37,49,50,51,56,57,61],{},"The result is ",[41,52,55],{"href":53,"rel":54},"https:\u002F\u002Fdocs.seles.info",[45],"docs.seles.info",", with a conceptual framework, file syntax reference, user interface guide, case studies, a model garden and tutorials. It is an independent site, ",[58,59,60],"strong",{},"not an official BC Government site",".",[32,63,65],{"id":64},"implementation-highlights","Implementation Highlights",[37,67,68,71],{},[58,69,70],{},"Choosing Docusaurus."," I used Docusaurus v3 (TypeScript, classic preset). It is MIT-licensed, maintained by Meta Open Source, and gives me sidebars and Markdown authoring without building anything custom.",[37,73,74,77,78,82,83,86],{},[58,75,76],{},"BC Government design system."," I styled the site with BC Sans, the ",[79,80,81],"code",{},"@bcgov\u002Fdesign-tokens"," CSS variables and the BC Gov blue (",[79,84,85],{},"#013366","), mapped onto Docusaurus's Infima variables. I did this partly as a demonstration, so other BC Gov and BC Gov-adjacent teams can reuse the approach. There are no copyleft dependencies in the stack: Docusaurus is MIT, the design packages are Apache-2.0 and BC Sans uses the SIL Open Font License.",[37,88,89,92,93,96],{},[58,90,91],{},"Hosting on Cloudflare Pages."," The site deploys as a static site straight from GitHub. Every push to ",[79,94,95],{},"main"," triggers a build, with no CI config in the repo. Because the repo is public on GitHub, contributors can propose additions and changes as pull requests.",[37,98,99,102],{},[58,100,101],{},"Several independent doc sections."," Docs, Case Studies, Model Garden and Tutorials each have their own sidebar, using extra instances of the Docusaurus docs plugin.",[37,104,105,108,109,112],{},[58,106,107],{},"Local search."," I used ",[79,110,111],{},"@easyops-cn\u002Fdocusaurus-search-local",". It needs no third-party service, signup or API key, because it builds the index at build time and ships it as a static file.",[37,114,115,118],{},[58,116,117],{},"Privacy-friendly analytics."," Umami Cloud is cookieless and collects no personal data. A small notice on the site tells visitors this.",[32,120,122],{"id":121},"gotchas","Gotchas",[37,124,125,126,131],{},"These cost me time, so I wrote them into a ",[41,127,130],{"href":128,"rel":129},"https:\u002F\u002Fgithub.com\u002Fcnburnett\u002Fseles-docs",[45],"build guide"," for anyone reusing the approach:",[133,134,135,146,155,172,181],"ul",{},[136,137,138,141,142,145],"li",{},[58,139,140],{},"Environment variables don't deploy."," Cloudflare Pages builds from a clean git checkout, so a git-ignored ",[79,143,144],{},".env"," never reaches production. The analytics IDs have to be set in the Pages project's settings too, or production silently ships without analytics.",[136,147,148,154],{},[58,149,150,151,61],{},"Don't run ",[79,152,153],{},"docusaurus deploy"," It targets GitHub Pages. On a site deployed through Cloudflare it will fail, or publish an unwanted second copy.",[136,156,157,160,161,164,165,168,169,61],{},[58,158,159],{},"Breadcrumbs skip the section root."," With multiple docs plugin instances, a deep page shows ",[79,162,163],{},"Home > Conceptual Framework > ..."," rather than ",[79,166,167],{},"Home > Docs > ...",". The fix is swizzling ",[79,170,171],{},"DocBreadcrumbs",[136,173,174,177,178,61],{},[58,175,176],{},"Search only exists in production builds."," In dev mode it shows a placeholder, so test with ",[79,179,180],{},"npm run build && npm run serve",[136,182,183,186,187,190],{},[58,184,185],{},"Theme-independent navbars need explicit button colours."," My dark blue navbar stays dark in both modes, so the light\u002Fdark toggle was invisible until I forced ",[79,188,189],{},".navbar .clean-btn"," to white.",[32,192,194],{"id":193},"ai-support","AI Support",[37,196,197],{},"I used Claude Code within Visual Studio Code for assistance.",[32,199,201],{"id":200},"whats-next","What's next",[37,203,204],{},"The site's own content and code license is still a draft. It is waiting on Andrew's confirmation of a license for the documentation content, and a final decision on the code license.",{"title":206,"searchDepth":207,"depth":207,"links":208},"",2,[209,210,211,212,213],{"id":34,"depth":207,"text":35},{"id":64,"depth":207,"text":65},{"id":121,"depth":207,"text":122},{"id":193,"depth":207,"text":194},{"id":200,"depth":207,"text":201},"2026-08-21","How I built docs.seles.info, a Docusaurus site styled with the BC Government design system, and the gotchas worth sharing.","md","\u002Fblog\u002Fseles-docs-home.png",{},4,true,{"title":18,"description":215},"zy-MDLzilgEvuvPydbtSsr_dBumYBUkH9jyP2d6hZd4",[224,226],{"title":14,"path":15,"stem":16,"description":225,"children":-1},"I'm researching print on demand options for a keepsake fridge magnet design for memorials, and would love your feedback.",null,1795203372968]