Skip to content

Update image_video_overlay.rst #665

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update image_video_overlay.rst #665

wants to merge 1 commit into from

Conversation

konanast
Copy link

Improve documentation for image_video_overlay

@@ -44,6 +44,6 @@ Attributes
=========== ======================== ===
Attribute Default Value Doc
=========== ======================== ===
url "" An http url to the footage or a relative path to a local file (image/video). Note that absolute local paths are not supported.
url "" An http url to the footage or a relative path to a local file (image/video, e.g. ‘image.png’ or ‘files/working_dir/image.png’ in JupyterLab). Note that absolute local paths are not supported.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is different in JupyterLab, the files/ prefix?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, otherwise it does not work.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should make it clearer, like: "Note that in JupyterLab the path must be prefixed with files/, e.g. files/image.png".

Copy link
Author

@konanast konanast Jul 30, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also important is the current working folder name so you have to add "files/my_working_dir/", this is a bit strange and it is not mentioned anywhere.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In Jupyter Notebook the path is relative to the Notebook. In JupyterLab it's relative to the server.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also important is the current working folder name so you have to add "files/my_working_dir/", this is a bit strange and it is not mentioned anywhere.

Yes but this is not specific to JupyterLab, so we should make it consistent with the notebook.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In Jupyter Notebook the path is relative to the Notebook. In JupyterLab it's relative to the server.

Thanks, then this should also be mentioned.

@martinRenou
Copy link
Member

The CI error is very odd. Definitely not related to the changes here though.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants