{"id":27940598,"url":"https://github.com/khronosgroup/opengl-refpages","last_synced_at":"2025-05-07T10:18:44.811Z","repository":{"id":16584926,"uuid":"79708442","full_name":"KhronosGroup/OpenGL-Refpages","owner":"KhronosGroup","description":"OpenGL and OpenGL ES reference page sources, and generated HTML used as backing store for khronos.org","archived":false,"fork":false,"pushed_at":"2024-11-21T01:24:31.000Z","size":10122,"stargazers_count":459,"open_issues_count":47,"forks_count":138,"subscribers_count":35,"default_branch":"main","last_synced_at":"2025-05-07T10:18:35.967Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KhronosGroup.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSES/LicenseRef-FreeB.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-22T09:42:02.000Z","updated_at":"2025-04-30T19:03:08.000Z","dependencies_parsed_at":"2024-07-13T04:42:01.665Z","dependency_job_id":"fa635e45-7eb6-4a07-a5f5-a03fc83e8212","html_url":"https://github.com/KhronosGroup/OpenGL-Refpages","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FOpenGL-Refpages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FOpenGL-Refpages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FOpenGL-Refpages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhronosGroup%2FOpenGL-Refpages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KhronosGroup","download_url":"https://codeload.github.com/KhronosGroup/OpenGL-Refpages/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252856570,"owners_count":21814858,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T10:18:43.926Z","updated_at":"2025-05-07T10:18:44.797Z","avatar_url":"https://github.com/KhronosGroup.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"= OpenGL-Refpages\n\nOpenGL^R^ and OpenGL ES reference page sources, and generated HTML used\nas backing store for khronos.org .\n\n== Directory Structure\n\nThere are separate ref page sets for each of the following apis:\n\n* +es1.1+ - OpenGL ES 1.1 (fixed function)\n* +es2.0+ - OpenGL ES 2.0\n* +es3.0+ - OpenGL ES 3.0\n* +es3.1+ - OpenGL ES 3.1\n* +es3+ - OpenGL ES 3.x (will always be the latest ES, currently 3.2)\n* +gl2.1+ - OpenGL 2.1 (including fixed functionality)\n* +gl4+ - OpenGL 4.x (will always be the latest GL, currently 4.5)\n\n== Building\n\nThe ref pages rely on the Docbook 4 and 5 toolchains, DTDs, XSL, etc.\nTools you'll need to build include:\n\n* xsltproc (Debian 'xsltproc' package, might also be 'libxslt').\n* Docbook stylesheets (Debian 'docbook-xsl' and 'docbook-xsl-ns' packages,\n  might also be 'docbook-style-xsl').\n** If your XML catalog does not resolve the stylesheet URIs in the man\n   page sources to a local reference to the installed stylesheets,\n   processing will be very, very slow. You can find out if this is\n   happening by invoking one of the xsltproc commands in the build with\n   the '--nonet' argument.\n* MathML 2.0 DTD (Debian 'w3-dtd-mathml' package)\n* Docboook MathML Module 1.1 (Debian 'docbook-mathml' package, or\n  install http://www.docbook.org/xml/mathml/1.1CR1/dbmathml.dtd into\n  your local XML catalog).\n* GNU Make.\n\nIf you're using Ubuntu, or the Windows 10 Ubuntu subsystem, the required\npackage names are probably basically the same as Debian.\n\nOn MacOSx, you can install 'docbook' and 'docbook-xls' from homebrew. In order to view equations correctly, you can copy the Docbook MathML module into the subdirectories for the OpenGL versions. xsltproc should be on your system, but you may need to install 'xcode-tools'.\n\nIt's possible to build the ref pages on Cygwin, but we\ndon't have current package names or instructions for those environments.\nIf you do, please submit a pull request adding details to this README.\n\n== Ref Pages in Subversion are Deprecated\n\nThe reference pages were formerly maintained in Khronos Subversion. The\nSubversion copies will not be removed, but are no longer being\nmaintained or exposed via the opengl.org and khronos.org websites.\n\n== Future Plans\n\nWe're interested in migrating from Docbook to asciidoc, but if and only\nif we can find a robust way to automatically convert Docbook \u003crefentry\u003e\ndocuments into asciidoc, including handling XIncludes, imbedded MathML\ninto LaTeX math, etc. We've tried several XSLT scripts and other\nconversion tools without success.\n\nWe'll accept reasonable pull requests to improve the current ref pages,\nbut aren't going to put a lot of effort into them ourselves.\n\n== Licenses\n\nFor historical reasons, the ref pages are under a mix of open source\nlicenses from Khronos, SGI, 3Dlabs, and others. We are unable to change\nmany of those licenses, because the original authors are no longer in\nbusiness (SGI, 3Dlabs). Ideally we'd like to end up with a Creative\nCommons license on all the ref pages and Apache 2.0 on all the scripts\nand tools, but it's unlikely that will ever be possible.\n\nThe SGI Free Software B License used on some of the pages is no longer\nhosted at the original location on SGI's webservers, following their\nacquisition. Instead, we host a copy in LICENSES/LicenseRef-FreeB.txt, and\nhave updated copyright links in the reference pages to this file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhronosgroup%2Fopengl-refpages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhronosgroup%2Fopengl-refpages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhronosgroup%2Fopengl-refpages/lists"}