Difference between revisions of "Mediawiki"

From Steak Wiki
Jump to navigationJump to search
 
(9 intermediate revisions by the same user not shown)
Line 36: Line 36:
 
     Module:Navbox
 
     Module:Navbox
 
And put them in the same pages on your wiki.
 
And put them in the same pages on your wiki.
 +
 +
Some other templates that are useful:
 +
Template:Cmd
 +
Template:Cat
 +
Template:Box
 +
These may be on other wikis, e.g. gnu\linux wikis.
 +
 
===LocalSettings.php===
 
===LocalSettings.php===
Something like the following should be added to LocalSettings.php (the mediawiki customization page):
+
Something like the following should be added to LocalSettings.php (the mediawiki customization page)(older versions used require_once, with a different call):
  
<pre>
 
# End of automatically generated settings.
 
# Add more configuration options below.
 
  
#require_once "./extensions/Scribunto/Scribunto.php";
+
wfLoadExtension( 'Scribunto' );
 +
$wgScribuntoDefaultEngine = 'luastandalone';
  
wfLoadExtension( 'Scribunto' );
 
$wgScribuntoDefaultEngine = 'luastandalone';
 
</pre>
 
 
===Common.css===
 
===Common.css===
 
Go to https://en.wikipedia.org/wiki/MediaWiki:Common.css
 
Go to https://en.wikipedia.org/wiki/MediaWiki:Common.css
Line 57: Line 59:
 
You can copy these from anywhere, but look at one of mine to get an example of how it's formatted.
 
You can copy these from anywhere, but look at one of mine to get an example of how it's formatted.
 
e.g. [[Template:GNU\Linux]]. Embed them in the site with 2x curly braces instead of brackets, and omit the Template part. So it would be "curly brace, curly brace, GNU\Linux, curly brace, curly brace. Again, examples are everywhere online.
 
e.g. [[Template:GNU\Linux]]. Embed them in the site with 2x curly braces instead of brackets, and omit the Template part. So it would be "curly brace, curly brace, GNU\Linux, curly brace, curly brace. Again, examples are everywhere online.
 +
 +
===White Space Counts in Navbox===
 +
Be careful of this. No spaces allowed between the end of Xilinx, and the start of * FPGA. Or else the formatting will break.
 +
<pre> | group3 = FPGAs
 +
| list3  =
 +
* [[Xilinx]]
 +
* [[FPGA - Rotary Encoder]]</pre>
 +
<pre>
 +
| group3 = FPGAs
 +
| list3  =
 +
* [[Xilinx]]
 +
* [[FPGA - Rotary Encoder]]</pre>
 +
 +
==Tips/Troubleshooting==
 +
===Mediawiki See a Users Posts===
 +
Click users page, then on left sidebar under tools - user contributions.
  
 
==Further Reading==
 
==Further Reading==
The Archives of Navbox can be stepped through (there are 30-40 now, so sit down, and allocate some time) to find where I figured this out from.
+
The Talk Archives of Navbox can be stepped through (there are maybe 30-40 now, so sit down, and allocate some time) to find where I figured this out from.
 +
 
 +
End result is below:
  
 
{{GNU\Linux}}
 
{{GNU\Linux}}

Latest revision as of 03:02, 29 September 2020

Mediawiki is what this site is. It's great. Much easier to digest information than a blog.

Mediawiki Docker Setup

todo

Mediawiki Navbox Setup

All mediawiki's should use the navbox. They are not in the default install though. So, hoops must be jumped through (job security for mediawiki admins...?). I will do my best to document this, and my steps should help anyone implementing this, however I can't confirm this will be 100% of what you need. However, it should get you most of the way there.

Roadmap

To install navbox we need to do the following:

  • Install Scribunto Extension, and get Lua enabled
  • Add some Module and Template pages to the custom wiki (Modules: Navbox,Arguments,Navbar and Template:Navbox)
  • LocalSettings.php of the mediawiki must have the scribuntu extension enabled
  • You must add a new Common.css file. It is placed in Mediawiki:Common.css (only admins can add this)

Install Scribunto

See https://www.mediawiki.org/wiki/Extension:Scribunto Straightforward. If you have docker, you'll have to make a volume for the extensions, something like the following in your docker-compose.yml:

 volumes:
      - ./mwiki_files/images/:/var/www/html/images
      # After initial setup, download LocalSettings.php to the same directory as
      # this yaml and uncomment the following line and use compose to restart
      # the mediawiki service
      # Note that it will create this file for you from the web setup.
      - ./mwiki_files/LocalSettings.php:/var/www/html/LocalSettings.php
      - ./mwiki_files/log/:/var/log/apache2/
      - ./mwiki_files/etc_apache/:/etc/apache2/
      # need extensions to add scribuntu to get modules to get navbox to work. ugh.
      - ./mwiki_files/extensions/:/var/www/html/extensions/
      - ./mwiki_files/uploads.ini:/usr/local/etc/php/conf.d/uploads.ini

Add some Module and Template pages

You need to copy and paste these from mediawiki.

   Template:Navbox
   Module:Arguments
   Module:Navbar
   Module:Navbox

And put them in the same pages on your wiki.

Some other templates that are useful:

Template:Cmd
Template:Cat
Template:Box

These may be on other wikis, e.g. gnu\linux wikis.

LocalSettings.php

Something like the following should be added to LocalSettings.php (the mediawiki customization page)(older versions used require_once, with a different call):


wfLoadExtension( 'Scribunto' );
$wgScribuntoDefaultEngine = 'luastandalone';

Common.css

Go to https://en.wikipedia.org/wiki/MediaWiki:Common.css copy the source code, and then upload that to your own wiki at the same page (Mediawiki:Common.css).

You will need to be an interface admin. You will find out this if it says Permission denied on the Mediawiki:Common.css page.

Example Template

You can copy these from anywhere, but look at one of mine to get an example of how it's formatted. e.g. Template:GNU\Linux. Embed them in the site with 2x curly braces instead of brackets, and omit the Template part. So it would be "curly brace, curly brace, GNU\Linux, curly brace, curly brace. Again, examples are everywhere online.

White Space Counts in Navbox

Be careful of this. No spaces allowed between the end of Xilinx, and the start of * FPGA. Or else the formatting will break.

 | group3 = FPGAs
 | list3  =
 * [[Xilinx]]
* [[FPGA - Rotary Encoder]]
 | group3 = FPGAs
 | list3  =
 * [[Xilinx]]
 * [[FPGA - Rotary Encoder]]

Tips/Troubleshooting

Mediawiki See a Users Posts

Click users page, then on left sidebar under tools - user contributions.

Further Reading

The Talk Archives of Navbox can be stepped through (there are maybe 30-40 now, so sit down, and allocate some time) to find where I figured this out from.

End result is below: