{"id":13557008,"url":"https://github.com/omeka/omeka-s","last_synced_at":"2025-05-15T01:06:06.724Z","repository":{"id":10018356,"uuid":"12057192","full_name":"omeka/omeka-s","owner":"omeka","description":"Omeka S is a web publication system for universities, galleries, libraries, archives, and museums. It consists of a local network of independently curated exhibits sharing a collaboratively built pool of items, media, and their metadata.","archived":false,"fork":false,"pushed_at":"2025-05-01T19:27:46.000Z","size":40116,"stargazers_count":433,"open_issues_count":176,"forks_count":145,"subscribers_count":54,"default_branch":"develop","last_synced_at":"2025-05-01T20:31:51.455Z","etag":null,"topics":["cms","linked-data","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omeka.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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-08-12T14:00:37.000Z","updated_at":"2025-04-30T03:06:30.000Z","dependencies_parsed_at":"2023-09-27T20:39:14.641Z","dependency_job_id":"e9ad828d-1641-4b99-9991-f229ac656611","html_url":"https://github.com/omeka/omeka-s","commit_stats":null,"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omeka%2Fomeka-s","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omeka%2Fomeka-s/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omeka%2Fomeka-s/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omeka%2Fomeka-s/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omeka","download_url":"https://codeload.github.com/omeka/omeka-s/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254254040,"owners_count":22039792,"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":["cms","linked-data","php"],"created_at":"2024-08-01T12:04:07.215Z","updated_at":"2025-05-15T01:06:06.708Z","avatar_url":"https://github.com/omeka.png","language":"PHP","funding_links":[],"categories":["PHP","php","Collection Management"],"sub_categories":[],"readme":"# Omeka S\n\nOmeka S is a web publication system for universities, galleries, libraries, archives, and museums. It consists of a local network of independently curated exhibits sharing a collaboratively built pool of items, media, and their metadata.\n\nSee the [user manual](https://omeka.org/s/docs/user-manual) for more information.\n\n## Installation\n\n### Requirements\n* Linux\n* [Apache](https://www.apache.org/) (with [AllowOverride](https://httpd.apache.org/docs/2.4/mod/core.html#allowoverride) set to \"All\" and [mod_rewrite](http://httpd.apache.org/docs/current/mod/mod_rewrite.html) enabled)\n* [MySQL](https://www.mysql.com/) 5.7.9+ (or [MariaDB](https://mariadb.org/) 10.2.6+)\n* [PHP](https://www.php.net/) 7.4+ (latest stable version preferred, with [PDO](http://php.net/manual/en/intro.pdo.php), [pdo_mysql](http://php.net/manual/en/ref.pdo-mysql.php), and [xml](http://php.net/manual/en/intro.xml.php) extensions installed)\n\n### Generating thumbnails\n* The default library for generating thumbnails is [ImageMagick](https://imagemagick.org/index.php), at least version 6.7.5. Older versions will not correctly produce thumbnails. For alternative thumbnail options, see the [user manual](https://omeka.org/s/docs/user-manual/configuration/#thumbnails).\n\n### Installing from GitHub\n\n1. Make sure [Node.js](https://nodejs.org/) and [npm](https://nodejs.org/) are installed\n1. Clone this repository in your Apache web directory:\n   * `$ git clone https://github.com/omeka/omeka-s.git`\n1. Change into the Omeka S directory:\n   * `$ cd omeka-s`\n1. Perform first-time setup:\n   * `$ npm install`\n   * `$ npx gulp init`\n1. Open `config/database.ini` and add your MySQL username, password, database name, and host name. The user and database must be created before this step.\n1. Make sure the `files/` directory is writable by Apache.\n1. In your web browser, navigate to the omeka-s directory, where you can complete installation.\n\n### Installing from released zip file\n\n1. Download the latest release from the [release page](https://github.com/omeka/omeka-s/releases) (download the first asset listed)\n1. Open `config/database.ini` and add your MySQL username, password, database name, and host name. The user and database must be created before this step.\n1. Make sure the `files/` directory is writable by Apache.\n1. In your web browser, navigate to the omeka-s directory, where you can complete installation.\n\nYou can find Omeka-specific code under `application/`.\n\n## Updating\n\n*Make a backup copy of your entire site and its database!*\n\n### Updating from GitHub\n\n1. `git pull` as usual. Use the `master` branch for the latest releases.\n2. From the Omeka S root directory, run `npx gulp deps` to make sure dependencies are up to date.\n3. Compare changes in `/config/local.config.php` and `/config/local.config.php.dist`. Some default configurations might have changed, so you might need to reconcile changes to the distributed configuration with your local configuration (e.g., a path to PHP specific to your server, dev mode settings, etc.)\n4. In your web browser, go to your site and run any migrations that are needed.\n\n### Updating from released zip file\n1. Download the latest release from the [release page](https://github.com/omeka/omeka-s/releases)\n2. Make a copy of your `/config` directory. You will need to restore your `local.config.php` and `database.ini` files from that copy.\n3. Make a copy of your `/modules` and `/themes` directories.\n4. Make a copy of your `/files` directory.\n5. Remove all Omeka S files, and replace them with the files from the updated zip file.\n6. Replace your original `/config/local.config.php` file, and the `/modules`, `/themes`, and `/files` directories that you copied.\n7. In your web browser, go to your site and run any migrations that are needed.\n\n## Creating a zipped release\n\nRun `npx gulp zip` to create a zipped version of Omeka S and store it in `/build`. Use the `--no-dev` flag to omit Composer dev dependencies for a smaller package suitable for end-users. Official releases follow this same process from a new, clean checkout.\n\n## Libraries\n\nOmeka uses the following libraries, among others:\n\n* [Laminas](https://getlaminas.org/)\n* [Doctrine 2](http://www.doctrine-project.org/)\n* [EasyRdf](http://www.easyrdf.org/)\n* [PHPUnit](https://phpunit.de/)\n* [jQuery](http://jquery.com/)\n\n## Development Standards\n\nOmeka development adheres to the [Laminas Coding Style Guide](https://docs.laminas.dev/laminas-coding-standard/v2/coding-style-guide/) and uses the [git-flow](http://nvie.com/posts/a-successful-git-branching-model/) branching model and the [Semantic Versioning 2.0.0](https:/semver.org/spec/v2.0.0.html) version scheme.\n\nSee the [developer documentation](https://omeka.org/s/docs/developer/) for more information.\n\n# Copyright\n\nOmeka is Copyright © 2015-present Corporation for Digital Scholarship, Vienna, Virginia, USA http://digitalscholar.org\n\nThe Corporation for Digital Scholarship distributes the Omeka source code under the GNU General Public License, version 3 (GPLv3). The full text of this license is given in the license file.\n\nThe Omeka name is a registered trademark of the Corporation for Digital Scholarship.\n\nThird-party copyright in this distribution is noted where applicable.\n\nAll rights not expressly granted are reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomeka%2Fomeka-s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomeka%2Fomeka-s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomeka%2Fomeka-s/lists"}