Plugin themes, github themes, blank theme - I'm confused!

micro.blog’s theming confuses me: I have changed via the “plugin themes” to the Hyde theme. To customise the look a bit I added my own theme just for a config.json. So far so good.

Now I think of trying a “github theme” i.e. a theme for which there is a GitHub URL. Do I understand it correctly that I need for this a “blank theme” which I then overload with the “github theme”?

But how, in the first place, do I get rid of the Hyde theme? (No Remove button or similar in sight…)

This was true once, but not anymore.

You can uninstall the Hyde theme plug-in after you’ve installed the theme available on GitHub. And I agree with you that themes and plug-ins are a bit confusing. I think the UI and naming of things need to be tweaked some by @manton.

Here’s a quick guide. I assume your current enabled theme is Hyde.

  1. Navigate to Design > Edit Custom Themes.
  2. The next step is confusing, so read it closely.
  3. Hit the New Plug-in button. (Yeah, I know, weird.)
  4. Give the GitHub theme a Title and provide the Clone URL. Also, make sure you choose the correct Site in the dropdown if you have more than one blog hosted on Micro.blog.
  5. Tap the Add plug-in button.
  6. Now, navigate to Plug-ins and hit the Uninstall button next to the Hyde theme.
  7. There are no more steps; your GitHub theme should be installed and enabled now.
2 Likes

Great overview, thanks @sod. Any suggestion for how we can improve this? The transition from the built-in themes to plug-ins hasn’t been totally smooth, admittedly, although I think the foundation is much better if we can get the UI right.

Wait, why not hit the New Theme button and then enter the Github theme in the Clone URL field? That’s what I did for my custom theme.

If you’re the author of the theme hosted on GitHub, your approach also works okay.

But if you’re installing a theme hosted by someone else on GitHub, you will run into trouble if you want to make customizations as @halloleo did to config.json. Should the original theme author release a new version, you will have to manually merge that with your changes.

If you install the GitHub-hosted theme like a plug-in instead, you can have all your modifications in a separate custom theme. That will be much easier to maintain. Migrating to another theme in the future (and keeping your customizations) will also be more manageable.

1 Like

This is just my gut speaking. :blush: But I think that even though themes and plug-ins are technically the same, they are pretty different from a user’s perspective. Especially if they have experience with other blogging platforms.

So if it were up to me, I would hide the implementation details from the user and just let themes be themes and plug-ins be plug-ins. Keeping everything that has to do with themes bundled together, like browsing available themes, installing, and making overrides. And the same for plug-ins.

1 Like

100% agree with Sven.

Interesting point! Super good to know!

And of course: Thanks heaps for the detailed info to begin with! :slight_smile:

1 Like