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

Footnotes don't work on the website #435

Open
michaelpj opened this issue Jan 17, 2023 · 4 comments
Open

Footnotes don't work on the website #435

michaelpj opened this issue Jan 17, 2023 · 4 comments

Comments

@michaelpj
Copy link
Contributor

They do work in Github markdown, so this is confusing for submitters. Certainly my CIPs have had lots of footnotes that are all broken :(

I think this should just mean enabling the appropriate markdown extension in whatever produces the site.

@rphair
Copy link
Collaborator

rphair commented Jan 17, 2023

Another thing that glaringly doesn't work on the derived web site: cross-CIP links (#109) which really hurts. Still we are currently bound by #436 (comment) before we can talk about where & when this will be fixed (cc @KtorZ).

@KtorZ
Copy link
Member

KtorZ commented Jan 17, 2023

I think this should just mean enabling the appropriate markdown extension in whatever produces the site.

Yes. @michaelpj be aware that no one likes the current website rendering. It's buggy and has poor rendering capabilities. This is on the TODO list for a while. This will likely be tackled as part of a common effort with developer portal (which also display CIPs in a rendered version). We may very likely just piggyback on their solution.

Nothing is complicated here, it's just that no one has a couple of days to spend on those problems at this stage. We may start by formulating an update plan clearly maybe and call for help.

@michaelpj
Copy link
Contributor Author

Personally, even if the CIPs are going to be incorporated elsewhere, a simple static site that just contained them and could be built and published in the repository CI seems nice to me. But you know what you're doing and I'm sure you'll come up with something good :)

@rphair
Copy link
Collaborator

rphair commented Jan 22, 2023

last cross-reference was from a user cited example of footnotes not working: #428 (comment)

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

No branches or pull requests

3 participants