One year ago, we switched from our homegrown Sliverstripe blog solution to Docusaurus. Time to look back and see if the move was worth it.
9 posts tagged with "docusaurus"
View All TagsHandling invalid url parameters with nginx
While improving the page indexing of our blog, I realized that Google still had old urls stored that aren't valid anymore. The challenge in this case: The urls in question could only be identified via specific get parameters.
Customizing Docusaurus components
Tech changes, quite rapidly. Coming across a blog post that covers outdated information happens frequently to me. Years ago, I came across a blog that displayed a "This blog post might be outdated banner" and I liked that approach.
Linting nginx config in our Docusaurus CI setup
We've covered the basics of our Docusaurus CI setup already in another blog post. In this blog post, we'll show you how to the build pipeline to lint the nginx configuration used in our Docusaurus setup.
Our Docusaurus CI setup
It's been a few months sine we migrated from Silverstripe to Docusaurus for our blog. Quite a few blog posts have been published since then via the CI pipeline we've set up. This blog post covers how we do things.
nginx + Docker: Redirect vs. Location
Whilst preparing and testing our Docusarus instance, I realized that the RSS feed URL used by our old blog system did not work anymore because Docusaurus generates the content in a different way.
Migration to Docusaurus
In our attempt to migrate from our Silverstripe powered blog to Docusaurus, we did not want to lose our old blog posts and thus needed to migrate them somehow. A manual migration was not an option for the roughly 320 blog posts we have written in the last 17 years.
Why Docusaurus
When we introduced our chapters as part of our circle based structure, we had the idea to publicly announce what our chapters are doing, what technologies they are using and how they are working. When it came to the tooling decision, Docusaurus came up pretty quickly as it comes with multiple features that fit our technology stack out-of-the-box:
Hello Docusaurus!
Since 2013 we have been using Silverstripe and the Silverstripe blog module as our blogging engine. After all those years, it is time to revisit and improve our toolchain as our requirements have changed over the years.
We decided to settle with Docusaurus for now. We'll share the "why" in one of our next blog posts, so stay tuned ;)