XiphInfra:Wiki VM - Revision history

EPirat: /* Add Wiki Account */

2026-01-17T04:31:00Z

Add Wiki Account

← Older revision		Revision as of 04:31, 17 January 2026
Line 15:		Line 15:

	== Add Wiki Account ==		== Add Wiki Account ==
	<div style="background-color: #~~B4CFEC~~; padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is disabled due to massive amounts of spam. Therefore, until we find a solution for this, Users are asked to go to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>		<div style="background-color: var(--background-color-warning-subtle,#fdf2d5);
			border-color: var(--border-color-warning,#ab7f2a); color: var(--color-base,#202122); padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is disabled due to massive amounts of spam. Therefore, until we find a solution for this, Users are asked to go to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>

	Below is an excerpt from the MediaWiki Page, describing how to create an Account:		Below is an excerpt from the MediaWiki Page, describing how to create an Account:

EPirat: /* Add Wiki Account */

2021-02-26T23:46:13Z

Add Wiki Account

← Older revision		Revision as of 23:46, 26 February 2021
Line 19:		Line 19:
	Below is an excerpt from the MediaWiki Page, describing how to create an Account:		Below is an excerpt from the MediaWiki Page, describing how to create an Account:

	# Go to {{Special:UserLogin}}, when logged in as a sysop.		# Go to {{Special:UserLogin}}, when logged in as a [[Special:ListUsers/sysop\|sysop]].
	# Click on "Create an account" link to get to the account creation form.		# Click on "Create an account" link to get to the account creation form.
	# Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.		# Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.

MrZeus at 16:01, 25 January 2016

2016-01-25T16:01:06Z

← Older revision		Revision as of 16:01, 25 January 2016
Line 21:		Line 21:
	# Go to {{Special:UserLogin}}, when logged in as a sysop.		# Go to {{Special:UserLogin}}, when logged in as a sysop.
	# Click on "Create an account" link to get to the account creation form.		# Click on "Create an account" link to get to the account creation form.
	# Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.		# Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.
	# The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; when he does this, his e-mail address will also be marked as confirmed.		# The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; when he does this, his e-mail address will also be marked as confirmed.
	#:<small>When you click the "create account" button instead, you have to manually send the user his password. If you've set <code>$wgMinimalPasswordLength</code> and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access {{Special:Confirmemail}} to perform the confirmation. Instead, the user will get an error (unless you've added it to <code>$wgWhitelistRead</code>); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).</small>		#:<small>When you click the "create account" button instead, you have to manually send the user his password. If you've set <code>$wgMinimalPasswordLength</code> and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access {{Special:Confirmemail}} to perform the confirmation. Instead, the user will get an error (unless you've added it to <code>$wgWhitelistRead</code>); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).</small>
Line 148:		Line 148:
	npm cache clear		npm cache clear
	npm install		npm install


	=== SyntaxHighlight (GeSHi) ===		=== SyntaxHighlight (GeSHi) ===

MrZeus: tiny typo and grammar fixes

2016-01-25T15:48:34Z

tiny typo and grammar fixes

← Older revision		Revision as of 15:48, 25 January 2016
Line 7:		Line 7:
	\|url=https://wiki.xiph.org}}		\|url=https://wiki.xiph.org}}

	As the name ~~suggest~~, the Wiki VM runs this [http://mediawiki.org MediaWiki] instance.		As the name suggests, the Wiki VM runs this [http://mediawiki.org MediaWiki] instance.

	It runs an Apache2 server with PHP module~~, in~~ front of it is a reverse proxy (nginx) running on Catfish. If you need to add		It runs an Apache2 server with a PHP module. In front of it is a reverse proxy (nginx) running on Catfish.
	or adjust things like headers and the HTTPS redirect, check the nginx config on Catfish, not the Apache2 config.		If you need to add or adjust things like headers and the HTTPS redirect, check the nginx config on Catfish, not the Apache2 config.

	The current version of MediaWiki and the installed Modules can be found [[Special:Version\|here]].		The current version of MediaWiki and the installed Modules can be found [[Special:Version\|here]].

	== Add Wiki Account ==		== Add Wiki Account ==
	<div style="background-color: #B4CFEC; padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is ~~disable~~ due to massive spam. Therefore until we find a solution for this, Users are asked to go to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>		<div style="background-color: #B4CFEC; padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is disabled due to massive amounts of spam. Therefore, until we find a solution for this, Users are asked to go to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>

	Below is an excerpt from the MediaWiki Page, describing how to create an Account:		Below is an excerpt from the MediaWiki Page, describing how to create an Account:

	#Go to {{Special:UserLogin}}, when logged in as a sysop.		# Go to {{Special:UserLogin}}, when logged in as a sysop.
	#Click on "Create an account" link to get to the account creation form.		# Click on "Create an account" link to get to the account creation form.
	#Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.		# Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.
	#The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; when he does this, his e-mail address will also be marked as confirmed.		# The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; when he does this, his e-mail address will also be marked as confirmed.
	#:<small>When you click the "create account" button instead, you have to manually send the user his password. If you've set <code>$wgMinimalPasswordLength</code> and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access {{Special:Confirmemail}} to perform the confirmation. Instead, the user will get an error (unless you've added it to <code>$wgWhitelistRead</code>); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).</small>		#:<small>When you click the "create account" button instead, you have to manually send the user his password. If you've set <code>$wgMinimalPasswordLength</code> and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access {{Special:Confirmemail}} to perform the confirmation. Instead, the user will get an error (unless you've added it to <code>$wgWhitelistRead</code>); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).</small>

Line 29:		Line 29:

	=== Math and Mathoid ===		=== Math and Mathoid ===
	The [https://www.mediawiki.org/wiki/Extension:Math Math] module allows us to use equations similar ~~as in~~ LaTeX:		The [https://www.mediawiki.org/wiki/Extension:Math Math] module allows us to use equations similar to LaTeX:

	<code><nowiki><math>E=mc^2</math></nowiki></code> will display as <math>E=mc^2</math>		<code><nowiki><math>E=mc^2</math></nowiki></code> will display as <math>E=mc^2</math>
Line 50:		Line 50:
	More information about the config can be found on the [https://www.mediawiki.org/wiki/Extension:Math/advancedSettings Math/advancedSettings] page.		More information about the config can be found on the [https://www.mediawiki.org/wiki/Extension:Math/advancedSettings Math/advancedSettings] page.

	Once the Math extension is ~~configure, as mentioned~~, it needs Mathoid to render MathML and SVGs. It's a bit tricky to install		Once the Math extension is configured, it needs Mathoid to render MathML and SVGs.
	~~therefore below is~~ a short guide ~~how to do so~~:		It's a bit tricky to install so have a look at the short guide below:

	==== Fetch the source code ====		==== Fetch the source code ====
Line 71:		Line 71:

	==== Install dependencies ====		==== Install dependencies ====
	Inside the mathoid folder do:		Inside the mathoid folder, run:

	npm install		npm install

	==== Change config ====		==== Change config ====
	Remove the default config symlink and ~~crate~~ one for the prod config:		Remove the default config symlink and create one for the prod config:

	rm config.yaml		rm config.yaml
	ln -s config.prod.yaml config.yaml		ln -s config.prod.yaml config.yaml

	Adjust the config accordingly~~, currently~~ the config looks ~~similar to~~:		Adjust the config accordingly. Currently the config looks like this:

	<syntaxhighlight lang="yaml">		<syntaxhighlight lang="yaml">
Line 126:		Line 126:
	npm start		npm start

	If it ~~start~~ successfully, go to a Wiki Page, edit it ~~and~~ add a simple equation and preview the page.		If it starts successfully, go to a Wiki Page, edit it, add a simple equation and preview the page.
	(Make sure to use a unique equation, as caching could prevent ~~that~~ Mathoid is used~~, if the equation already exists~~.)		(Make sure to use a unique equation, as caching could prevent Mathoid from being used.)

	If everything works as expected, write a systemd unit or such and start Mathoid with it, for production use.		If everything works as expected, write a systemd unit or such and start Mathoid with it, for production use.
Line 139:		Line 139:
	If you get errors like <code>spawn java ENOENT</code> make sure you have set		If you get errors like <code>spawn java ENOENT</code> make sure you have set
	img: false		img: false
	in your config, ~~as else~~ it will try to use [http://xmlgraphics.apache.org/batik/download.html Apache™ Batik], which requires Java. I guess not having PNGs is a fair tradeoff, if that saves us from having to use ~~java~~ on the VM.		in your config, otherwise it will try to use [http://xmlgraphics.apache.org/batik/download.html Apache™ Batik], which requires Java.
			I guess not having PNGs is a fair tradeoff, if that saves us from having to use Java on the VM.

	If there are problems while installing dependencies, make sure your nodejs version is recent enough, try ~~to remove the~~ modules and ~~reinstall~~ them:		If there are problems while installing dependencies, make sure your nodejs version is recent enough.
			You can try removing its modules and reinstalling them:

	rm -rf ./node_modules		rm -rf ./node_modules
Line 161:		Line 163:
	</syntaxhighlight>		</syntaxhighlight>

	Luckily, this one is much easier to install. It does not, contrary to what the name ~~suggest,~~ depend on GeSHi anymore, but		Luckily, this one is much easier to install.
	has switched to [http://pygments.org Pygments], so make sure that is installed. That's it. (Phew, much easier compared to Mathoid)		It does not (contrary to what the name suggests) depend on GeSHi anymore,
			but has switched to [http://pygments.org Pygments], so make sure that is installed.

			That's it! (Phew, much easier compared to Mathoid...)

Martin.leese: /* Add Wiki Account */ Typo

2016-01-23T19:08:58Z

Add Wiki Account: Typo

← Older revision		Revision as of 19:08, 23 January 2016
Line 15:		Line 15:

	== Add Wiki Account ==		== Add Wiki Account ==
	<div style="background-color: #B4CFEC; padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is disable due to massive spam. Therefore until we find a solution for this, Users are asked to ~~got~~ to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>		<div style="background-color: #B4CFEC; padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is disable due to massive spam. Therefore until we find a solution for this, Users are asked to go to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>

	Below is an excerpt from the MediaWiki Page, describing how to create an Account:		Below is an excerpt from the MediaWiki Page, describing how to create an Account:

EPirat: /* Add Wiki Account */

2016-01-23T00:53:23Z

Add Wiki Account

← Older revision		Revision as of 00:53, 23 January 2016
Line 19:		Line 19:
	Below is an excerpt from the MediaWiki Page, describing how to create an Account:		Below is an excerpt from the MediaWiki Page, describing how to create an Account:

	#Go to {{Special:~~Userlogin~~}}, when logged in as a sysop.		#Go to {{Special:UserLogin}}, when logged in as a sysop.
	#Click on "Create an account" link to get to the account creation form.		#Click on "Create an account" link to get to the account creation form.
	#Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.		#Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.

EPirat: /* Add Wiki Account */

2016-01-22T16:55:02Z

Add Wiki Account

← Older revision		Revision as of 16:55, 22 January 2016
Line 15:		Line 15:

	== Add Wiki Account ==		== Add Wiki Account ==
	Currently, account creation on the Wiki is disable due to massive spam. Therefore until we find a solution for this,		<div style="background-color: #B4CFEC; padding: 5px; border: 1px #888 solid;">Currently, account creation on the Wiki is disable due to massive spam. Therefore until we find a solution for this, Users are asked to got to the #xiph IRC channel and ask for an account there, which a wiki sysop has to create.</div>
	Users are asked to got to the #xiph IRC ~~Channel~~ and ask for an account there, which a ~~Wiki~~ sysop has to create.
	Below is an excerpt from the MediaWiki Page, describing how to create an Account:		Below is an excerpt from the MediaWiki Page, describing how to create an Account:

EPirat at 16:51, 22 January 2016

2016-01-22T16:51:06Z

← Older revision		Revision as of 16:51, 22 January 2016
Line 14:		Line 14:
	The current version of MediaWiki and the installed Modules can be found [[Special:Version\|here]].		The current version of MediaWiki and the installed Modules can be found [[Special:Version\|here]].

			== Add Wiki Account ==
			Currently, account creation on the Wiki is disable due to massive spam. Therefore until we find a solution for this,
			Users are asked to got to the #xiph IRC Channel and ask for an account there, which a Wiki sysop has to create.
			Below is an excerpt from the MediaWiki Page, describing how to create an Account:

			#Go to {{Special:Userlogin}}, when logged in as a sysop.
			#Click on "Create an account" link to get to the account creation form.
			#Enter a username and an email address, and click the "by email" button. Note you need <code>$wgEnableEmail=true</code> or else the sysop must pick a password and send it to the user.
			#The account will be created with a random password which is then emailed to the given address (as with the "forgot password" feature). The user will be requested to change password at first login; when he does this, his e-mail address will also be marked as confirmed.
			#:<small>When you click the "create account" button instead, you have to manually send the user his password. If you've set <code>$wgMinimalPasswordLength</code> and you've left the password field blank, the user will be emailed an e-mail address confirmation request but will be unable to access {{Special:Confirmemail}} to perform the confirmation. Instead, the user will get an error (unless you've added it to <code>$wgWhitelistRead</code>); the user will be able to login with a blank password and then confirm email, but their password will not have been reset (it will have to be reset manually).</small>

	== Important Modules ==		== Important Modules ==

EPirat: /* Math and Mathoid */

2016-01-20T23:10:42Z

Math and Mathoid

@@ Line 120: / Line 120: @@
 If everything works as expected, write a systemd unit or such and start Mathoid with it, for production use.
 Maybe useful for debugging, you can use curl to make a request to Mathoid like this:
-  curl -d 'q=E=fobarmc^2' http://127.0.0.1:10042/
+ curl -d 'q=E=fobarmc^2' http://127.0.0.1:10042/

EPirat: /* Important Modules */

2016-01-20T22:57:23Z

Important Modules

← Older revision		Revision as of 22:57, 20 January 2016
Line 18:		Line 18:
	These are the most important modules that we have in use:		These are the most important modules that we have in use:

	=== Math ===		=== Math and Mathoid ===
	The [https://www.mediawiki.org/wiki/Extension:Math Math] module allows us to use equations similar as in LaTeX:		The [https://www.mediawiki.org/wiki/Extension:Math Math] module allows us to use equations similar as in LaTeX: