Greenmine/install: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
* Install [[Ferreteria]]
* Install [[Ferreteria]]
** This creates some folders which the following instructions assume already exist.
* Clone the [https://gitlab.com/woozalia/greenmine Greenmine Git repository] into a folder of your choice, which we'll call {{arg|greenmine base}}.
* Clone the [https://gitlab.com/woozalia/greenmine Greenmine Git repository] into a folder of your choice, which we'll call {{arg|greenmine base}}.
** My [[setups/vdomain|standard location]] for this is <code>/home/{{arg|user}}/site/git/greenmine/</code>.
** My [[setups/vdomain|standard location]] for this is <code>/home/{{arg|user}}/site/git/greenmine/</code>.
Line 15: Line 16:
  {{l/htyp|git clone}} git@gitlab.com:woozalia/greenmine.git
  {{l/htyp|git clone}} git@gitlab.com:woozalia/greenmine.git
  cd ../config
  cd ../config
{| style="background: #fef;"
|-
| style="border: 1px solid blue;" valign=top |
====For standard install:====
  cp -R ../git/greenmine/config greenmine
  cp -R ../git/greenmine/config greenmine
  cp -R greenmine/example greenmine/local
  cp -R greenmine/example greenmine/local
edit the files in <code>greenmine/local</code> as needed
This just copies the config folders from the git repository into the site configuration.
| style="border: 1px solid blue;" valign=top |
====For developers:====
mkdir greenmine
ln -rs ../git/greenmine/config/example greenmine/example
ln -rs ../git/greenmine/config/portable greenmine/portable
This makes links from the site configuration folders back to the git repository, so any alterations to portable files will be included in git commits.
|}
Then edit the files in <code>greenmine/local</code> as needed. You will definitely need to edit creds.php in order to get things working.


{{hilite|'''documentation in progress'''}}
{{hilite|'''documentation in progress'''}}


Note: might want to link instead of copying files that don't need to be edited, so the defaults get updated. Investigate later.
Note: might want to link instead of copying files that don't need to be edited, so the defaults get updated. Investigate later.

Revision as of 19:57, 23 February 2021

  • Install Ferreteria
    • This creates some folders which the following instructions assume already exist.
  • Clone the Greenmine Git repository into a folder of your choice, which we'll call <greenmine base>.
  • Copy the <greenmine base>/config folder to a location outside of [greenmine base].
    • We'll call this new location <local config>.
    • My standard location for this is /home/<user>/site/config/greenmine
  • Make a copy of the <local config>/example folder and name it <local config>/local.

documentation in progress

Steps

After installing Ferreteria, run these commands in a terminal on your web server:

cd <$HOME>
su <$USER>
cd site/git
git clone git@gitlab.com:woozalia/greenmine.git
cd ../config

For standard install:

cp -R ../git/greenmine/config greenmine
cp -R greenmine/example greenmine/local

This just copies the config folders from the git repository into the site configuration.

For developers:

mkdir greenmine
ln -rs ../git/greenmine/config/example greenmine/example
ln -rs ../git/greenmine/config/portable greenmine/portable

This makes links from the site configuration folders back to the git repository, so any alterations to portable files will be included in git commits.

Then edit the files in greenmine/local as needed. You will definitely need to edit creds.php in order to get things working.

documentation in progress

Note: might want to link instead of copying files that don't need to be edited, so the defaults get updated. Investigate later.