Jump to content

Steve's Wikitext editing introduction: Difference between revisions

From Wikidelphia
 
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is '''[[user:Shollingsworth|Steve's]] editing introduction'''.
This is '''[[User:Shollingsworth|Steve's]] Wikitext editing introduction''' (an extension of [[editing]]). It was written in 2011 and hasn't been updated. For something a lot more recent, see [[PaulSank's Step-By-Step Guide to Wikidelphia Editing]].


This is not a complete introduction, for two reasons.  First, I just want to get you enough information that you can start editing '''now'''.  Second, some features we need aren't enabled yet.
Some features we'd like (such as References) aren't enabled yet.  


This is ALL very easy -- and it will get a LOT more easy when the GUI-based Editor is installed.
This is fairly easy stuff, but there's just so much of it that really only Administrators need to know how to do it..  


==Bolding/italicizing==
== Saving your work  ==
You bold text by entering <nowiki>'''text'''</nowiki> as here: '''text'''.


You italicize text by entering <nowiki>''text''</nowiki> as here: ''text''.
Everything in an article is actually plain text - so you can open a page as if to edit it, select the Wikitext button, select all, copy all, and paste the whole text (including formatting) into any word processor (such as Wordpad) to save it to your hard drive.  


You bold and italicize text by entering <nowiki>'''''text'''''</nowiki> as here: '''''text'''''.
By the way - it's smart to copy all your revised text just before hitting the Save button. Sometimes Save doesn't work, and you'll lose your text unless you've just copied it. Simply open the page again to edit it and paste the text you copied over whatever's there, and you're back in business!


==Headers==
When disaster strikes and you've accidentally trashed an article - DON'T SWEAT IT! Either revert it yourself (if you know how) or post a message on any Administrator's Talk page. This is an EASY fix for any experienced person. For now you can also contact me - go to [[User talk:Shollingsworth|Steve's Talk]].  
You can have as many levels of headers as you want. Have enough headers, and a Table Of Contents will automatically appear.


You make a first-level header by entering <nowiki>==text==</nowiki>.
If you need help as fast as you can get it, both contact any administrator or me AND edit the article and put '''<nowiki>{{help me}}</nowiki>''' (including the brackets) at the very top and then Save the article.  


You make a second-level header by entering <nowiki>===text===</nowiki> as here:
== Temporary holding work spaces  ==
===Second-level header===


You make a third-level header by entering <nowiki>====text====</nowiki> as here:
You can make "holding places" for articles you're working on by typing in '''<nowiki>user:yourname/filename</nowiki>''' and choosing to Edit it.
====Third-level header====


==Lists==
I created '''[[User:Shollingsworth/examples]]'''. You can have any number of these "holding places" of any legitimate name.
Lists are made by putting '''<nowiki>*</nowiki>''' and '''<nowiki>#</nowiki>''' at the start of a line.


If you use '''<nowiki>*</nowiki>''' in a list, you get:
== Bolding/italicizing  ==
* any normal text or linking
* any normal text or linking
* any normal text or linking


If you use '''<nowiki>#</nowiki>''' in a list, you get:
You bold text by entering <nowiki>'''text'''</nowiki> as here: '''text'''.
# any normal text or linking
# any normal text or linking
# any normal text or linking


==Wikilinks, Wikipedia links, and links to internet pages==
You italicize text by entering <nowiki>''text''</nowiki> as here: ''text''.  
You make a wikilink to an article inside Wikidelphia by entering <nowiki>[[article-name]]</nowiki> as here <nowiki>[[Nonprofit Technology Resources]]</nowiki> which becomes [[Nonprofit Technology Resources]]. (Capitalizatiion is important!)


You make a wikilink to an article inside '''''Wikipedia''''' by entering <nowiki>[[Wikipedia:article-name]]</nowiki> as here [[Wikipedia:Free Geek]].
You bold and italicize text by entering <nowiki>'''''text'''''</nowiki> as here: '''''text'''''.  


If you've already accessed the article, the wikilink gets dark. If the article doesn't exist yet, the text will be red.
== Headers ==


You make a link to an article on the internet by entering <nowiki>[url]</nowiki> as here <nowiki>[http://www.cnn.com]</nowiki> which becomes [http://www.cnn.com].
You can have as many levels of headers as you want. Have enough headers, and a Table Of Contents will automatically appear.  


===Renaming links===
You make a first-level header by entering '''<nowiki>=text=</nowiki>''' -- I don't use them, because Wikipedia style is to have only one kind of underlined header asnd I agree with that.  
Wouldn't it be nice if the wikilink and external link names were more descriptive?  Well, you can have that, and it's very easy also.


Rename an external link (a link to an internet page) by using the following format: <nowiki>[url text]</nowiki> as here <nowiki>[http://www.cnn.com CNN]</nowiki> becomes [http://www.cnn.com CNN].
You make a second-level header by entering '''<nowiki>==text==</nowiki>''', and it will be underlined.  


Rename a Wikidelphia wikilink by using the following format: <nowiki>[article-name|text]</nowiki> as here <nowiki>[[Nonprofit Technology Resources|NTR]]</nowiki> becomes [[Nonprofit Technology Resources|NTR]].
You make a third-level header by entering '''<nowiki>===text===</nowiki>''' as here:


Rename a ''Wikipedia'' wikilink by using the following format: <nowiki>[Wikipedia:article-name|text]</nowiki> as here <nowiki>[[Wikipedia:Camara (charity)|Camara]]</nowiki> becomes [[Wikipedia:Camara (charity)|Camara]].
=== Third-level header  ===


===References===
You make a fourth-level header by entering '''<nowiki>====text====</nowiki>''' as here (I rarely use these either, as they look too much like third-level headers):
We don't have the References capability enabled yet.


==See also==
==== Fourth-level header  ====
It's traditional to have a ''See also'' section of wikilinks in an article.  It's not required, just traditional.


*[[Stan's Introduction]]
== Lists  ==
*[[Wikipedia:Sandbox]]
 
Lists are made by putting '''<nowiki>*</nowiki>''' and '''<nowiki>#</nowiki>''' at the start of a line.
 
If you use '''<nowiki>*</nowiki>''' in a list, you get:
 
*any normal text or linking
*any normal text or linking
*any normal text or linking
 
If you use '''<nowiki>#</nowiki>''' in a list, you get:
 
#any normal text or linking
#any normal text or linking
#any normal text or linking
 
== Wikilinks, Wikipedia links, and links to internet pages  ==
 
You make a wikilink to an article inside Wikidelphia by entering <nowiki>[[article-name]]</nowiki> as here <nowiki>[[Nonprofit Technology Resources]]</nowiki> which becomes [[Nonprofit Technology Resources]]. (Capitalization is important!)
 
You make a wikilink to an article inside '''''Wikipedia''''' by entering <nowiki>[[Wikipedia:article-name|article-name]]</nowiki> as here [[wikipedia:Free Geek|Free Geek]].
 
If you've already accessed the article, the wikilink gets dark. If the article doesn't exist yet, the text will be red.
 
You make a link to an article on the internet by entering <nowiki>[url]</nowiki> as here <nowiki>[http://www.cnn.com]</nowiki> which becomes [http://www.cnn.com].
 
=== Renaming links  ===
 
Wouldn't it be nice if the wikilink and external link names were more descriptive? Well, you can have that, and it's very easy also.
 
Rename an external link (a link to an internet page) by using the following format: <nowiki>[url text]</nowiki> as here <nowiki>[http://www.cnn.com CNN]</nowiki> becomes [http://www.cnn.com CNN].
 
For the next part you need to know where the '''<nowiki>|</nowiki>''' key is. It's in the lower-right of your keyboard, on the '''<nowiki>\</nowiki>''' key which is below the '''Enter''' key.
 
Rename a Wikidelphia wikilink by using the following format: <nowiki>[article-name|text]</nowiki> as here <nowiki>[[Nonprofit Technology Resources|NTR]]</nowiki> becomes [[Nonprofit Technology Resources|NTR]].
 
Rename a ''Wikipedia'' wikilink by using the following format: <nowiki>[Wikipedia:article-name|text]</nowiki> as here <nowiki>[[Wikipedia:Camara (charity)|Camara]]</nowiki> becomes [[wikipedia:Camara (charity)|Camara]].
 
=== References  ===
 
We don't have the References capability enabled yet. And it can (in Wikipedia's new form) be very complicated to use.
 
== Making a "See also"  ==
 
It's traditional to have a ''See also'' section of wikilinks at the end of an article. It's not required, just traditional.
 
Example:
 
*[[Stan's Introduction]]  
*[[wikipedia:Sandbox|Sandbox]]  
*[http://meta.wikimedia.org/wiki/Help:Contents User's Guide]
*[http://meta.wikimedia.org/wiki/Help:Contents User's Guide]


==Talk/Discussion pages==
:(This last is an external link, and belongs in an '''External links''' section.)
===Signing your name===
It's very good etiquette to sign your name on posts you make on Talk or Discussion pages.


You do that by, after your message, typing four tildes (the shifted-character in the upper left of your keyboard) like this: <nowiki>~~~~</nowiki>
== Inserting pictures ==


If you have an account here and are signed in, your username will appear in the text after you hit Save.
Well, I don't know how to do this yet - and, frankly, you shouldn't either.  


This is an example:
You see, the problem is Copyrights. All images are automatically copyrighted now. And Wikidelphia hasn't yet set policy on how to handle image copyrights.


<blockquote>Hi, John! I'm glad you joined us! <nowiki>~~~~</nowiki></blockquote>
You can insert a picture onto a page if you use the '''Insert/edit image''' button on the toolbar -- but you have to enter the image's page. That page is a '''File:Some name''' and I don't yet know how to get a picture into a '''File'''.
 
Our one Bureaucrat can do it - and that's probably sufficient until our Third Organizational Meeting.
 
== Templates  ==
 
Templates are complicated, and I've only made two simple ones and fixed another.
 
First, if you're going to have the Template list tagged pages in a Category, you have to create that Category. You do that by entering in the search box '''Category:New name''' and putting some text onto that page.
 
Okay, now you can go to '''Special pages,''' then '''Templates''' and then '''Create a template'''. That will get you into the Template wizard.
 
Let's keep the next steps very simple for now.
 
*'''Template name:''' Anything at all.
*'''Category defined by template:''' This is the '''New name''' that you used above.
*'''Field name:''' This is what has to be put onto the page during editing, as in '''<nowiki>{{help me}}</nowiki>''' where "help me" is the Field name.
 
:The format of the entry is '''<nowiki>{{Field name}}</nowiki>''' (including the special brackets).
 
*'''Display label:''' This is what will be seen by the readers, and can be very long.
 
== Talk/Discussion pages  ==
 
=== Signing your name  ===
 
It's very good etiquette to sign your name on posts you make on Talk or Discussion pages.
 
You do that by, after your message, typing four tildes (the shifted-character in the upper left of your keyboard) like this: <nowiki>~~~~</nowiki>  


for me becomes:
If you have an account here and are signed in, your username will appear in the text after you hit Save.


This is an example:
<blockquote>Hi, John! I'm glad you joined us! <nowiki>~~~~</nowiki></blockquote>
for me becomes:
<blockquote>Hi, John! I'm glad you joined us! [[User:Shollingsworth|Shollingsworth]] 14:48, 14 January 2011 (PST)</blockquote>
<blockquote>Hi, John! I'm glad you joined us! [[User:Shollingsworth|Shollingsworth]] 14:48, 14 January 2011 (PST)</blockquote>
=== Indenting  ===


===Indenting===
It's also correct to indent your response to someone's Talk post. You do that by using one or more colons ( '''<nowiki>:</nowiki>''' ) at the start of your response.  
It's also correct to indent your response to someone's Talk post. You do that by using one or more colons ( <nowiki>:</nowiki> ) at the start of your response.


For example,
For example,  


''<nowiki>This is a post. ~~~~</nowiki>''
''<nowiki>This is a post. ~~~~</nowiki>''  


''<nowiki>:This is a reply. ~~~~</nowiki>''
''<nowiki>:This is a reply. ~~~~</nowiki>''  


''<nowiki>::This is a second reply. ~~~~</nowiki>''
''<nowiki>::This is a second reply. ~~~~</nowiki>''  


becomes
becomes  


This is a post. [[User:Shollingsworth|Shollingsworth]] 15:01, 14 January 2011 (PST)
This is a post. [[User:Shollingsworth|Shollingsworth]] 15:01, 14 January 2011 (PST)  
:This is a reply. [[User:Shollingsworth|Shollingsworth]] 15:01, 14 January 2011 (PST)
 
:This is a reply. [[User:Shollingsworth|Shollingsworth]] 15:01, 14 January 2011 (PST)  
::This is a second reply. [[User:Shollingsworth|Shollingsworth]] 15:01, 14 January 2011 (PST)
::This is a second reply. [[User:Shollingsworth|Shollingsworth]] 15:01, 14 January 2011 (PST)
== Hidden comments inside text  ==
Another thing you can do is to leave "hidden" notes in an article by typing '''<nowiki><!-- text --></nowiki>''' as here <!-- PEEK-A-BOO! -->
Another way to do this is to format the text as white, but that's more complicated and will leave big white spaces in the article.
== Redirects and disambiguation pages  ==
=== Redirects  ===
'''Redirects''' are a simple way to make key words or phrases automatically take readers to appropriate articles.
Make a new page of any desired name (try using '''Xyz''') and on that page type in '''<nowiki>#REDIRECT [[Block captain]]</nowiki>''' and save it. Then type in '''Xyz''' in the Search box. You'll be jumped to [[Block captain]].
=== Disambiguation pages  ===
'''Disambiguation pages''' are similar tools but give choices. They're right now beyond the scope of simple editing, but if you post on my Talk page I'll be happy to tell you how to do them. Go to [[User talk:Shollingsworth|Steve's Talk]]

Latest revision as of 00:04, 22 August 2017

This is Steve's Wikitext editing introduction (an extension of editing). It was written in 2011 and hasn't been updated. For something a lot more recent, see PaulSank's Step-By-Step Guide to Wikidelphia Editing.

Some features we'd like (such as References) aren't enabled yet.

This is fairly easy stuff, but there's just so much of it that really only Administrators need to know how to do it..

Saving your work

Everything in an article is actually plain text - so you can open a page as if to edit it, select the Wikitext button, select all, copy all, and paste the whole text (including formatting) into any word processor (such as Wordpad) to save it to your hard drive.

By the way - it's smart to copy all your revised text just before hitting the Save button. Sometimes Save doesn't work, and you'll lose your text unless you've just copied it. Simply open the page again to edit it and paste the text you copied over whatever's there, and you're back in business!

When disaster strikes and you've accidentally trashed an article - DON'T SWEAT IT! Either revert it yourself (if you know how) or post a message on any Administrator's Talk page. This is an EASY fix for any experienced person. For now you can also contact me - go to Steve's Talk.

If you need help as fast as you can get it, both contact any administrator or me AND edit the article and put {{help me}} (including the brackets) at the very top and then Save the article.

Temporary holding work spaces

You can make "holding places" for articles you're working on by typing in user:yourname/filename and choosing to Edit it.

I created User:Shollingsworth/examples. You can have any number of these "holding places" of any legitimate name.

Bolding/italicizing

You bold text by entering '''text''' as here: text.

You italicize text by entering ''text'' as here: text.

You bold and italicize text by entering '''''text''''' as here: text.

Headers

You can have as many levels of headers as you want. Have enough headers, and a Table Of Contents will automatically appear.

You make a first-level header by entering =text= -- I don't use them, because Wikipedia style is to have only one kind of underlined header asnd I agree with that.

You make a second-level header by entering ==text==, and it will be underlined.

You make a third-level header by entering ===text=== as here:

Third-level header

You make a fourth-level header by entering ====text==== as here (I rarely use these either, as they look too much like third-level headers):

Fourth-level header

Lists

Lists are made by putting * and # at the start of a line.

If you use * in a list, you get:

  • any normal text or linking
  • any normal text or linking
  • any normal text or linking

If you use # in a list, you get:

  1. any normal text or linking
  2. any normal text or linking
  3. any normal text or linking

You make a wikilink to an article inside Wikidelphia by entering [[article-name]] as here [[Nonprofit Technology Resources]] which becomes Nonprofit Technology Resources. (Capitalization is important!)

You make a wikilink to an article inside Wikipedia by entering [[Wikipedia:article-name|article-name]] as here Free Geek.

If you've already accessed the article, the wikilink gets dark. If the article doesn't exist yet, the text will be red.

You make a link to an article on the internet by entering [url] as here [http://www.cnn.com] which becomes [1].

Wouldn't it be nice if the wikilink and external link names were more descriptive? Well, you can have that, and it's very easy also.

Rename an external link (a link to an internet page) by using the following format: [url text] as here [http://www.cnn.com CNN] becomes CNN.

For the next part you need to know where the | key is. It's in the lower-right of your keyboard, on the \ key which is below the Enter key.

Rename a Wikidelphia wikilink by using the following format: [article-name|text] as here [[Nonprofit Technology Resources|NTR]] becomes NTR.

Rename a Wikipedia wikilink by using the following format: [Wikipedia:article-name|text] as here [[Wikipedia:Camara (charity)|Camara]] becomes Camara.

References

We don't have the References capability enabled yet. And it can (in Wikipedia's new form) be very complicated to use.

Making a "See also"

It's traditional to have a See also section of wikilinks at the end of an article. It's not required, just traditional.

Example:

(This last is an external link, and belongs in an External links section.)

Inserting pictures

Well, I don't know how to do this yet - and, frankly, you shouldn't either.

You see, the problem is Copyrights. All images are automatically copyrighted now. And Wikidelphia hasn't yet set policy on how to handle image copyrights.

You can insert a picture onto a page if you use the Insert/edit image button on the toolbar -- but you have to enter the image's page. That page is a File:Some name and I don't yet know how to get a picture into a File.

Our one Bureaucrat can do it - and that's probably sufficient until our Third Organizational Meeting.

Templates

Templates are complicated, and I've only made two simple ones and fixed another.

First, if you're going to have the Template list tagged pages in a Category, you have to create that Category. You do that by entering in the search box Category:New name and putting some text onto that page.

Okay, now you can go to Special pages, then Templates and then Create a template. That will get you into the Template wizard.

Let's keep the next steps very simple for now.

  • Template name: Anything at all.
  • Category defined by template: This is the New name that you used above.
  • Field name: This is what has to be put onto the page during editing, as in {{help me}} where "help me" is the Field name.
The format of the entry is {{Field name}} (including the special brackets).
  • Display label: This is what will be seen by the readers, and can be very long.

Talk/Discussion pages

Signing your name

It's very good etiquette to sign your name on posts you make on Talk or Discussion pages.

You do that by, after your message, typing four tildes (the shifted-character in the upper left of your keyboard) like this: ~~~~

If you have an account here and are signed in, your username will appear in the text after you hit Save.

This is an example:

Hi, John! I'm glad you joined us! ~~~~

for me becomes:

Hi, John! I'm glad you joined us! Shollingsworth 14:48, 14 January 2011 (PST)

Indenting

It's also correct to indent your response to someone's Talk post. You do that by using one or more colons ( : ) at the start of your response.

For example,

This is a post. ~~~~

:This is a reply. ~~~~

::This is a second reply. ~~~~

becomes

This is a post. Shollingsworth 15:01, 14 January 2011 (PST)

This is a reply. Shollingsworth 15:01, 14 January 2011 (PST)
This is a second reply. Shollingsworth 15:01, 14 January 2011 (PST)

Hidden comments inside text

Another thing you can do is to leave "hidden" notes in an article by typing <!-- text --> as here

Another way to do this is to format the text as white, but that's more complicated and will leave big white spaces in the article.

Redirects and disambiguation pages

Redirects

Redirects are a simple way to make key words or phrases automatically take readers to appropriate articles.

Make a new page of any desired name (try using Xyz) and on that page type in #REDIRECT [[Block captain]] and save it. Then type in Xyz in the Search box. You'll be jumped to Block captain.

Disambiguation pages

Disambiguation pages are similar tools but give choices. They're right now beyond the scope of simple editing, but if you post on my Talk page I'll be happy to tell you how to do them. Go to Steve's Talk