Difference between revisions of "Ferreteria/install"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to navigation Jump to search
(→‎Steps: oops, important step)
Line 17: Line 17:
 
* cd site
 
* cd site
 
* mkdir git
 
* mkdir git
 +
* cd git
 
* [[git clone]] git@gitlab.com:woozalia/ferreteria.git
 
* [[git clone]] git@gitlab.com:woozalia/ferreteria.git
 
* cd ..
 
* cd ..
Line 22: Line 23:
 
* cd config
 
* cd config
 
* cp -R ../git/ferreteria/config ferreteria
 
* cp -R ../git/ferreteria/config ferreteria
 +
 
===for standalone===
 
===for standalone===
 
Make a <code>dropins</code> folder under <code>site</code>, and link or copy the folders for all the Ferreteria dropins you want to use into that folder.
 
Make a <code>dropins</code> folder under <code>site</code>, and link or copy the folders for all the Ferreteria dropins you want to use into that folder.

Revision as of 14:07, 18 October 2020

  • Clone the Ferreteria Git repository into a folder of your choice, which we'll call {[arg|ferreteria base}}.
  • Copy the <ferreteria base>/config folder to a location outside of [ferreteria base].
    • We'll call this new location <local config>.
    • My standard location for this is /home/<user>/site/config/ferreteria
  • Optional: Modify each file to match your local environment, according to instructions in each file.
    • There's currently only one file, const.php, and it normally won't need modifying.

Woozle's setup

Some specifics of how I usually set things up these days, giving examples from the dev instance I'm setting up as I type this (see User:Woozle/setups/vdomain for definitions):

Preparation

You'll need to have <$USER>'s account set up with an ssh key that can access GitLab. At least, I think that's the requirement. It might be more GitLab-project-specific.

Steps

Run these commands in a terminal on your web server (you can skip mkdir wherever the folder already exists):

  • cd <$HOME>
  • su <$USER>
  • mkdir site
  • cd site
  • mkdir git
  • cd git
  • git clone git@gitlab.com:woozalia/ferreteria.git
  • cd ..
  • mkdir config
  • cd config
  • cp -R ../git/ferreteria/config ferreteria

for standalone

Make a dropins folder under site, and link or copy the folders for all the Ferreteria dropins you want to use into that folder.

for MediaWiki

Where $kfpSiteRoot is the server user's folder, and ferreteria's repo is in $kfpSiteRoot/git/ferreteria/:

$kfpConfigFerreteria = $kfpSiteRoot.'/site/config/ferreteria';
require_once($kfpSiteRoot.'/site/git/ferreteria/start.php');
ferreteria\classloader\cLoader::LoadLibrary('ferreteria.mw.core');