Greenmine/install: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:


I'll use the following shorthand:
I'll use the following shorthand:
* '''{{arg|www}}''' = the public HTML folder (typically <code>public_html</code> or <code>www</code>)
* '''{{arg|$HOME}}''' = the home folder for all of the domain-user's files
* '''{{arg|gm}}''' = the Greenmine base folder (I usually put it at ~/site/git/greenmine
* '''{{arg|$WEB}}''' = the public HTML folder (typically <code>public_html</code> or <code>www</code>) inside {{arg|$HOME}}
* '''{{arg|uhome}}''' = the home folder for the domain's files (outside of {{arg|www}})
* '''{{arg|$gm}}''' = the Greenmine base folder (My convention: {{arg|$HOME}}/site/git/ferreteria)


{|
See [[conventions/vdomain]] for more explanation.
 
{| border=1
|-
|-
! Action / Intention !! Example Commands
! Action / Intention !! Commands !! Where You End Up
|-
|-
| Set up folder structure
| Set up folder structure
|
|-
cd {{arg|uhome}}
| || cd {{arg|$HOME}} || {{arg|$HOME}}
|-
| ||
  mkdir site
  mkdir site
  cd site
  cd site
  mkdir git
  mkdir git
cd git
| {{arg|$HOME}}/site/git
|-
|-
| Install Greenmine & Ferreteria
| Install Greenmine & Ferreteria
|
|
cd git
  git clone git@gitlab.com:woozalia/greenmine.git
  git clone git@gitlab.com:woozalia/greenmine.git
| {{arg|$HOME}}/site/git
|-
| colspan=3 | Link to Ferreteria from a standard location, so we can use the standard Ferreteria installation instructions.
|-
| || <code>ln -sv greenmine/ferreteria
|-
| colspan=3 | [[htyp:Ferreteria/install|Install Ferreteria]] (skip the <code>git clone</code> step; we've already done that here).
|-
| colspan=3 | Set up more folder structure: config folders
|-
| || <code>cd {{arg|$HOME}}/site</code> || {{arg|$HOME}}/site
|-
| ||
mkdir config
cd config
mkdir greenmine
cd greenmine
mkdir portable
| {{arg|$HOME}}/site/config/greenmine/portable
|-
| colspan=3 | Make soft links from <code>{{arg|$gm}}/config/portable/*</code> to <code>{{arg|$HOME}}/config/greenmine/portable/</code>.
|-
|-
| Make soft links from <code>www</code> to <code>greenmine/
| IN PROGRESS
ln -sv ../../../
|}
|}



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