Skip to content

eprintsug/gitaar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

gitaar

Build and publish EPrints Package Manager (EPM) packages from the command line.

The example below installs the bootstrap theme.

Install gitaar

when /opt/eprints3/ is a git repository

$ cd /opt/eprints3
$ git submodule add https://github.com/eprintsug/gitaar.git

or for a packaged install use git clone

$ cd /opt/eprints3
$ git clone https://github.com/eprintsug/gitaar.git

Pull in git-hosted package

Same caveat as installing WRT git submodule vs git clone.

$ git submodule add https://github.com/eprintsug/bootstrap.git lib/emp/bootstrap

Install package

epm can't enable package a without a .epmi file (for example lib/epm/bootstrap/bootstrap.epmi)

$ tools/epm link_lib bootstrap 
Error! 'bootstrap' is not installed or is an invalid epm identifier

If required generate bootstrap.epmi

$ gitaar/gitaar build_epmi REPOID bootstrap
Wrote /opt/eprints3/lib/epm/bootstrap/bootstrap.epmi

Once a new .epmi is written, perform the linking and enable the package.

$ tools/epm link_lib bootstrap
/opt/eprints3/lib/lang/en/phrases/bootstrap.xml
/opt/eprints3/lib/themes/bootstrap/templates/default.xml
/opt/eprints3/lib/themes/bootstrap/static/bootstrap_assets/Scripts/admin_menus.js
[...]

$ tools/epm enable REPOID bootstrap
Message! Repository configuration reloaded!

Publishing

To create a distributable EPM you can either use the UI or:

$ gitaar/gitaar build_epm REPOID bootstrap
Wrote /opt/eprints3/var/cache/epm/bootstrap-1.0.0.epm

To publish your EPM to the EPrints Bazaar you can either use the UI or:

$ gitaar/gitaar publish REPOID bootstrap