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

Don't use frames #36

Open
olauq opened this issue Mar 26, 2018 · 3 comments
Open

Don't use frames #36

olauq opened this issue Mar 26, 2018 · 3 comments

Comments

@olauq
Copy link

olauq commented Mar 26, 2018

Hi.

It would be good to remove the use of frames from the pages.

Reasons:

  1. I've been using this reference for years (thank you!), but only today did I come via the OpenGL registry (and thus loaded the page via the frames), the usual way is by finding the page I want using google for example. So, this is the first time ever I've seen the index to the left of the page content... I've been quietly annoyed at this lack of an index, but now I understand how this came to be.

  2. Also, frames are deprecated in the web standard, to quote Mozzila:

This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Avoid using it and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

@oddhack
Copy link
Contributor

oddhack commented Mar 28, 2018

If you would like to propose an alternate solution using iframes or some similar mechanism, that would be cool. I don't have much time available for GL refpage stuff these days, TBH, and the couple of times I tried to whip something up quickly, I ran into weird rendering errors demonstrating I don't know a lot about iframes :-)

@olauq
Copy link
Author

olauq commented Mar 28, 2018

I can give fixing it a go. I don't have any time either, but I had a quick look and happily you seem to be usign php which I have some familiarity with, and it looks fairly simple. Afaik, the answer is not iframes anyway as they are more intended for including external content. My thinking is to just pipe everything through the index.php and send the page to display along as an argument and include the index and the other parts using normal php includes or whatever they are called. If we were to move the current xhtml we can possibly fix the links everyone has (and google has in its index) so they redirects to the main page. That'd be a nice bonus. Not going to promise any ETA :)

@oddhack
Copy link
Contributor

oddhack commented Mar 28, 2018

Thanks. Eventually I hope to migrate the ref pages to asciidoctor and HTML5 output; for now, we're stuck with the XHTML outputs.

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

2 participants