Registering a new module or theme with omeka.org
After you register your GitHub repository as an Omeka addon we’ll automatically identify and publish new versions of your addon if you follow these steps.
First, in your addon’s GitHub repository, go to the releases page and click “Draft a new release”. Enter a tag name (it does not have to be your addon version) and target branch. We recommend entering a release title (e.g. addon version) and description (e.g. release notes, changelog, etc.), but it’s not required.
Then, on your own computer, create a ZIP archive of the packaged,
ready-for-release addon; we recommend using Git’s archive
command:
$ git archive --output={AddonZipName}.zip --prefix={AddonDirName}/ {tagname}
Note that the {AddonDirName}
must match the directory name you
initially registered. The {AddonZipName}
can be anything, but we
recommend that it’s the same as {AddonDirName}
. Afterwards, attach
this ZIP file to the release as a binary.
Then, to complete the process, click “Publish release”. If everything checks out, we’ll register the release shortly. After we have added it to the registry, updates following the same procedure will be automatically updated. If you subsequently set the release to be a prerelease or draft, we will remove the release from our registry.
Note that we pull in your GitHub repository’s README and publish it alongside your addon versions. Make sure the README is ready for publication and that the filename uses all caps (e.g., README.md).
Before registring your releases we check that certain things are true:
Your repository has releases
The release is not a draft
The release is not a prerelease
The release has an attached binary (asset)
The release/asset combination is not already registered
The asset has the .zip extension
The asset is a ZIP file
The ZIP file contains only one top-level directory
The ZIP file top-level directory is named the same as the one you registered
The ZIP file contains a .jpg thumbnail (themes only)
The ZIP file contains an INI file at the correct path:
for plugins: /plugin.ini
for themes: /theme.ini
The INI file has no parsing errors
The INI file has an
[info]
sectionThe INI file has a
version
If all these things are true we register and publish the release. Keep in mind that we do not check if the addon works as expected. It is your responsibility to set your release to a tag or commit that’s in working condition.