oreal-solutions / motionlink-cli Goto Github PK

Provide a Block Transformer for Notion table blocks.

Currently, media assets are placed in the outDir of a TemplateRule. Hugo, however, expects all media to be in the ./static folder. Fixing this issue will allow MotionLink media links to work in Hugo powered websites.

Currently are saved by their file name. This causes an issue when two different assets have the same basename in the URL. The asset paths will will refer to same file when downloaded even though they are not supposed to.

To create

1. Open Notion page
2. Drop image with any file name in the page
3. Drop another image but with the same file name in the page

Issue

MotionLink fetches the images into the same file.

Proposed Fix

Include image id in the filename. That way even if two images have the same name, they will fetched as two different files.

The Notion API is now out of beta. Update the package to use the stable API.

When an image, for example, is fetched from Notion the name for the image file is randomly generated. A new random filename is generated for the same image every time the image is fetched, resulting in many copies of the same image in the local filesystem. This is more of a request to save an image to the same file every time it is fetched from Notion.

Add transformers to transform Notion pages to React code.

Problem

The markdown transformers do not preserve the layout of the Notion page.

Solution

Provide block transformers that preserve the layout of Notion pages. To React Block Transformers seem like a better option, but this is open for discussion.

Benefits

The most obvious benefit is that the layout of Notion pages is maintained. Another benefit is easy integration with static site generators that support React. Examples are:

1. Docusaurus
2. NextJs
3. Gatsby

In the README list all the supported and unsupported blocks by the the markdown transformers.