create model directory

[kfarr]

We have close to 100 3D models in 3DStreet and would like to provide a directory with a "details page" for each of these models. We would like to create a unique doc page for each model and use built-in features such as category page cards to provide a browsing interface.

We have a work in progress link to a Google Sheet with info for all of the models, eventually to include links to preview images, glb files, and other metadata.

Ideally it would just be one mdx file for each model where the "front matter" is sourced from the sheet (one mdx file for each row in the sheet), and a consistent markdown template is applied to each using template variables pulling from varying frontmatter.

Similar projects, but not exact match:

• CLI post generator from a template: https://github.com/moojing/docusaurus-post-generator
• Fetching remote data for content: https://github.com/rdilweb/docusaurus-plugin-remote-content
• Unrelated to docusaurus but similar concept: https://github.com/kometenstaub/csv-to-md

[kfarr]

Alternate approach after discussion with @homotechsual

• Have a separate YAML file for each model (the yaml could be named the same as the glb but with yaml extension)
• The YAML file can be defined through a JSON schema
• Then to parse each YAML to build a directory page as well as a "landing page" for each item

Example from docusaurus community page (WIP):

• user facing directory: https://docusaurus.community/plugindirectory
• example json schema: https://docusaurus.community/schema/plugin/1.0.2.json
• example YAML file for a plugin: https://github.com/homotechsual/docusaurus.community/blob/main/data/plugins/docusaurus.google-gtag.yaml

Watch this repo for updates: https://github.com/homotechsual/docusaurus.community

[kfarr]

2 primary pages for design and implementation:

• model directory (1 page that lists all models) based on https://docusaurus.community/plugindirectory
• model details page (1 page for each model, follows a template) TBD design