MediaWiki for Communities of Interest: Difference between revisions
updated with installs needed |
|||
| Line 1: | Line 1: | ||
== About == | == About == | ||
=== Is | === Is MediaWiki the Right Choice === | ||
== Considerations Before You Start == | == Considerations Before You Start == | ||
* Consider whether your community has permanent file storage | * Consider whether your community has permanent file storage when determining whether to allow PDFs and other file types and increasing the file size on the media wiki. | ||
* You'll likely want to customize the wiki name and logo. You should also consider customizing terms and privacy agreements. | * You'll likely want to customize the wiki name and logo. You should also consider customizing terms and privacy agreements. | ||
== Configuring MediaWiki == | == Configuring MediaWiki == | ||
=== Customizing the MediaWiki === | === Customizing the MediaWiki === | ||
You'll likely want to customize the wiki name and logo. You should also consider customizing terms and privacy agreements. | You'll likely want to customize the wiki name and logo. You should also consider customizing terms and privacy agreements. | ||
=== File Uploads === | === File Uploads === | ||
When determining whether to allow PDFs and other file types and increasing the file size on the media wiki, consider whether your community has permanent file storage. | When determining whether to allow PDFs and other file types and increasing the file size on the media wiki, consider whether your community has permanent file storage. | ||
=== Extensions to Consider === | === Extensions to Consider === | ||
=== API Integration === | === API Integration === | ||
== Enabling Identity Management == | == Enabling Identity Management == | ||
| Line 58: | Line 59: | ||
<pre> | <pre> | ||
git clone https://gerrit.wikimedia.org/r/3d2png | git clone -b REL1_42 https://gerrit.wikimedia.org/r/3d2png | ||
cd 3d2png | cd 3d2png | ||
npm install | npm install | ||
| Line 64: | Line 65: | ||
Update `LocalSettings.php` to tell the 3D extension how to call the thumbnail generator: | Update `LocalSettings.php` to tell the 3D extension how to call the thumbnail generator: | ||
===== Troubleshooting ===== | |||
If you encounter issues during the setup, ensure the following: | |||
* Ensure **xvfb** and other X11 dependencies are installed using the following command: | |||
<pre> | |||
apt-get install libx11-dev libxi-dev libxext-dev xvfb libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev mesa-common-dev | |||
</pre> | |||
* Check for missing dependencies or errors in the JavaScript libraries during `npm install`. | |||
* If NPM install doesn't work this may fix it. Make sure that the version of these repos cloned matches with the version of media wiki you are running. | |||
** git clone -b REL1_42 for mediawiki 1.42.* | |||
===== Configuring ===== | |||
<pre> | <pre> | ||
$wg3dProcessor = [ | $wg3dProcessor = [ | ||
| Line 91: | Line 104: | ||
==== 2. View 3D Models ==== | ==== 2. View 3D Models ==== | ||
Uploaded 3D models will be displayed interactively on their file pages. Thumbnails will be automatically generated using the `3d2png` service. | Uploaded 3D models will be displayed interactively on their file pages. Thumbnails will be automatically generated using the `3d2png` service. | ||