Greenmine/install: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 4: Line 4:
* '''{{arg|$HOME}}''' = the home folder for all of the domain-user's files
* '''{{arg|$HOME}}''' = the home folder for all of the domain-user's files
* '''{{arg|$WEB}}''' = the public HTML folder (typically <code>public_html</code> or <code>www</code>) inside {{arg|$HOME}}
* '''{{arg|$WEB}}''' = the public HTML folder (typically <code>public_html</code> or <code>www</code>) inside {{arg|$HOME}}
* '''{{arg|$ft}}''' = the Ferreteria base folder (My convention: {{arg|$HOME}}/site/git/ferreteria)
* '''{{arg|$gm}}''' = the Greenmine base folder (My convention: {{arg|$HOME}}/site/git/ferreteria)


See [[conventions/vdomain]] for more explanation.
See [[conventions/vdomain]] for more explanation.
Line 14: Line 14:
| Set up folder structure
| Set up folder structure
|-
|-
| || cd {{arg|uhome}} || {{arg|uhome}}
| || cd {{arg|$HOME}} || {{arg|$HOME}}
|-
|-
| ||
| ||
Line 21: Line 21:
  mkdir git
  mkdir git
  cd git
  cd git
| {{arg|uhome}}/site/git
| {{arg|$HOME}}/site/git
|-
|-
| Install Greenmine & Ferreteria
| Install Greenmine & Ferreteria
|
|
  git clone git@gitlab.com:woozalia/greenmine.git
  git clone git@gitlab.com:woozalia/greenmine.git
| {{arg|uhome}}/site/git
| {{arg|$HOME}}/site/git
|-
|-
| colspan=3 | Link to Ferreteria from a standard location, so we can use the standard Ferreteria installation instructions.
| colspan=3 | Link to Ferreteria from a standard location, so we can use the standard Ferreteria installation instructions.
Line 36: Line 36:
| colspan=3 | Set up more folder structure: config folders
| colspan=3 | Set up more folder structure: config folders
|-
|-
| || <code>cd {{arg|uhome}}/site</code> || {{arg|uhome}}/site
| || <code>cd {{arg|$HOME}}/site</code> || {{arg|$HOME}}/site
|-
|-
| ||
| ||
Line 44: Line 44:
  cd greenmine
  cd greenmine
  mkdir portable
  mkdir portable
| {{arg|uhome}}/site/config/greenmine/portable
| {{arg|$HOME}}/site/config/greenmine/portable
|-
|-
| colspan=3 | Make soft links from <code>{{arg|gm}}/config/portable/*</code> to <code>{{arg|uhome}}/config/greenmine/portable/</code>.
| colspan=3 | Make soft links from <code>{{arg|$gm}}/config/portable/*</code> to <code>{{arg|$HOME}}/config/greenmine/portable/</code>.
|-
|-
| IN PROGRESS
| IN PROGRESS

Latest revision as of 17:51, 11 November 2021

The previous draft of installation instructions is here, for reference. Ferreteria is now included as a submodule of Greenmine, which affects folder locations and negates the need to clone it separately.

I'll use the following shorthand:

  • <$HOME> = the home folder for all of the domain-user's files
  • <$WEB> = the public HTML folder (typically public_html or www) inside <$HOME>
  • <$gm> = the Greenmine base folder (My convention: <$HOME>/site/git/ferreteria)

See conventions/vdomain for more explanation.

Action / Intention Commands Where You End Up
Set up folder structure
cd <$HOME> <$HOME>
mkdir site
cd site
mkdir git
cd git
<$HOME>/site/git
Install Greenmine & Ferreteria
git clone git@gitlab.com:woozalia/greenmine.git
<$HOME>/site/git
Link to Ferreteria from a standard location, so we can use the standard Ferreteria installation instructions.
ln -sv greenmine/ferreteria
Install Ferreteria (skip the git clone step; we've already done that here).
Set up more folder structure: config folders
cd <$HOME>/site <$HOME>/site
mkdir config
cd config
mkdir greenmine
cd greenmine
mkdir portable
<$HOME>/site/config/greenmine/portable
Make soft links from <$gm>/config/portable/* to <$HOME>/config/greenmine/portable/.
IN PROGRESS
ln -sv ../../../

documentation in progress

TODO: document creation of database and tables