{"id":21241280,"url":"https://github.com/joomla/api.joomla.org","last_synced_at":"2026-01-02T08:05:36.515Z","repository":{"id":8945946,"uuid":"10681052","full_name":"joomla/api.joomla.org","owner":"joomla","description":"Repository containing the source files for building the Joomla! API website","archived":false,"fork":false,"pushed_at":"2024-01-14T22:39:41.000Z","size":1441,"stargazers_count":5,"open_issues_count":8,"forks_count":9,"subscribers_count":41,"default_branch":"master","last_synced_at":"2024-04-14T06:45:21.574Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://api.joomla.org","language":"Twig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joomla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2013-06-14T03:25:04.000Z","updated_at":"2023-06-29T19:51:49.000Z","dependencies_parsed_at":"2024-01-16T23:27:18.808Z","dependency_job_id":"f574ef1b-9a19-4ee7-8683-1ca41c19d84d","html_url":"https://github.com/joomla/api.joomla.org","commit_stats":{"total_commits":220,"total_committers":6,"mean_commits":"36.666666666666664","dds":"0.19090909090909092","last_synced_commit":"aab22d914899bfce561ff2a68e6f14d81a8d79c9"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fapi.joomla.org","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fapi.joomla.org/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fapi.joomla.org/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fapi.joomla.org/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joomla","download_url":"https://codeload.github.com/joomla/api.joomla.org/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242910024,"owners_count":20205206,"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":"2024-11-21T00:55:18.483Z","updated_at":"2026-01-02T08:05:36.488Z","avatar_url":"https://github.com/joomla.png","language":"Twig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Joomla! API Documentation\n\nThis repository hosts the source files used to build the [Joomla! API Documentation](https://api.joomla.org) website.\n\n## Static Files\n\nThe following static files are used for the general website\n\n- `index.html` is the site's homepage\n- `results.html` is the search results page; this uses Google's Custom Search platform\n- `.htaccess` and `robots.txt` should be self explanatory\n\n## phpDocumentor Template\n\nMost of the other files in this repository are used by [phpDocumentor](https://www.phpdoc.org/) for generating the API documentation.  A general structure can be found in the `template.xml` file.\n\nMost of the static media assets in this repository (CSS, JavaScript, and images) are used within the generated documentation; some of the images are template assets or used by the homepage.\n\n## Website Structure\n\nThe live website currently has the following top level directories.  The generated documentation is not checked into version control.\n\n- `cms-2.5` contains the API documentation for the Joomla! 2.5 branch\n- `cms-3` contains the API documentation for the Joomla! 3.x branch\n- `framework-1` contains the API documentation for the Joomla! Framework 1.x branch\n- `framework-2` contains the API documentation for the Joomla! Framework 2.x branch\n\nThe following directories are no longer indexed by search engines but are still present on the server.\n\n- `1.5` contains the API documentation for the Joomla! 1.5 branch\n- `11.4` contains the API documentation for the Joomla! Platform 11.4 release\n- `12.1` contains the API documentation for the Joomla! Platform 12.1 release\n\n## Deployment\nDeployment is done with Drone CI and consists of 2 pipelines.\n- The first pipeline is triggered when a PR or commit is pushed to the master branch. This deploys the static files of the site, which means mainly the homepage.\n- The second pipeline is triggered when a custom build is triggered from ci.joomla.org. This needs additional parameters and wont work without it!\n\n### CMS API documentation deployment\nTo generate the CMS API documentation, go to https://ci.joomla.org/joomla/api.joomla.org and click on \"New Build\" in the top right corner. In the popup, set \"Branch\" to \"master\" and type in \"JTYPE\" for \"key\" under \"Parameters\" and \"cms\" as value for that key. **You have to click \"add\" to actually add this!** Besides saving the parameter, this also adds another parameter and we have to type in \"JVERSION\" as key and the tag-name of the release as value. Remember to click \"Add\" again!\n\nThis checks out the tag from joomla/joomla-cms and then builds the documentation with phpDocumentor including the class hierarchy diagram. This is then automatically uploaded to the api.joomla.org server.\n\n### Framework API documentation deployment\nTo generate the CMS API documentation, go to https://ci.joomla.org/joomla/api.joomla.org and click on \"New Build\" in the top right corner. In the popup, set \"Branch\" to \"master\" and type in \"JTYPE\" for \"key\" under \"Parameters\" and \"framework\" as value for that key. **You have to click \"add\" to actually add this!** Besides saving the parameter, this also adds another parameter and we have to type in \"JVERSION\" as key and the major version of the framework you want to build. Remember to click \"Add\" again!\n\nThis checks out all framework packages from the packages.yml file with the Robo.li script (vendor/bin/robo checkout:repos --fw=2) into one common folder, then runs phpDocumentor on this, including the class hierarchy diagram, and then uploads that to the corresponding folder on api.joomla.org. **Right now this only supports the version 2 of the framework.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoomla%2Fapi.joomla.org","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoomla%2Fapi.joomla.org","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoomla%2Fapi.joomla.org/lists"}