Question 1

How do I add a custom domain to my SkunkHTML blog?

Accepted Answer

Edit the siteBaseUrl in SkunkUtils.fs to your custom domain, then configure DNS settings to point to GitHub Pages. The README provides examples for different hosting scenarios like project pages or custom domains.

Question 2

Can I use SkunkHTML for a documentation site instead of a blog?

Accepted Answer

Yes, by adding non-dated Markdown files to the markdown-blog folder, but it's optimized for blog-style content with dated posts. For complex documentation, a more feature-rich SSG might be better.

Question 3

SkunkHTML vs Jekyll for GitHub Pages: which should I choose?

Accepted Answer

SkunkHTML is simpler with zero local setup, ideal for minimal blogs. Jekyll offers more themes and plugins but requires Ruby and configuration. Choose SkunkHTML for ease, Jekyll for flexibility.

Question 4

How to change the theme in SkunkHTML?

Accepted Answer

Copy the contents of a theme file from the themes/ directory into css/tweaks.css. The README lists themes like Ocean and Terminal, which automatically respect system color preferences.

Question 5

Does SkunkHTML support image optimization or lazy loading?

Accepted Answer

No, it focuses on Markdown processing without built-in image optimization. You need to manually optimize images or use external services, as noted by the lack of such features in the README.

Question 6

How can I add Google Analytics to my SkunkHTML site?

Accepted Answer

Edit the head.html fragment in the html/ folder to include the Analytics script. This allows custom JavaScript injections without modifying the core F# code, as mentioned in the customization section.

Question 7

Is SkunkHTML good for large blogs with hundreds of posts?

Accepted Answer

It works, but performance might slow as posts increase since the build regenerates all HTML on each push. For scalability, consider SSGs with incremental builds.

SkunkHTML

What is SkunkHTML?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions