Wiki Help Simplified

From RCGRS MRT Wiki
Revision as of 18:10, 20 May 2023 by DErik (talk | contribs)
Jump to navigation Jump to search

This page is to help me keep track of various Wiki related attributes and capabilities while I learn how this thing works. I am attempting to organize and simplify the wiki help pages.
Constant changes by DErik (talk)
First: A link to my test page: DErik's Test Page (which is redirected to DErik's Test Page Renamed). Then a TOC of what's here:

Links to various Help and Admin type pages.

These are links that may be of particular value or frequently used.

  • Special:AllPages: To get a list of all the pages in this wiki.
  • Special:Upload: Help page for uploading files.
  • Special:ListFiles: To see what's been uploaded.
  • Help:Formatting: For basic explanation of the editing icons at the top of the "edit" or "edit source" page.
  • Help:Images Describes how to put images, full-size or thumbnails, in the page. Includes sizing and positioning. Also captions, but for thumbnails only.
  • Manual:Configuration_settings Provide a one-line description of all the configuration parameters. These parameters are typically placed in the LocalSettings.php file.

See also:

Questions I still have:

  • What are "messages" in a page reference?
  • References to "interface message" in the Manual:Interface/Sidebar. -- Need to research this.

MediaWiki Installation

The first thing you need to be aware of when searching for answers and help here is that this is an "instance" of a MediaWiki site. That is it may have some pages that appear to be MediaWiki pages, but are in fact pages created during the installation of the MediaWiki application that are referenced like MediaWiki pages to support some of the MediaWiki functions and capabilities. Many of these are the "Special" pages, and some of those are generated "on demand", that is you get a brand new version of it every time you ask for it.

Next you need to be aware that each installation of MediaWiki can be configured differently. And that pages in one instance of MediaWiki (which is what this is by the way) can be freely referenced from anywhere, but that the way those pages are displayed, and the information on them, is dependent on the instance of MediaWiki they are associated with. Hence, the display, and content, of some pages may be very different.

This becomes very important in one very important aspect: referencing "help" pages. Wikipedia is another instance of a MediaWiki site. So they are free to configure their site and pages as they see fit, and to create their own pages; and they obviously have done so. Some of those pages are "help" pages. This is fine, but it becomes very annoying and confusing, because MediaWiki itself has taken to referencing some of them. As an example, look at https://en.wikipedia.org/wiki/Help:Contents and https://www.mediawiki.org/wiki/Help:Contents. Both are "Help:Contents" pages, but have very different stuff in them. This becomes important in that the information provided by the "wiki help" pages often applies to a specific "instance" of the MediaWiki installation, rather than to any installation. So when accessing a page, be very certain that you are accessing the correct version of it.

Making Links to MediaWiki Pages

See Link Reference in the Wiki.

The MediaWiki

MediaWiki: This is really the starting point for setting up a MediaWiki. It has links for downloading and installing MediaWiki, initial "Learn how to" pages, and developer help links. These are good links, but not nearly sufficient. They include the following:

  • Help:Navigation: Learn how to navigate
  • Help:Editing_pages: Learn how to edit a page
  • Help:Contents: Learn more about reading, editing, and personal customization
  • Developer hub: From the page itself: "This is a high-level overview of MediaWiki development, including links to the key documents, resources and tools available to MediaWiki developers. It is written for skilled LAMP developers who have experience using MediaWiki."
  • Wikimedia Developer Portal: Not really sure if this is useful.

Help Pages Hierarchy

Help:Contents The main help page. From here you can get to:

Reading

I have to say that I did not find any of these very useful.

  • Navigation: Describes the sidebar (a little bit), some of the tabs at the top, and some of the user links at the top right of the browser page. Does NOT get into putting links in your document.
  • Searching: Mentions the Search box.
  • Tracking changes: Just that you can use some pages to get info on other pages.
  • Watchlist: Reasons for watching things. Click the "watch" button to add it to a list.

Editing

Some of these are a bit more useful.

Advanced Editing

  • https|Help:Images: Fairly good descriiption of how to insert images. Includes examples.
  • Help:Lists: Gives some useful info on how to create and manipulate lists. They are done similar to just including HTML, and in some cases, HTML would be better. But there are options that MediaWiki provides that are not standard in HTML.
  • Help:Tables: Tables are done quite differently in Wiki than in HTML. Better check it out. But using the editor toolbar might be all you need.
  • Help:Categories: Categories are going to be the main way we organize our articles. So making sure you place yours in at least one category is very important. But read the
====== More to come ======

Sandbox

  • API:Main_page provides an overview of the MediaWiki Action API, represented by the api.php endpoint.
  • API:Tutorial is where you can learn to use the Action API.
  • Special:ApiSandbox provides an area where you can experiment with the MediaWiki APIs.

See Also

  1. Wiki Usage and Editing
  2. Link Reference in the Wiki
  3. DErik's TOC Xprmnts
  4. Other articles in the Category:RCGRS Wiki Help