MediaWiki: Difference between revisions

Latest revision as of 00:34, 31 December 2023

Installation

See mediawiki for instructions on deployment.
I have a container image with my preferred extensions at https://github.com/dli7319/docker-mediawiki.

To update, bump your image version and then in your container run:

php maintenance/run.php update

Wikitext

Wikitext is the markup language for Mediawiki pages.

Import/Export

Importing Individual Pages From Wikipedia

Mediawikiwiki: Manual:Importing_Wikipedia_infoboxes_tutorial

Go to Wikipedia's Special:Export

Type in the page you want.

Template:Key press
Template:Key press/doc

Check include templates and download the file
Go to your wiki's Special:Import
Import the file.

Restricting Access

See https://www.mediawiki.org/wiki/Category:Page_specific_user_rights_extensions.
I use the Lockdown extension.

TODO

Find a way to insert text files into mediawiki (either via upload or as text).
- These should be downloadable with a link.
- Bonus if we can get syntax highlighting for code and if WebGL shaders can be made runnable.

Writing Extensions

PHP Hooks

See Mediawikiwiki:Manual:Hooks

ParserAfterTidy

This is only called for new sections of pages, not necessarily the entire page.

JS Hooks

See mw.hook documentation

@@ Line 1: / Line 1: @@
+==Installation==
+See [https://hub.docker.com/_/mediawiki mediawiki] for instructions on deployment.<br>
+I have a container image with my preferred extensions at https://github.com/dli7319/docker-mediawiki.
+To update, bump your image version and then in your container run:
-==Syntax==
-Below are how to typeset and format things in Mediawiki properly
-===Code===
-Inline code can by represented with <nowiki><code></code></nowiki><br>
-Code blocks should be like:
 <pre>
-<syntaxhighlight lang="cpp">
+php maintenance/run.php update
-// ... my code here
-</syntaxhighlight>
 </pre>
-===Math===
+==Wikitext==
-Math is written in standard latex syntax inside of <nowiki><math></math></nowiki>.
+{{ main | Wikitext}}
-* Beware: Do not use <code>||</code>, use <code>\Vert</code> instead.
-===Images===
+Wikitext is the markup language for Mediawiki pages.
-See [https://www.mediawiki.org/wiki/Help:Images https://www.mediawiki.org/wiki/Help:Images]
+==Import/Export==
+===Importing Individual Pages From Wikipedia===
+[[Mediawikiwiki: Manual:Importing_Wikipedia_infoboxes_tutorial]]
-==Advanced==
-===Importing Templates From Wikipedia===
-[https://www.mediawiki.org/wiki/Manual:Importing_Wikipedia_infoboxes_tutorial Link]<br>
 <ol>
 <li> Go to [https://en.wikipedia.org/wiki/Special:Export Wikipedia's Special:Export]</li>
-<li> Type in the templates you want. E.g.</li>
+<li> Type in the page you want.<br>
 <pre>
 Template:Key press
-Template:Key press/doc</pre>
+Template:Key press/doc</pre></li>
 <li> Check include templates and download the file</li>
 <li> Go to your wiki's [https://wiki.davidl.me/view/Special:Import Special:Import]</li>
@@ Line 35: / Line 29: @@
 ==Restricting Access==
-The best way to restrict access is to create a separate wiki.<br>
+See [https://www.mediawiki.org/wiki/Category:Page_specific_user_rights_extensions https://www.mediawiki.org/wiki/Category:Page_specific_user_rights_extensions].<br>
-However, there do exist extensions to manage access at the page-level.<br>
+I use the Lockdown extension.
-See [https://www.mediawiki.org/wiki/Category:Page_specific_user_rights_extensions https://www.mediawiki.org/wiki/Category:Page_specific_user_rights_extensions]<br>
-One such extension is [https://www.mediawiki.org/wiki/Extension:Semantic_ACL Semantic ACL] which requires [https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Semantic Mediawiki].
 ==TODO==
 * Find a way to insert text files into mediawiki (either via upload or as text).
 ** These should be downloadable with a link.
-** Bonus if <code>.js</code> files and WebGL shaders can be made runnable.
+** Bonus if we can get syntax highlighting for code and if WebGL shaders can be made runnable.
 ==Writing Extensions==
 ===PHP Hooks===
 See [[Mediawikiwiki:Manual:Hooks]]
+====ParserAfterTidy====
+* This is only called for new sections of pages, not necessarily the entire page.
 ===JS Hooks===
 See [https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook mw.hook documentation]