trellis-sage-9-compiler

This is not production-ready yet! See: roots/trellis#1030

• TODOs (Help wanted)
• Requirements
• Installation
• Role Variables
  • name
  • cleanup
• Usage
• FAQs
  • It looks awesome. Where can I find some more goodies like this?
  • This package isn't on wp.org. Where can I give a ⭐️⭐️⭐️⭐️⭐️ review?
• Testing
  • Syntax Check
• Author Information
• Feedback
• Change log
• License

This is not production-ready yet! See: roots/trellis#1030

TODOs (Help wanted)

• Test on older versions of ansible (only 2.7.4 is tested)
• Test on the offical roots file structure (only the @tangrufus way is tested)
• Allow variables in defaults be customizable

Requirements

• Ansible v2.4 or later
• Trellis with roots/trellis#1030 patched
• Sage v9

Installation

Add this role to requirements.yml:

# requirements.yml
- src: https://github.com/ItinerisLtd/trellis-sage-9-compiler
  version: master # This is not production-ready yet!

Hook this role to deploy_build_before:

# group_vars/all/deploy-hooks.yml
# Learn more on https://roots.io/trellis/docs/deploys/#hooks
deploy_build_before:
  - "{{ playbook_dir }}/vendor/roles/trellis-sage-9-compiler/tasks/main.yml"

Run the command:

➜ ansible-galaxy install -r requirements.yml --force

Role Variables

# group_vars/<env>/wordpress_sites.yml
wordpress_sites:
  example.com:
    sage_9_compiler:
      - name: my-first-sage-theme-name
      - name: my-second-sage-theme-name
        cleanup: true
      - name: my-second-sage-theme-name
        cleanup: false

name

• Required
• Type: string
• Directory name of your sage theme

cleanup

• Optional
• Default: false
• Type: boolean
• Whether to remove theme source files

More variables in defaults. (Currently not customizable)

Usage

Deploy as usual. No special action needed.

FAQs

It looks awesome. Where can I find some more goodies like this?

• Articles on Itineris' blog
• More projects on Itineris' GitHub profile
• Follow @itineris_ltd and @TangRufus on Twitter
• Hire Itineris to build your next awesome site

This package isn't on wp.org. Where can I give a ⭐️⭐️⭐️⭐️⭐️ review?

Thanks! Glad you like it. It's important to make my boss know somebody is using this project. Instead of giving reviews on wp.org, consider:

• tweet something good with mentioning @itineris_ltd
• star this Github repo
• watch this Github repo
• write blog posts
• submit pull requests
• hire Itineris

Testing

Syntax Check

➜ ansible-playbook -i 'localhost,' --syntax-check tests/test.yml

Author Information

TODO: Discuss with the roots team!

trellis-sage-9-compiler is a Itineris Limited project created by Tang Rufus. Fork from roots/trellis because of roots/trellis#1030.

Special thanks to the Roots team whose Trellis make this project possible.

Full list of contributors can be found here.

Feedback

Please provide feedback! We want to make this library useful in as many projects as possible. Please submit an issue and point out what you do and don't like, or fork the project and make suggestions. No issue is too small.

Change log

Please see CHANGELOG for more information on what has changed recently.

License

trellis-sage-9-compiler is released under the MIT License.