Editing the wiki - Revision history

Marynia at 09:46, 29 January 2025

2025-01-29T09:46:50Z

← Older revision		Revision as of 11:46, 29 January 2025
Line 64:		Line 64:
	We're so used to hierarchical-folders-and-files that organizing information in any other way can take a bit of getting used to! Here you can think of there being "one folder" for all pages, which you can look at in [[Special:AllPages]]. In order to help people find their way between pages, wikilinks are the primary tool of choice. (There are ''many'' other special, automatically-generated pages in [[Special:SpecialPages]] which can assist the interlinking of pages: for example, [[Special:LonelyPages]] lists all pages which no other pages links to.)		We're so used to hierarchical-folders-and-files that organizing information in any other way can take a bit of getting used to! Here you can think of there being "one folder" for all pages, which you can look at in [[Special:AllPages]]. In order to help people find their way between pages, wikilinks are the primary tool of choice. (There are ''many'' other special, automatically-generated pages in [[Special:SpecialPages]] which can assist the interlinking of pages: for example, [[Special:LonelyPages]] lists all pages which no other pages links to.)
	[[Category:Meta]]		[[Category:Meta]]
			[[Category:Digital]]

Doug: update

2024-10-20T19:49:04Z

update

← Older revision		Revision as of 21:49, 20 October 2024
Line 1:		Line 1:
			You're welcome to go ahead without reading this page: most of the core features should be accessible without instruction. Have fun & don't lose motivation!
	[[File:Scribe at writing desk Escribano .jpeg\|thumb\|It could be worse!]]		[[File:Scribe at writing desk Escribano .jpeg\|thumb\|It could be worse!]]
	~~You're welcome to go ahead without reading this page: most of the core features should be accessible without instruction. Have fun & don't lose motivation!~~

	==Account==		==Account==
	First make an '''[https://pommel.uber.space/w/index.php?title=Special:CreateAccount&returnto=Getting+started account]'''.		First make an '''[https://pommel.uber.space/w/index.php?title=Special:CreateAccount&returnto=Getting+started account]'''. If you have a [[Nextcloud]] account, you can just click on ''"Sign in with Nextcloud"'' instead.

	(We could make the wiki editable to people without an account, but that reveals IP ~~addresses. Single sign-on would be nice though~~.)		(We could make the wiki editable to people without an account, but that reveals the editor's IP address by default.)

	==Basic editing==		==Basic editing==
	Edit pages by clicking on the <code>Edit</code> tab or pencil icon, depending on whether you're on desktop or mobile. This will open the visual editor ~~by default, it takes a second or two to load~~. Once it has, simply start typing, taking notice of the option top bar at the top.		Edit pages by clicking on the <code>Edit</code> tab or pencil icon, depending on whether you're on desktop or mobile. This will open the visual editor. Once it has loaded, simply start typing, taking notice of the option top bar at the top.

	Use appropriate '''headings''' to organize page content, starting with <code>heading</code> and going subsequently down the sub-headings if necessary.		Use appropriate '''headings''' to organize page content, starting with <code>heading</code> and going subsequently down the sub-headings as necessary.

	We got all the '''formats''', not just bold: ''italic'', <sup>superscript,</sup> <code>code,</code> <sub>subscript,</sub> <s>strikethrough,</s> <u>underline,</u> <big>big</big> and <small>small.</small>		We got all the '''formats''', not just bold: ''italic'', <sup>superscript,</sup> <code>code,</code> <sub>subscript,</sub> <s>strikethrough,</s> <u>underline,</u> <big>big</big> and <small>small.</small>
Line 23:		Line 23:

	==Inserting stuff==		==Inserting stuff==
	The editor top bar has an <code>Insert</code> tab for various things.		The editor top bar has an <code>Insert</code> tab for various things. Inserting '''images and media''' proceeds through the graphical interface. Uploading can be done through the interface, or at any point using [[Special:Upload]].
	Inserting '''images and media''' proceeds through the graphical interface. Uploading can be done through the interface, or at any point using [[Special:Upload]].
	*'''Note:''' due to a [https://phabricator.wikimedia.org/T188236 quirk] in how media search works, it is strongly recommended to name things using whole words with spaces in between! E.g. <code>idealized dishwasher stacking diagram .svg</code> ''not'' <code>idealDwStackDia.svg</code>!		*'''Note:''' due to a [https://phabricator.wikimedia.org/T188236 quirk] in how media search works, it is strongly recommended to name things using whole words with spaces in between! E.g. <code>idealized dishwasher stacking diagram .svg</code> ''not'' <code>idealDwStackDia.svg</code>!
	*Wikimedia Commons has loads of images without any [https://commons.wikimedia.org/w/index.php?search=&title=Special:MediaSearch&go=Go&type=image&haslicense=unrestricted legal restrictions].		*Wikimedia Commons has loads of images without any [https://commons.wikimedia.org/w/index.php?search=&title=Special:MediaSearch&go=Go&type=image&haslicense=unrestricted legal restrictions].
Line 50:		Line 49:
	\|'''yes'''		\|'''yes'''
	\|}		\|}
	~~'''Mermaid diagrams''' are enabled. These are 'coded' diagrams, you need to switch to the source editor and read some [https://mermaid.js.org/syntax/flowchart.html docs].~~
	~~{{#mermaid:flowchart TD;~~
	~~A[chicken]==>B(Egg);~~
	~~A-->C[[subroutine]];~~
	~~B-- special relation -->D((circle));~~
	~~C-->D;~~
	~~click A "https://sandbox.semantic-mediawiki.org/wiki/A"~~
	~~click B "https://sandbox.semantic-mediawiki.org/wiki/B"~~
	~~click C "https://sandbox.semantic-mediawiki.org/wiki/C"~~
	~~click D "https://sandbox.semantic-mediawiki.org/wiki/D"~~
	~~style A fill:lightblue,stroke-width:1rem~~
	}}

	==Creating pages==		==Creating pages==
	There is an intentional barrier to creating a page in order to prevent duplication. The easiest way to create a new page is to search for it: if it doesn't exist, you will see an option to create it. You can also access the create page dialogue by requesting the URL of the new page, e.g.: <code><nowiki>https://~~pommel~~.~~uber~~.~~space~~/wiki/new_page</nowiki></code>		There is an intentional barrier to creating a page in order to prevent duplication. The easiest way to create a new page is to search for it: if it doesn't exist, you will see an option to create it. You can also access the create page dialogue by requesting the URL of the new page, e.g.: <code><nowiki>https://wiki.kanthaus.online/wiki/new_page</nowiki></code>

	Deleting a page currently requires Admin rights.		Deleting a page currently requires Admin rights.
Line 72:		Line 58:

	*<code>Options</code> or <code>Categories</code> allows you to add categories to a page, which you can think of as (hash)tags: each category has an automatically generated page that lists all the pages tagged with that category, for example [[:Category:Rooms\|Category:Rooms.]]		*<code>Options</code> or <code>Categories</code> allows you to add categories to a page, which you can think of as (hash)tags: each category has an automatically generated page that lists all the pages tagged with that category, for example [[:Category:Rooms\|Category:Rooms.]]
	*<code>Page settings</code> allows you to redirect the current page to another page. This can be useful when you have different names for the same thing. For example, [[~~K20-1-4~~]] redirects to [[~~Office~~]]		*<code>Page settings</code> allows you to redirect the current page to another page. This can be useful when you have different names for the same thing. For example, [[Dumpster kitchen]] redirects to [[Washing room]]
	**a redirect is automatically created when you 'move' a page. 'Moving' a page is more easily thought of as renaming it.		**a redirect is automatically created when you 'move' a page. 'Moving' a page is more easily thought of as renaming it.

	==Wiki-think==		==Wiki-think==
	We're so used to hierarchical-folders-and-files that organizing information in any other way can take a bit of getting used to! Here you can think of there being "one folder" for all pages, which you can look at in [[Special:AllPages]]. In order to help people find their way between pages, wikilinks are the primary tool of choice. (There are ''many'' other special, automatically-generated pages in [[Special:SpecialPages]] which can assist the interlinking of pages: for example, [[Special:LonelyPages]] lists all pages which no other pages links to.)		We're so used to hierarchical-folders-and-files that organizing information in any other way can take a bit of getting used to! Here you can think of there being "one folder" for all pages, which you can look at in [[Special:AllPages]]. In order to help people find their way between pages, wikilinks are the primary tool of choice. (There are ''many'' other special, automatically-generated pages in [[Special:SpecialPages]] which can assist the interlinking of pages: for example, [[Special:LonelyPages]] lists all pages which no other pages links to.)

	~~==Private pages==~~
	Wikipedia was made for total transparency: MediaWiki is ''not'' meant for storing sensitive data. Really, they are [[mediawikiwiki:Security_issues_with_authorization_extensions\|quite clear]] on that point. However, there are a bunch of extensions, one of the most popular called <code>Lockdown</code>. Since it's good enough for [https://wiki.dezentrale.space/Special:Version Dezentrale], it should be good enough for us. Note that '''"uploaded ''files'' (images, files, docs... ) will always remain readable via direct access by default'''.'''"'''<sup>[<nowiki/>[[mediawikiwiki:Manual:User_rights#List_of_permissions\|source]]]</sup>

	~~With that warning in place, the way to make private pages is to prefix <code>Private:</code> to the page you're creating. E.g.: <code>Private:DeathStar_Blueprints</code>~~
	[[Category:Meta]]		[[Category:Meta]]

Doug: Migration from testing wiki (Getting started)

2024-10-20T19:40:55Z

Migration from testing wiki (Getting started)

New page

[[File:Scribe at writing desk Escribano .jpeg|thumb|It could be worse!]]
You're welcome to go ahead without reading this page: most of the core features should be accessible without instruction. Have fun & don't lose motivation!

==Account==
First make an '''[https://pommel.uber.space/w/index.php?title=Special:CreateAccount&returnto=Getting+started account]'''.

(We could make the wiki editable to people without an account, but that reveals IP addresses. Single sign-on would be nice though.)

==Basic editing==
Edit pages by clicking on the <code>Edit</code> tab or pencil icon, depending on whether you're on desktop or mobile. This will open the visual editor by default, it takes a second or two to load. Once it has, simply start typing, taking notice of the option top bar at the top.

Use appropriate '''headings''' to organize page content, starting with <code>heading</code> and going subsequently down the sub-headings if necessary.

We got all the '''formats''', not just bold: ''italic'', superscript, <code>code,</code> subscript, <s>strikethrough,</s> underline, <big>big</big> and small.

'''Links.''' Wikis live from internal links, so-called '''wikilinks''', so make sure to add them liberally to help people get where they want to go. Whether wikilink or external link, the process is the same: click the link icon, or <code>ctrl + k</code> or type<code>[[</code> to get a pop-up search for other pages to link to.

'''Lists'''

*create in top bar
**or type <code>*</code> on new line to start an unordered list
**or type <code>1.</code> on new line to start an ordered list

==Inserting stuff==
The editor top bar has an <code>Insert</code> tab for various things.
Inserting '''images and media''' proceeds through the graphical interface. Uploading can be done through the interface, or at any point using [[Special:Upload]].
*'''Note:''' due to a [https://phabricator.wikimedia.org/T188236 quirk] in how media search works, it is strongly recommended to name things using whole words with spaces in between! E.g. <code>idealized dishwasher stacking diagram .svg</code> ''not'' <code>idealDwStackDia.svg</code>!
*Wikimedia Commons has loads of images without any [https://commons.wikimedia.org/w/index.php?search=&title=Special:MediaSearch&go=Go&type=image&haslicense=unrestricted legal restrictions].
To insert '''templates''', click the respective insert button, or type <code><nowiki>{{</nowiki></code> to get a pop-up search and selecting one. For now there is only [[Template:Warning]]{{Warning|Only one template right now!}}
{| class="wikitable sortable"
|+Insert tables too :)
!
!pad
!website
!wiki
|-
|easy to edit
|'''yes'''
|no
|'''yes'''
|-
|easy to find stuff
|no
|'''yes'''
|'''yes'''
|-
|4 letters long
|no
|no
|'''yes'''
|}
'''Mermaid diagrams''' are enabled. These are 'coded' diagrams, you need to switch to the source editor and read some [https://mermaid.js.org/syntax/flowchart.html docs].
{{#mermaid:flowchart TD;
A[chicken]==>B(Egg);
A-->C[[subroutine]];
B-- special relation -->D((circle));
C-->D;
click A "https://sandbox.semantic-mediawiki.org/wiki/A"
click B "https://sandbox.semantic-mediawiki.org/wiki/B"
click C "https://sandbox.semantic-mediawiki.org/wiki/C"
click D "https://sandbox.semantic-mediawiki.org/wiki/D"
style A fill:lightblue,stroke-width:1rem
}}

==Creating pages==
There is an intentional barrier to creating a page in order to prevent duplication. The easiest way to create a new page is to search for it: if it doesn't exist, you will see an option to create it. You can also access the create page dialogue by requesting the URL of the new page, e.g.: <code><nowiki>https://pommel.uber.space/wiki/new_page</nowiki></code>

Deleting a page currently requires Admin rights.

==Advanced options==
Clicking on the hamburger menu <code>☰</code> in the top bar show advanced options:

*<code>Options</code> or <code>Categories</code> allows you to add categories to a page, which you can think of as (hash)tags: each category has an automatically generated page that lists all the pages tagged with that category, for example [[:Category:Rooms|Category:Rooms.]]
*<code>Page settings</code> allows you to redirect the current page to another page. This can be useful when you have different names for the same thing. For example, [[K20-1-4]] redirects to [[Office]]
**a redirect is automatically created when you 'move' a page. 'Moving' a page is more easily thought of as renaming it.

==Wiki-think==
We're so used to hierarchical-folders-and-files that organizing information in any other way can take a bit of getting used to! Here you can think of there being "one folder" for all pages, which you can look at in [[Special:AllPages]]. In order to help people find their way between pages, wikilinks are the primary tool of choice. (There are ''many'' other special, automatically-generated pages in [[Special:SpecialPages]] which can assist the interlinking of pages: for example, [[Special:LonelyPages]] lists all pages which no other pages links to.)

==Private pages==
Wikipedia was made for total transparency: MediaWiki is ''not'' meant for storing sensitive data. Really, they are [[mediawikiwiki:Security_issues_with_authorization_extensions|quite clear]] on that point. However, there are a bunch of extensions, one of the most popular called <code>Lockdown</code>. Since it's good enough for [https://wiki.dezentrale.space/Special:Version Dezentrale], it should be good enough for us. Note that '''"uploaded ''files'' (images, files, docs... ) will always remain readable via direct access by default'''.'''"'''[<nowiki/>[[mediawikiwiki:Manual:User_rights#List_of_permissions|source]]]

With that warning in place, the way to make private pages is to prefix <code>Private:</code> to the page you're creating. E.g.: <code>Private:DeathStar_Blueprints</code>
[[Category:Meta]]