Difference between revisions of "AppSuite:Upgrading themes to 7 6"

m (Steps)
(Steps)
Line 14: Line 14:
 
## Run '''grunt show-config:local --output grunt/local.conf.json'''
 
## Run '''grunt show-config:local --output grunt/local.conf.json'''
 
## Edit grunt/local.conf.json to have a proper '''coreDir'''. Just enter the absolute path to ''ui/build'' of the core UI.
 
## Edit grunt/local.conf.json to have a proper '''coreDir'''. Just enter the absolute path to ''ui/build'' of the core UI.
 +
# Now build your theme(s) via '''grunt'''. Please mind that you won't see any build errors if your theme ''defines'' deprecated variables - you will get errors if your theme ''uses'' deprecated and therefore undefined variables (see [[AppSuite:Theming#Variables]]).
 
# You have two alternatives now:
 
# You have two alternatives now:
 
## Run against an existing server. Just run '''grunt connect watch''' now. Please mind to enter a valid server in your local conf.
 
## Run against an existing server. Just run '''grunt connect watch''' now. Please mind to enter a valid server in your local conf.
 
## Run your own local server. Switch to core UI folder. Enter the theme's repository to "prefixes" array in grunt/local.conf.json. Absolute path including "build", e.g. ''/Users/foofoo/git/repo/great-themes/build''. Now run '''grunt connect watch'''.
 
## Run your own local server. Switch to core UI folder. Enter the theme's repository to "prefixes" array in grunt/local.conf.json. Absolute path including "build", e.g. ''/Users/foofoo/git/repo/great-themes/build''. Now run '''grunt connect watch'''.

Revision as of 08:57, 1 July 2014

Upgrading themes to 7.6

This article guides through the mandatory steps to update themes from 7.4.x to 7.6.0. It's does not cover what is necessary to migrate to the new build system.

Prerequisite

You need a built core UI! See Getting Started With Grunt. In a nutshell: git clone repository, setup (npm install, local config etc.), and build with grunt.

Steps

  1. First time: Clone the git repository, e.g. git clone https://git.open-xchange.com/git/foo. Make sure you're in the proper branch (git checkout branch-name). Don't forget to git pull.
  2. First time: Run npm install
  3. Run grunt watch. If you already have a local grunt config for this repository, you're fine. Otherwise you will be notified that coreDir is not configured. Grunt will offer you a command to get a basic grunt config (see next step).
  4. If config is missing:
    1. Run grunt show-config:local --output grunt/local.conf.json
    2. Edit grunt/local.conf.json to have a proper coreDir. Just enter the absolute path to ui/build of the core UI.
  5. Now build your theme(s) via grunt. Please mind that you won't see any build errors if your theme defines deprecated variables - you will get errors if your theme uses deprecated and therefore undefined variables (see AppSuite:Theming#Variables).
  6. You have two alternatives now:
    1. Run against an existing server. Just run grunt connect watch now. Please mind to enter a valid server in your local conf.
    2. Run your own local server. Switch to core UI folder. Enter the theme's repository to "prefixes" array in grunt/local.conf.json. Absolute path including "build", e.g. /Users/foofoo/git/repo/great-themes/build. Now run grunt connect watch.