Our great sponsors
-
dodo-ssg
Discontinued A simple Static Site Generator CLI [Moved to: https://github.com/menghif/static-dodo]
-
SurveyJS
Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App. With SurveyJS form UI libraries, you can build and style forms in a fully-integrated drag & drop form builder, render them in your JS app, and store form submission data in any backend, inc. PHP, ASP.NET Core, and Node.js.
-
markdown-it
Markdown parser, done right. 100% CommonMark support, extensions, syntax plugins & high speed
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
Of course as a tool used for documentation, docusaurus' own documentation is top notch. I was able to follow the instructions and set up a demo Docusaurus website and deploy it with Github Pages.
I chose to take two features from Docusaurus and implement them into my own dodo-SSG tool:
The second is syntax highlighting for code blocks using highlight.js. This was very nice to learn and to play with. The current implementation has a theme already added by default but I have filed an issue to add the ability to customize the theme (PR link).
The first is full markdown support. I used markdown-it to do this and it greatly simplified my code while providing the complete markdown support that I needed (PR link).
This week I looked into Docusaurus: a great SSG tool used by many organizations to easily build a full static website for documentation and more.