The Data Shepherd

Tag: docusaurus

All posts

A Speaker's Journey dax dbeaver docusaurus Fabric Capacity Fabric Workspace github Hallway Track hugo Microsoft Fabric netsuite Power BI Presenting ssis

  • Upgrading my blog to Docusaurus 3.0

    Upgrading my blog to Docusaurus 3.0

    Upgrading my blog to Docusaurus 3.0 was mostly a foundation change, but it surfaced real gotchas. The MDX v3 checker failed on two posts because unescaped “{” characters in connection strings, so I moved them into code blocks. I learned more about npm, semantic versioning, and package-lock realities, plus updated Prism renderer config after themes moved and defaults changed again.

  • Syntax Highlighting in Docusaurus

    Syntax Highlighting in Docusaurus

    Docusaurus uses Prism for syntax highlighting, and that’s a big win when you write about niche languages like DAX and Power Query (M). In this post I walk through adding extra Prism languages in docusaurus.config.js, restarting the site, and using the right code-fence aliases. I also show how to swap Prism themes for light/dark mode to match your site’s look

  • Using Environment Variables in Docusaurus

    Using Environment Variables in Docusaurus

    Environment variables let you keep configuration values outside your source files, so settings can differ between test and production without touching code. During the build, each reference is replaced with the real value. This post covers how to set them up in Docusaurus and why keeping configuration in one place pays off.

  • Adding Comments to Docusaurus

    Adding Comments to Docusaurus

    Docusaurus can’t read Node environment variables directly in components, so I use dotenv to load a .env file into process.env, then pass values through customFields in docusaurus.config.js. I show installing dotenv, testing with console.log, and wiring variables into Giscus comments. For dev vs prod, NODE_ENV selects different .env paths—keeping secrets and config out of source for builds and deployments.

  • Adding Icons to Docusaurus

    Adding Icons to Docusaurus

    Your docs site looks solid… until you notice every tab shows the same generic icon. In this post, I walk through giving Docusaurus a real identity by adding a favicon and custom icons—so your blog looks polished in browser tabs, bookmarks, and mobile home screens. It’s a quick win with a surprisingly big impact, and it’s easier than you think.