Skip to content
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

Add config for editor return label #1232

Closed
wants to merge 1 commit into from
Closed

Conversation

owi92
Copy link
Member

@owi92 owi92 commented Aug 28, 2024

This adds a config option to set a return label for the editor.
For context:
The editor can be configured to show a "return-to-origin" button that says "Return to {...}"/"Zurück zu {...}".
This is intended to use the name of the system that the editor was opened from, for example Opencast or Tobira.

@oas777 wants this to say "Zurück zum Video", which is slightly problematic for a few reasons:

  • We can't configure this to say "Zurück zum {...}". That would need to be adjusted in editor itself.
  • While it is possible to pass "dem Video", so it says "Zurück zu dem Video" (which is what this PR will allow), we need to consider multiple languages. With this PR you can configure english and german labels, but editor will get just that: Either the english or german version. So when we pass "zum Video" and then change the language in editor, the button will say "Back to dem Video", which is bad.

I would strongly suggest to stick with what is possible now: passing the system name.
Otherwise you should open an issue in https://github.com/opencast/opencast-editor/ (I can also do that if you want me to).

Related to https://gitlab.elan-ev.de/opencast/eth/tobira/-/issues/49

@owi92 owi92 added needs:decision Needs a decision of some kind (discussion thread) area:opencast The Opencast side changelog:user User facing changes labels Aug 28, 2024
@github-actions github-actions bot temporarily deployed to test-deployment-pr1232 August 28, 2024 13:21 Destroyed
@oas777
Copy link
Collaborator

oas777 commented Aug 29, 2024

I would strongly suggest to stick with what is possible now: passing the system name.

OK. I'm not worried about my "zum Video", but I'm not sure institutions are automatically using the "system name" towards their customers, so "Opencast" or "Tobira" are not known by every user.

@owi92
Copy link
Member Author

owi92 commented Aug 29, 2024

It doesn't have to be the "system name" (which is configurable, at least in Tobira), it's just how this is intended to be used.

If institutions want to use another name, the challenge for them is finding some text that fits the editor template of "Back to ..." and ideally works in all languages supported by the editor.

So far we (on our test deployment) have used the configured site title in Tobira, but I'm not against providing more flexibility (which this PR would do). Though as mentioned this is somewhat constrained by the template that editor provides.

Copy link

github-actions bot commented Sep 9, 2024

This pull request has conflicts ☹
Please resolve those so we can review the pull request.
Thanks.

@github-actions github-actions bot added the status:conflicts This PR has conflicts that need to be resolved label Sep 9, 2024
@owi92
Copy link
Member Author

owi92 commented Sep 13, 2024

@dagraf we didn't have time to talk about this in our latest meeting. I just wanted to get your opinion on this (which may very well be that you don't have any opinion on this).

My stance remains that while having this configurable doesn't really hurt, it may lead to awkward situations as I tried to explain in my comments above. So to prevent that, we might just not want to allow it in the first place.

I'm also interested in @LukasKalbertodt's opinion since he would ultimately need to decide if we merge this or not.

@oas777
Copy link
Collaborator

oas777 commented Sep 13, 2024

Thanks, @owi92. An additional question for my understanding: If we were to stick to "Return"/"Zurück", wouldn't this allow everyone to add anything? Not sure where to put the space though.

  • " to Tobira" / " zu Tobira"
  • " to the video portal" / " ins Videoportal"
  • " to the video" / " zum Video"

@owi92
Copy link
Member Author

owi92 commented Sep 16, 2024

@oas777 the "Return to" / "Zurück zu" part is set in stone by editor, we can't change that anyhow in Tobira.

Right now (without this PR), Tobira will always pass the configured site title (i.e. "Tobira Test Deployment" on our test deployment, "Videoportal Universität Bern (Tobira)" for Bern or "Videoportal" for the ETH).
So you could theoretically configure it to say "Return to Cookie Mountain" if you wanted, but then your Tobira instance would be called "Cookie Mountain".

This pull request would add an additional configuration option with which you could pass a label to editor that won't be used anywhere else, allowing you to configure something like "Video", so editor would say "Return to Video" / "Zurück zu Video" without changing Tobira's page title.

But this comes with the constraints I layed out in #1232 (comment), particularly this part:

While it is possible to pass "dem Video", so it says "Zurück zu dem Video" (which is what this PR will allow), we need to consider multiple languages. With this PR you can configure english and german labels, but editor will get just that: Either the english or german version. So when we pass "zum Video" and then change the language in editor, the button will say "Back to dem Video", which is bad.

@github-actions github-actions bot removed the status:conflicts This PR has conflicts that need to be resolved label Sep 16, 2024
@owi92 owi92 force-pushed the editor-config branch 2 times, most recently from 315906b to a348e83 Compare September 16, 2024 12:51
@github-actions github-actions bot temporarily deployed to test-deployment-pr1232 September 16, 2024 12:57 Destroyed
@github-actions github-actions bot temporarily deployed to test-deployment-pr1232 September 16, 2024 13:24 Destroyed
@github-actions github-actions bot temporarily deployed to test-deployment-pr1232 September 16, 2024 13:32 Destroyed
@oas777
Copy link
Collaborator

oas777 commented Sep 16, 2024

@oas777 the "Return to" / "Zurück zu" part is set in stone by editor, we can't change that anyhow in Tobira.

I feel like you explained this before so I guess I'm currently too dumb to add anything valuable to this. Over and out.

@owi92
Copy link
Member Author

owi92 commented Sep 16, 2024

Well it could also be that it is me who is too dumb to explain this :neckbeard:
And I guess I haven't really answered your question.

So coming back to your examples:

" to Tobira" / " zu Tobira" (a)
" to the video portal" / " ins Videoportal" (b)
" to the video" / " zum Video" (c)

(a) is currently possible.
(b) and (c) would need this PR, with the german versions needing to be rewritten as "dem Videoportal" and "dem Video". (Remember, "Return to " / "Zurück zu " is dictated by editor, including the space).

Maybe it's best if we just put aside 5 minutes of our next meeting to briefly talk about this.

@oas777
Copy link
Collaborator

oas777 commented Sep 16, 2024

Maybe it's best if we just put aside 5 minutes of our next meeting to briefly talk about this.

Yeah, I wish we could talk to the guy who baked "Return to " / "Zurück zu " into the Editor ...

@LukasKalbertodt
Copy link
Member

Sorry for the delay in commenting on this thread.

I would not add a configuration for this in Tobira, I think using the configured site title is fine. In my opinion, we should should change the editor to put quotes around the passed label (or even a border or something like that). That would clearly mark it as "name" or "named entity" and not as part of the sentence starting with "back to".

  • Back to "Video portal"
  • Zurück zu "Videoportal Universität Bern (Tobira)"

We can still run into the problem of Tobira passing the German label to the editor, while the editor is in Englisch. But for one, that's rare (both apps use the same logic to decide the language, users would have to manually change only one). And further, due to the separation given by the quotes it's not that bad.

@oas777
Copy link
Collaborator

oas777 commented Sep 19, 2024

I'm not so happy about these expressions and you probably aren't either, but let's table this here. Or should we talk about German vs. quotation marks?

@LukasKalbertodt
Copy link
Member

should we talk about German vs. quotation marks?

I was afraid you'd mention that 😬 I think it's not as bad with names of entities (which is the case here) than with quotes of natural language. But either way, this can also be solved differently in the editor (e.g. background, border, ...).

So do we all agree to close this PR and instead open an issue at the editor repository?

@oas777
Copy link
Collaborator

oas777 commented Oct 1, 2024

+1

@owi92
Copy link
Member Author

owi92 commented Oct 2, 2024

I opened an editor issue for Lukas' suggestion: opencast/opencast-editor#1466.

@owi92 owi92 closed this Oct 2, 2024
@owi92 owi92 deleted the editor-config branch October 2, 2024 09:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:opencast The Opencast side changelog:user User facing changes needs:decision Needs a decision of some kind (discussion thread)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants