Boilerplate Theme
Configure GULP to automate several tasks, starting with minifying vendor JS files and compiling LESS
- Install Node https://nodejs.org/en/
- Install NPM globally
npm install npm -g(Node will come installed with NPM) - Install gulp globally
npm install gulp -g - Install less globally
npm install less -g - Verify Installs
node -v
npm -v
gulp -v
less -v
- Navigate to theme directory and from command line
npm install - Confirm creation of /node_modules/ (which will be ignored by Git)
- From the theme directory and from command line
gulp - Verify gulp is monitoring for changes by tweaking .less and .js files
--
Create a WordPress install (probably local)
Create a theme folder (i.e /wp-content/themes/themename/), navigate to that folder, and pull down the repo
git clone [email protected]:dd9/boiler.git .
#or
git clone https://github.com/dd9/boiler.git .
#then
git remote add upstream https://github.com/dd9/boiler.git
#or
git remote add upstream [email protected]:dd9/boiler.git
#then
git fetch upstream
--
http://git-scm.com/book/en/v2/Git-Tools-Submodules
From superproject root:
git submodule add https://github.com/DD9/boiler wp-content/themes/themename
You may need to run this from the superproject root, depending on if you pulled down the superproject repo with submodule already created.
git submodule init
git submodule update
If you want to check for new work in a submodule, you can go into the directory and run git fetch and git merge the upstream branch to update the local code. If you run git submodule update --remote, Git will go into your submodules and fetch and update for you.
To push from the submodule to the boiler repo, navigate to the theme repo, checkout the master branch (since you will be working from a detached head). Then work and commit as per usual. When finished, commit work to super repo as well.
--
http://blogs.atlassian.com/2013/05/alternatives-to-git-submodule-git-subtree/
https://medium.com/@v/git-subtrees-a-tutorial-6ff568381844
From superproject root:
git remote add -f boiler [email protected]:dd9/boiler.git
git subtree add --prefix=wp-content/themes/[THEMENAME] boiler master --squash
(This will create the theme directory for you.)
To pull down upstream changes
## Specd for later updates, but I didn't seem to need this. Also try adding --squash to this if you have to run it.
## git fetch boiler master
git subtree pull --prefix=wp-content/themes/[THEMENAME] boiler master --squash
To push changes back to boiler theme from within a different superproject root:
git subtree push --prefix=wp-content/themes/[THEMENAME] boiler master
(Pushes to master branch, will work for DD9 team authorized to deploy here)
http://blogs.atlassian.com/2013/05/alternatives-to-git-submodule-git-subtree/
https://help.github.com/articles/about-git-subtree-merges/
http://williamdodson.co/articles/git-subtree/
git remote add -f boiler [email protected]:dd9/boiler.git
git merge --squash -s ours --no-commit boiler/master
git read-tree --prefix=wp-content/themes/[THEMENAME] -u boiler/master
git commit -m "Merge boiler as subtree"
# Then to update the external subtree repo:
git pull --squash -s subtree boiler master
# no commit history from subtree, appears as though code changes were made directly to code in super project repo
#or
git pull -s subtree boiler master
# this brought in all the commits from the entire subtree history