DErik's Test Page Renamed: Difference between revisions

From RCGRS MRT Wiki
Jump to navigation Jump to search
Line 163: Line 163:
---- Note the table ends here.
---- Note the table ends here.


= as oppossed to whole copying of... =
Consider using a LINK instead:
A link to how to edit: '''[https://www.mediawiki.org/wiki/Help:Formatting|Help with Formating...]'''
Why duplicate the wheel?  ;-)




Line 176: Line 183:
Let's consider a simple case of information sharing:  "Learning about Foo Bar"; I looked here.  I did this.  The result was that.
Let's consider a simple case of information sharing:  "Learning about Foo Bar"; I looked here.  I did this.  The result was that.


To share this on a RCGRS MediaWIKI page, think HARD about an accurate page name - it's hard to change later, and meaningful in terms of people looking for information about Foo Bar later on.
To share this on a RCGRS MediaWIKI page, '''think HARD about an accurate page name''' - it's hard to change later, and meaningful in terms of people looking for information about Foo Bar later on.


Step One:  On the main page, in the "create page" input box, type a MEANINGFUL page name in and hit "create page".
Step One:  On the main page, in the "'''create page'''" input box, type a MEANINGFUL page name in and hit "'''create page'''".


Okay, now what?  I'm looking at an empty box and no clue how to proceed.
Okay, now what?  I'm looking at an empty box and no clue how to proceed.


Just start typing in the box.  The default "edit" mode uses a WYSIWYG editor, just type away for now and what you see is how it will look on the web page.
'''''Just start typing''''' in the box.  The default "'''edit'''" mode uses a WYSIWYG editor, just type away for now and what you see is how it will look on the web page.


Lets talk about the Foo Bar example; I looked here.  I did this.  The result was that.  In the empty box, we type this:
Lets talk about the Foo Bar example; I looked here.  I did this.  The result was that.  In the empty box, we type this:

Revision as of 19:33, 3 April 2023

This is a test page for DErik.

ĤêĂÄ crazy special chars for fun..😃😝


This is another test on a page that is just for that, testing. I'm using the WYSIWYG editor to just type stuff in...

  • Bullet, lust like it would be
    • tab to get a second indent..


A link? Amazone bold...


BIG..


th8is is a n edit by eric

In the main body, I changed five things.

  • FileUpload to true
  • from: address for password requests (RCGRS_Wiki_Admins@rcgrs.com)
  • from: address for emegency contacts (RCGRS_Wiki_Admins@rcgrs.com)
  • mail when updated (this is why we didn’t get mail earilier in out test!)
  • mail when talk updated (another feature to test..)


Section headings with anchor

<div id="Unique anchor name 1">optional text</div>

<span id="Unique anchor name 2">optional text</span>

Rendered block-level and inline, respectively. Doing this would allow for [[#Unique anchor name 1]] on the same page or [[Help:Links#Unique anchor name 1]] on a different page. Omit the "optional text" for an invisible anchor.

Setting an anchor in a section heading

==<span id="Alternate Section Title"></span>Section heading==

Note the placement. This must be a "span" tag, not a "div". (Such anchors allow sections to be retitled without breaking incoming links.)

optional text optional text

Section heading


The following was copied from the Help:Links help page. Not sure why the <translate> and other tags are here. They don't show up on the Help:Links page as they get interpreted by the MediaWiki, I assume to do language translation for <translate>, but what <tvar> is for I have no idea. I think <syntaxhighlight> should also be recognized to highlight various [computer programming] languages. We may need to include some extension to get these to be properly recognized.

<translate> Name</translate>/<translate> Description</translate> <translate> Syntax</translate> <translate> Result</translate>
<translate> Link to an anchor on the same page</translate> <syntaxhighlight lang="moin">#See also</syntaxhighlight>

<translate> Anchors are provided automatically on [[<tvar name=formatting>Special:MyLanguage/Help:Formatting</tvar>|section headings]] and to the [[<tvar name=1>#top</tvar>|top]] (<tvar name=2>[[#top]]</tvar>) of the page.</translate>

#See also
<translate> Setting an anchor for incoming links</translate> <syntaxhighlight lang=html>
optional text

optional text </syntaxhighlight>

<translate> Rendered block-level and inline, respectively.</translate> <translate> Doing this would allow for [[#Unique anchor name 1]] on the same page or [[DErik's Test Page Renamed#Unique anchor name 1]] on a different page.</translate> <translate> Omit the "optional text" for an invisible anchor.</translate>

<translate> Setting an anchor in a section heading </translate>

<syntaxhighlight lang=html>

Section heading

</syntaxhighlight>

<translate> Note the placement.</translate> <translate> This must be a "span" tag, not a "div".</translate> <translate> (Such anchors allow sections to be retitled without breaking incoming links.)</translate>

<div id="<translate nowrap> Unique anchor name 1</translate>"><translate> optional text</translate>

<span id="<translate nowrap> Unique anchor name 2</translate>"><translate> optional text</translate>

Section heading
<translate> Link to an anchor at another page</translate> <syntaxhighlight lang=moin>Help:Images#Supported media types for images</syntaxhighlight> Help:Images#Supported media types for images
<translate> Link to the current page's talk page</translate> <syntaxhighlight lang=moin>Discussion</syntaxhighlight>

<translate> See also [[<tvar name=page-names>Special:MyLanguage/Help:Magic_words#Page_names</tvar>|Help:Magic words#Page names]]</translate>

Discussion
Template:Anchor<translate> Link to a subpage</translate> <syntaxhighlight lang=moin>/example</syntaxhighlight>

<translate> Shortcut for <tvar name=1><syntaxhighlight lang="moin" inline>/example</syntaxhighlight></tvar>.</translate> <translate> See also <tvar name=1>Template:Ll</tvar>.</translate>

/example
<translate> Link to a subpage without the leading slash</translate> <syntaxhighlight lang=moin>/example/</syntaxhighlight>

<translate> Shortcut for <tvar name=1><syntaxhighlight lang="moin" inline>example</syntaxhighlight></tvar>.</translate>

example
<translate> Link to a subpage of parent page for current page.</translate> <translate> Can only be used on subpages.</translate> <syntaxhighlight lang=moin>[[../example2]]</syntaxhighlight>

<translate> Shortcut for <tvar name=1><syntaxhighlight lang="moin" inline>example2</syntaxhighlight></tvar> if you post the link on <tvar name=2><syntaxhighlight lang="moin" inline>example</syntaxhighlight></tvar> page.</translate>

example2
<translate> Visible link to a category page</translate> <syntaxhighlight lang=moin>Category:Help</syntaxhighlight>

<translate> Without the leading colon the link would not be visible and the page would instead be placed into the category; this is a very common mistake.</translate> <translate> See also <tvar name=1>Template:Ll</tvar>.</translate>

Category:Help
<translate> Visible link to an image or media file</translate>

File:Example.jpg

file label

Media:Example.jpg

file label


<translate> Mailto link</translate>
[mailto:info@example.org email me]
email me
<translate> Mailto named with subject line and body</translate>
[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
info

Note the table ends here.


as oppossed to whole copying of...

Consider using a LINK instead: A link to how to edit: with Formating...

Why duplicate the wheel?  ;-)


some thoughts on philosophy

Some thoughts on MediaWIKI philosophy: Things to consider as you seek to use this tool.

Think about what you are documenting and how to best present that information. A series of textual instructions? A diagram of some sort? Simply a reference to another document or, say, an external URL (other website, in other words.)

What you want to share informs you on the correct work flow to make it all happen.

I quite often approach the issue similar to creating college notes Prominent sections, some paragraphs of stuff, lots of bullet notes. Perhaps a diagram in there someplace.

Let's consider a simple case of information sharing: "Learning about Foo Bar"; I looked here. I did this. The result was that.

To share this on a RCGRS MediaWIKI page, think HARD about an accurate page name - it's hard to change later, and meaningful in terms of people looking for information about Foo Bar later on.

Step One: On the main page, in the "create page" input box, type a MEANINGFUL page name in and hit "create page".

Okay, now what? I'm looking at an empty box and no clue how to proceed.

Just start typing in the box. The default "edit" mode uses a WYSIWYG editor, just type away for now and what you see is how it will look on the web page.

Lets talk about the Foo Bar example; I looked here. I did this. The result was that. In the empty box, we type this:

section one, I looked here
on the subject of foo bar, I looked for resources all over the place, and of course google.com provided some help.  One link I found was https://en.wiktionary.org/wiki/foobar and was very interesting details on the origin of foobar

section two, I did this
In order to do my own foobar, what I was take the following steps..   Some of the steps were multi-part.
List of steps
step one was to type the letter F
step two was typing the letter O
step three was to  type the letter O again
could we skip this step and just make the step before a U?
step four was to type a B
step five was to type an A
The sixth and final step was to type an R

section three, the result I got
When things FINALLY actually went all FOOBAR, well, let me show you.  (the intent is a photo here)

So,there we go, a simple just plain typed in outline of the information you want to share. This IS the actual lions share of the work. But it does look a little plain and hard to decipher, just some raw text.. Now what?

NOW, we highlight the text of interest and start clicking format buttons..

Example one: Sections

Highlight the text then change the "paragraph" button to "HEADING 2"

Highlight the list of steps and click on the "list" icon, and choose bullet list.

Place the cursor at the beginning of "step one" and tab. The beginning of step two, tab.

And so on. You get the drift, right?

Add a photo

Now, we want to add a photo.. Place the cursor near where we typed "the intent is a photo here". Click "upload". Answer a bunch of questions about how big, were on the page, caption, etc..

I don't like "Center", so I'm gonna go left... Click "edit"

Now we have a photo.

Save your work!

Click on the "Save Page.." button and if you want, makes some notes about this editing session. It's TOTALLY COMMON to create pages a piece at a time, and as part of a team with other users!

summary

You did it - you now have produced a page about foobar..

editing after the fact

HEY.. That URL I shared in the vary first section, what happened to that, anyway? It's just text, I can't click on it!

re-edit

Click the "Edit" tab. Hightlight the URL. Click on the "chain" icon that denotes you want to create link - both INTERNAL, ie; other wiki pages by their name, or an external URL like we all use everyday on the internet.

Using the same method, I added a HEADER 1 section heading at the top, then a "summary" section at the bottom. This triggered the "minimum" number of levels, and NOW, you get a table of contents at the top!! All auto generated without any work on your part. Skip straight to your interest...GIG

A visual aid to the process