Agaric web development cooperative's main web site: https://agaric.coop
Find a file
2021-07-14 08:01:39 -04:00
.ddev Commit meaningless ddev update 2021-07-14 06:52:52 -04:00
.gitlab/issue_templates Fix formatting in User Story template 2019-01-25 12:18:46 -07:00
box Create single method to provide all overridden values 2018-08-23 22:56:43 -04:00
config/sync Commit self-updates to config from code updb changes, mostly webform 2021-04-21 23:13:50 -04:00
drush Upgrade DDEV 2020-03-18 17:01:40 -04:00
provisioning Add rake tasks, provisioning, and templates 2019-02-20 15:55:38 -05:00
rakelib Add rake tasks, provisioning, and templates 2019-02-20 15:55:38 -05:00
scripts Add working CSS compiling script that bypasses node/grunt 2021-07-14 07:54:51 -04:00
web Update pattern library 2021-07-14 08:00:38 -04:00
.gitignore Update name of ignored backup directory 2021-07-14 08:01:39 -04:00
.gitmodules Specify branch for pattern library submodule to prevent detached head 2018-09-05 16:11:36 -04:00
composer.json Update dependencies 2021-07-02 12:57:45 -04:00
composer.lock Commit updated composer lock with very many minor version updates 2021-07-14 06:59:52 -04:00
Makefile Merge branch 'master' into 'add-rake-tasks' 2019-02-20 21:05:56 +00:00
phpunit.xml Add the proper configuration to run the tests 2018-08-24 15:46:37 -04:00
Rakefile Add rake tasks, provisioning, and templates 2019-02-20 15:55:38 -05:00
README.md Update instructions to use DDEV 2020-11-13 18:11:17 -05:00
redirects.txt Add redirects.txt as expected per drutopia_host 2018-12-07 02:00:24 -05:00
SERVICES.md record our server and who it's named after 2019-03-10 10:03:51 -04:00
Vagrantfile Add all files needed to bring up VM and run agaric.com locally 2018-08-20 10:45:20 -04:00

Agaric's Flagship Site

See also SERVICES.md

Get submodules

This project includes the Agaric styleguide as a git submodule.

When cloning

git clone --recurse-submodules git@gitlab.com:agaric/sites/agaric-com.git

If you cloned without --recurse-submodules

If in your initial clone you didn't do as above, you can get the styleguide with:

git submodule init
git submodule update

Get started

To be able to import the configuration, you need to get the initializing database (where we will also be collaborating on content) from the test site pending resolution of drutopia#216.

ddev start
ddev composer install
ddev . drush -y sql-dump > /tmp/paranoia.sql && drush sql-drop && drush -y sql-sync @live @self && drush -y updb
ddev . drush -y rsync @live:%files @self:%files

Get updates

git pull
git submodule update --recursive --remote
ddev start
ddev composer install
ddev . drush -y sql-dump > /tmp/paranoia.sql && drush -y sql-drop && drush -y sql-sync @live @self && drush -y updb
ddev . drush -y rsync @live:%files @self:%files
ddev . drush cim -y

Theming

See web/themes/custom/agarica/README.md and web/themes/custom/agarica/patternlibrary/README.md

Deployment

Agaric is currently using a Platform as a Service version of Drutopia with additional modules.

Set up drutopia_host and hosting_private, as documented in hosting private.

Then use ahoy, from within the hosting_private directory.

Ensure all three related repositories are up-to-date with:

ahoy git-pull-all

If Agaric's Drutopia PaaS base has changed (the composer.lock in this directory), produce and push a new build:

ahoy deploy-build agaric

To deploy everything else (config, templates, styles):

ahoy deploy-site agaric_test

(And likewise for agaric_live.)

Then record the deployment. This applies to both deploy-site and deploy-build record keeping: Navigate to /drutopia_host/build_artifacts Add all new files generated with git add . Commit the files with a message on what you deployed with git commit -m "Add artifacts" Push the changes to the repo with git push

If you need to overwrite live configuration (only after confirming you've committed any parts you want to keep) you can use ahoy for that too with deploy-site-force.

Drupal settings file management

The Drupal settings files are also managed by Drutopia. On each deploy, the file is generated and replaces the settings.local.php that is on the server with whatever settings will match the Drutopia configuration. Therefore, in order to add settings, you must edit the vault settings using:

ahoy vault-edit

Look for the Yaml section for agaric_live, or agaric_test, as appropriate, and edit the php_settings_code section to add items to that site's setting overrides. For example:

      ...
      online: True
      php_settings_code: |2
        $settings['super_secret'] = p@ssw0rd;
        $config['life.answer'] = 42;
      server_aliases:
        - agaric.com
      ...

Code Hightlight.

The prism.js library was added in the site and can be used like this:

<pre>
  <code class="language-css">
    p { color: red }
  </code>
</pre>

The suffix of the class needs to be changed depending of the language that is going to be highlighted eg: language-php, language-js etc.