DErik's Test Page Renamed: Difference between revisions
No edit summary |
No edit summary |
||
| Line 162: | Line 162: | ||
|} | |} | ||
---- Note the table ends here. | ---- Note the table ends here. | ||
= 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: | |||
<pre> | |||
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) | |||
</pre> | |||
So,there we go, a simple just plain typed it 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 == | |||
[[File:Create a page.gif]] | |||
Revision as of 19:16, 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> |
#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 <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> |
| <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> | <syntaxhighlight lang=moin>
file label </syntaxhighlight> <translate> Without the leading colon on the "File:" examples, the images would actually be displayed.</translate> <translate> See also <tvar name=1>Template:Ll</tvar>.</translate> <translate>
The <tvar name=1> |
|
| <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.
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 it 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
