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

Problem with url generation when the fragment contains some symbols #3946

Closed
k3ut0i opened this issue Aug 28, 2021 · 4 comments
Closed

Problem with url generation when the fragment contains some symbols #3946

k3ut0i opened this issue Aug 28, 2021 · 4 comments
Labels
docs Documentation issue (primary issue type)

Comments

@k3ut0i
Copy link
Collaborator

k3ut0i commented Aug 28, 2021

In Language/iterating.pod6, this link L<C<^> twigil|/syntax/$CIRCUMFLEX_ACCENT#(Traps_to_avoid)_twigil_^>
was translated (in language/iterating) to this link
https://docs.raku.org/syntax/$CIRCUMFLEX_ACCENT#(Traps_to_avoid)_twigil_$CIRCUMFLEX_ACCENT
where as the appropriate section is at https://docs.raku.org/syntax/$CIRCUMFLEX_ACCENT#(Traps_to_avoid)_twigil_^

So either the index entries in each document must be translated, or the fragments in the url generation must be left untranslated.

I have found a few links that involve ^ that do not redirect to the appropriate section.

L<this page|/language/variables#The_^_twigil> in Language/5to6-perlvar.pod6
L<placeholder|/language/variables#The_^_twigil> in Language/control.pod6
L<.^|/language/operators#methodop_.^> in Language/typesystem.pod6
L<More information|/language/operators#infix_(^),_infix_⊖> in Language/setbagmix.pod6

I am not sure which symbols (other than ^) are being translated. So there might be more.

@k3ut0i k3ut0i added the docs Documentation issue (primary issue type) label Aug 28, 2021
@JJ
Copy link
Contributor

JJ commented Aug 28, 2021

That's done in Documentable. It's probably better if the issue is raised there. Thanks for providing these examples.

@k3ut0i
Copy link
Collaborator Author

k3ut0i commented Aug 28, 2021

The issue seems to have been raised here Raku/Documentable#149 .

Should I close this ?

@JJ
Copy link
Contributor

JJ commented Aug 28, 2021

The issue seems to have been raised here Raku/Documentable#149 .

Should I close this ?

If you're so kind to add the examples included here as additional info, I would appreciate it.

The fact that it's not been solved is actually more convoluted than that. We don't have a principled way of generating URLs. This PR was created with that intention, but then stalled.

So having more information that can be turned into tests will certainly help. But the solution is not easy, and will not come fast, I'm afraid.

@k3ut0i
Copy link
Collaborator Author

k3ut0i commented Aug 28, 2021

Closing this, as the issue is begin tracked here: Raku/Documentable#149

@k3ut0i k3ut0i closed this as completed Aug 28, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation issue (primary issue type)
Projects
None yet
Development

No branches or pull requests

2 participants