Is it possible to include images from Media-Sets in Custom Documentation?

Currently it looks like it’s only possible to include raw files and images in dataset files in Custom Documentation.

But is it possible somehow, or maybe in the future, to use images from Media-Sets please? It appears you can extract Media References via code, but that seems long winded, and it’s not clear what markdown might then be needed to include those.

Hello! Referencing media items in code repositories markdown files is currently supported. The required format is:

![An example media item](media_set_rid/media_item_rid)

1 Like

Hello,

Thanks, that looks very near. Is it dependent on your installation or do does some additional access need to be enabled somewhere? As that doesn’t seem to work for me, and results in errors. My code in the documentation repo:

![screenshot](ri.mio.main.media-set.<snip>/ri.mio.main.media-item.<snip>)

That will get you the fastest and most reliable response.

If you have feature requests, or want to organise training for teams or other non-urgent topics, please get in touch by e-mailing....

Which then renders as:

And the checks now fail with the following error (this is the only change I have made in the repo since the last checks that succeeded):

Validating docs bundles from repository:
<snip repo name>
All docs bundles are error-free!

On master branch. Attempting to publish bundles...

Encountered error (90701eb0-0a6a-47d2-ae66-32cd026a69b7):
Default:Internal


Encountered HTTP error.
 HTTP Status code: 500
 Reason: Internal Server Error
 Response: b'{"errorCode":"INTERNAL","errorName":"Default:Internal","errorInstanceId":"90701eb0-0a6a-47d2-ae66-32cd026a69b7","parameters":{}}'
Traceback (most recent call last):
  File "/app/ri.jemma.main.job.0000000d-c475-2617-a7b7-2227a53fe3c6-b06c714e-de6d-45a1-b5f6-549ab0c55623/repo/publish-rosetta.py", line 322, in publish
    put_request(publish_url, payload, get_token())
  File "/app/ri.jemma.main.job.0000000d-c475-2617-a7b7-2227a53fe3c6-b06c714e-de6d-45a1-b5f6-549ab0c55623/repo/publish-rosetta.py", line 101, in put_request
    response = perform_request(req, ssl_ctx)
  File "/app/ri.jemma.main.job.0000000d-c475-2617-a7b7-2227a53fe3c6-b06c714e-de6d-45a1-b5f6-549ab0c55623/repo/publish-rosetta.py", line 81, in perform_request
    raise e
  File "/app/ri.jemma.main.job.0000000d-c475-2617-a7b7-2227a53fe3c6-b06c714e-de6d-45a1-b5f6-549ab0c55623/repo/publish-rosetta.py", line 61, in perform_request
    response = urlopen(req, context=ssl_ctx)
  File "/usr/lib/python3.10/urllib/request.py", line 216, in urlopen
    return opener.open(url, data, timeout)
  File "/usr/lib/python3.10/urllib/request.py", line 525, in open
    response = meth(req, response)
  File "/usr/lib/python3.10/urllib/request.py", line 634, in http_response
    response = self.parent.error(
  File "/usr/lib/python3.10/urllib/request.py", line 563, in error
    return self._call_chain(*args)
  File "/usr/lib/python3.10/urllib/request.py", line 496, in _call_chain
    result = func(*args)
  File "/usr/lib/python3.10/urllib/request.py", line 643, in http_error_default
    raise HTTPError(req.full_url, code, msg, hdrs, fp)
urllib.error.HTTPError: HTTP Error 500: Internal Server Error

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/app/ri.jemma.main.job.0000000d-c475-2617-a7b7-2227a53fe3c6-b06c714e-de6d-45a1-b5f6-549ab0c55623/repo/publish-rosetta.py", line 383, in <module>
    publish(allowed_words, docs_bundles)
  File "/app/ri.jemma.main.job.0000000d-c475-2617-a7b7-2227a53fe3c6-b06c714e-de6d-45a1-b5f6-549ab0c55623/repo/publish-rosetta.py", line 324, in publish
    raise RuntimeError("Failed to publish documentation.", e)
RuntimeError: ('Failed to publish documentation.', <HTTPError 500: 'Internal Server Error'>)

Looks like there’s something wrong with the permissions? Both the media set and documentation repo are in the same project and the same folder. Is there something I need to enable?

Thanks.