Difference between revisions of "Full Installation Instructions"

From SemanticOrganization
Jump to: navigation, search
Line 34: Line 34:
 
=== Run Installation Procedure ===
 
=== Run Installation Procedure ===
  
==== With the Installer ====
+
==== - Using the Installer ====
  
Open <code>mydomain.tld/w</code> and follow the instructions, chose Tweeki as a standard skin, activate ParserFunctions, Page Forms, and Semantic Organization extensions.
+
Open <code>mydomain.tld/w</code> and follow the instructions, chose Tweeki as a standard skin, activate ParserFunctions, Page Forms, and Semantic Organization extensions. It is recommended to use semorg only with private wikis (only registered users are allowed to read and edit the wiki).
  
==== CLI installation ====
+
add the following to <code>LocalSettings.php</code>:
 +
{{LocalSettings.php-Tweaks}}
 +
 
 +
==== - CLI installation ====
  
 
  php maintenance/install.php --dbname=DBNAME --dbuser=DBUSER --dbpass=DBPASS --scriptpath=/w --lang=en --pass=USERPASS "WIKINAME" "USERNAME"
 
  php maintenance/install.php --dbname=DBNAME --dbuser=DBUSER --dbpass=DBPASS --scriptpath=/w --lang=en --pass=USERPASS "WIKINAME" "USERNAME"
Line 48: Line 51:
  
 
add the following to <code>LocalSettings.php</code>:
 
add the following to <code>LocalSettings.php</code>:
  # Show Tweeki's advanced features by default
+
  # Loading extensions
$wgDefaultUserOptions['tweeki-advanced'] = 1;
 
 
# Load Parser Functions extension
 
 
  wfLoadExtension( 'ParserFunctions' );
 
  wfLoadExtension( 'ParserFunctions' );
# Enable String Functions
 
$wgPFEnableStringFunctions = true;
 
 
# Enable Semantic MediaWiki
 
enableSemantics('YOURDOMAIN.TLD');
 
$smwgEnabledEditPageHelp = false;
 
$smwgLinksInValues = true;
 
 
# Load Page Forms and Semantic Organization extensions
 
 
  wfLoadExtension('PageForms');
 
  wfLoadExtension('PageForms');
$wgPageFormsAutocompleteOnAllChars = true;
 
 
  wfLoadExtension('SemanticOrganization');
 
  wfLoadExtension('SemanticOrganization');
 
# Disable caching
 
$wgEnableParserCache = false;
 
$wgCachePages = false;
 
 
# Allow display titles for automatically created page names
 
$wgRestrictDisplayTitle = false;
 
  
# Make Wiki private
+
{{LocalSettings.php-Tweaks}}
$wgGroupPermissions['*']['createaccount'] = false;
 
$wgGroupPermissions['*']['read'] = false;
 
$wgGroupPermissions['*']['edit'] = false;
 
  
 
=== Import Semorg Pages ===
 
=== Import Semorg Pages ===

Revision as of 09:14, 16 August 2018

Full Installation

Create database

mysql> create database sandbox;
mysql> grant all on sandbox.* to sandbox@localhost identified by '***';

Download MediaWiki

wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.0.tar.gz
tar xvzf mediawiki-1.31.0.tar.gz 
mv mediawiki-1.31.0 w
rm mediawiki-1.31.0.tar.gz

Download Tweeki Skin

cd w/skins/
git clone https://github.com/thaider/Tweeki

Download extensions

cd ../extensions/
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/PageForms.git
git clone https://github.com/thaider/SemanticOrganization

Install Semantic MediaWiki and Semantic Result Formats

Composer installieren

cd ..
composer require mediawiki/semantic-media-wiki "~2.5" --update-no-dev
composer require mediawiki/semantic-result-formats "~2.5" --update-no-dev

Run Installation Procedure

- Using the Installer

Open mydomain.tld/w and follow the instructions, chose Tweeki as a standard skin, activate ParserFunctions, Page Forms, and Semantic Organization extensions. It is recommended to use semorg only with private wikis (only registered users are allowed to read and edit the wiki).

add the following to LocalSettings.php:

# Use Tweeki as default skin
$wgDefaultSkin = 'tweeki';

# Show Tweeki's advanced features by default
$wgDefaultUserOptions['tweeki-advanced'] = 1;

# Use Bootstrap Tooltips
$wgTweekiSkinUseTooltips = true;

# Enable String Functions
$wgPFEnableStringFunctions = true;

# Enable Semantic MediaWiki
enableSemantics('YOURDOMAIN.TLD');
$smwgEnabledEditPageHelp = false;
$smwgLinksInValues = true;
$smwgPageSpecialProperties[] = '_CDAT';

# Settings for Page Forms
$wgPageFormsAutocompleteOnAllChars = true;

# Allow display titles for automatically created page names
$wgRestrictDisplayTitle = false;

# Encode section IDs with modern html5 style so Scrollspy works with special chars
# becomes obsolete with MW 1.37
$wgFragmentMode = [ 'html5', 'legacy' ];

# Use full screen width when no sidebar is shown
$wgTweekiSkinGridNone = [ 
  "mainoffset" => 0, 
  "mainwidth" => 12
];

- CLI installation

php maintenance/install.php --dbname=DBNAME --dbuser=DBUSER --dbpass=DBPASS --scriptpath=/w --lang=en --pass=USERPASS "WIKINAME" "USERNAME"
php maintenance/update.php --skip-external-dependencies

change the following in LocalSettings.php:

  • $wgLanguageCode to your language
  • $wgDefaultSkin to 'tweeki'

add the following to LocalSettings.php:

# Loading extensions
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension('PageForms');
wfLoadExtension('SemanticOrganization');
# Use Tweeki as default skin
$wgDefaultSkin = 'tweeki';

# Show Tweeki's advanced features by default
$wgDefaultUserOptions['tweeki-advanced'] = 1;

# Use Bootstrap Tooltips
$wgTweekiSkinUseTooltips = true;

# Enable String Functions
$wgPFEnableStringFunctions = true;

# Enable Semantic MediaWiki
enableSemantics('YOURDOMAIN.TLD');
$smwgEnabledEditPageHelp = false;
$smwgLinksInValues = true;
$smwgPageSpecialProperties[] = '_CDAT';

# Settings for Page Forms
$wgPageFormsAutocompleteOnAllChars = true;

# Allow display titles for automatically created page names
$wgRestrictDisplayTitle = false;

# Encode section IDs with modern html5 style so Scrollspy works with special chars
# becomes obsolete with MW 1.37
$wgFragmentMode = [ 'html5', 'legacy' ];

# Use full screen width when no sidebar is shown
$wgTweekiSkinGridNone = [ 
  "mainoffset" => 0, 
  "mainwidth" => 12
];

Import Semorg Pages

Import the default templates, forms and categories:

php maintenance/importDump.php < extensions/SemanticOrganization/import/semorg-pages.xml

Cleanup after import:

php maintenance/rebuildrecentchanges.php
php maintenance/runJobs.php