Docusaurus
Things, I learned how to do with Docusaurus.
-
Image Handling in Docusaurus
For the Playground documentation, I needed to have more control over the sizes of images. It was a bit tricky because it required a React approach rather than a Markdown approch. Markdown renders the image in the orignal size. The image is located in the _assets folder relative to the *.md file. Display an Image with a reduced width The code to display the same image with width=400. The image is displayed via a React component (<Image/>) In short: In detail: The first line imports a special Image component from…
-
Starting with Docusaurus
One of my tasks today was to migrate the Blueprint 101 crash course from the Blueprint Gallery repo to the Playground documentation site. The difference is that the Blueprint Gallery uses GitHub Markdown pages while the Playground documentation used Docusaurus library. The first hurdle to overcome was to create a local copy of the existing Documentation. The instructions are clear: It just doesn’t say how often you have to run those command to get a clean built of the local documentation pages. I ran into all kind of errors, starting…