Docusaurus

Over the past few years I have tried many platforms for running my website, ranging from simple HTML pages to content management systems like Wordpress, and finally using static site generators, like Pelican, or Docusaurus.

Simple HTML pages provide the quickest and easiest path to get content on to the internet, until you want to do more than basic styling.

Applications like Wordpress provide a nice easy interface, and reduce the complexity to create a professional looking website. There is a trade off, generating content is much easier, there is more work required to manage the platform. As well, since Wordpress is a web application, there are security considerations that must be made.

Finally, a traditional static site generator like Pelican, takes content and uses it to build a series of web pages. Pelican uses Markdown or reStructuredText to create a website using templates. A modern static site generator like Docusaurus uses Markdown, but then creates the website using newer technologies like ReactJs. If you are inclined, React can be used to create web pages in Docusaurus.

Since I first looked a Docusaurus in December 2021, a few improvements have been made to the platform.