Skip to content

How to get started

Don Richards edited this page Feb 27, 2023 · 5 revisions
  1. Create a custom.Makefile
  2. Create a fork of https://github.com/Islandora-Devops/islandora-starter-site
  3. Copy the starter-dev function to this file and rename it. Also point the codebase repo to your fork.
.PHONY: universityname_up
## Awesome University build command
universityname_up: QUOTED_CURDIR = "$(CURDIR)"
universityname_up: generate-secrets
	$(MAKE) starter-init ENVIRONMENT=starter_dev
	if [ -z "$$(ls -A $(QUOTED_CURDIR)/codebase)" ]; then \
		docker container run --rm -v $(CURDIR)/codebase:/home/root $(REPOSITORY)/nginx:$(TAG) with-contenv bash -lc 'git clone -b main https://github.com/Awesome-University/islandora-starter-site /home/root;'; \
	fi
	$(MAKE) set-files-owner SRC=$(CURDIR)/codebase ENVIRONMENT=starter_dev
	docker-compose up -d --remove-orphans
	docker-compose exec -T drupal with-contenv bash -lc 'composer install'
	$(MAKE) starter-finalize ENVIRONMENT=starter_dev
  1. You will want add a theme & possibly a custom migration to your composer.json file. Here are a couple of examples of ways to add a repository. This is where you can install modules and themes. As well as a lot more. Not that you can specify "type" here but it isn't installed until you run composer require ORG/MODULE_OR_THEME_NAME
 "repositories": [
        ...
        {
            "type": "vcs",
            "url": "https://github.com/Awesome-University/custom_module.git"
        },
        {
            "type": "package",
            "package": {
                "name": "mjordan/islandora_workbench_integration",
                "version": "1.0.0",
                "type": "drupal-module",
                "source": {
                    "type": "git",
                    "url": "https://github.com/mjordan/islandora_workbench_integration.git",
                    "reference": "main"
                }
            }
        },
        {
            "type": "package",
            "package": {
                "name": "jhu-idc/idc_ui_theme_boots",
                "version": "1.0.1",
                "type": "drupal-theme",
                "source": {
                    "type": "git",
                    "url": "https://github.com/jhu-idc/idc_ui_theme_boots.git",
                    "reference": "main"
                },
                "require": {
                    "drupal/bootstrap_barrio": "^4.0"
                }
            }
...