Willemstad X (Extended)
Named after the capital of Curaçao (which is known for its colourful houses), the extended Willemstad is a fully-fledged theme and extension of the original Willemstad snippet/theme variant proof-of-concept for Chris Grieser (pseudometa)'s Obsidian theme, Shimmering Focus. You can sponsor Chris here!
NOTE! Willemstad X is not supported for the legacy editor (CodeMirror 5), or for mobile. While mobile support might be coming in the longer future, you are advised only to use Willemstad X on desktop, and in the current default editor.
To use:
For the most current version, use the Community Theme store in Obsidian. (preferred/highly recommended method!)
Alternatively, download the release, and drop obsidian.css into your .obsidian\themes folder in the vault you wish to have the theme in.
Should I use this or Willemstad for Shimmering Focus?
It's up to you! I intend to maintain Willemstad for SF without too much effort (read: not minimally, but almost minimally), since I don't think there are too many more features I'd like to add, or can add without conflicting with Shimmering Focus' base options. I don't want to conflict too many changes with Shimmering Focus as well! But if you are a power user and use most of Shimmering Focus's stuff, I'd suggest you stay with Shimmering Focus. Chris is way better/faster at doing CSS stuff than I am, too!
Willemstad for SF got featured twice in Eleanor's roundup (1, 2) (yes, the Roundup), versus once for Willemstad X (1) so if that's the deciding factor, then go for that!
Why is Inter embedded into Willemstad X, isn't that included in Obsidian proper?
Yes, it is. Inter is included in Obsidian proper. However, most people will download Inter onto their computers, and Obsidian will use the font with the name that is present in your computer. Moreover, most people (including myself) download/-s/-ed Inter from Google Fonts, which is probably the most outdated version you can get of the font. (No proper italics, need I say more?!) By embedding Inter, alongside the other fonts, allows me to quality control and ensure the quality of your experience.
I'd like to change something or propose something. What's the easiest way to do so?
If it's something you reckon people would need/want as well, the easiest way to request changes is to use the Issues tab here on GitHub. If you would like to change something that you can reckon you rather do it yourself, the best way would be to use a snippet. I recommend the snippets by Mara Li, and the theme overlay Absolve by mulfok.
Alternatively, and if you are familiar with Sass/SCSS, you can compile Willemstad yourself via the files in the build folder, and fork the repo and edit the relevant files you want to. To understand what each specific SCSS file consists of, consult here.
Supported Community Plugins
Like Primary, Willemstad aims to get the core features right before delving into plugins. However, I totally agree that some plugins are almost essential to the Obsidian experience, and they were my daily drivers too, so they did get a bit of work done to it.
- Style Settings
- Calendar
- Sliding Panes
- Admonitions
- Dataview
- Breadcrumbs
- Get Info
- CookLang Plugin
- Emoji Toolbar
- Maps of Content
- cMenu
- Footnote & Citation Indicator
- Longform
- Settings Search
- LanguageTool Integration
Things to complete + WIP
- Colour Palettes
- Fixes for mobile (albeit not offering official support yet)
- ... and a bunch of other stuff in my Obsidian file that I didn't write it here. However, most of what I have in mind can be found here.
Just another word
Having a theme out within 2.5 weeks of trying to do something with CSS (from the time I left Sanctum, which I honestly think jdaniel did an amazing job with) is probably something I didn't think was possible even a week before this was published.
That being said, Chris (of Shimmering Focus fame), Cecilia (of Primary fame), and SlRvB (of ITS Theme fame) prophesied I would end up with a theme and had more faith in me than I did. I owe them a word of thanks. Thanks y'all, and I hope I didn't let anyone of you down.
Attribution
As is with most theme codes in Obsidian, many pieces/snippets of code have been cobbled together from whatever the hive mind has created. It is therefore not possible to accurately and fully attribute everyone's efforts, which might have come into and been adopted by this theme. That being said, there are multiple pieces of instrumental code that I can attribute to, which I do so here:
- Multi-Colour Highlighting, adapted from Zhang Chenyu (@Atlas)'s and Chris Grieser (@pseudometa)'s code
- Varying/Readable Underlines, co-written by myself and Cecilia May
- Dataview Word Wraps, from SlRvB
- No-Shadow Sliding Panes, with input from Damian Korcz
- No-Shadow Admonitions, inspired by Leah's lamentations to Jeremy Valentine
- Longform plugin and
writingcssclass support, adapted from Chris Grieser (@pseudometa)'s code, and also with credits to Kevin Barrett (@kevboh)'s styling - and many other snippets that were written by Chris Grieser
- Nord theme colour palette, adapted from the original documentation written by Sven Greb
- Minimal Cards and Image Grids, from Stephan Ango
License
Theme Documentation (currently a work in progress)
Available here.