Help:How to Make Links and New Pages: Difference between revisions

From P2P Foundation
Jump to navigation Jump to search
 
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Intro to Linking==
==Intro to Linking==


Here is a simple link to a page on this wiki[[Peer to Peer]]
To create a link to a page on this wiki, like [[Peer to Peer]], you just type
<pre>[[Peer to Peer]]</pre>
You'll immediately notice the double brackets.  This is "mediawiki markup".  This double bracket link is used for an internal link;
it points to a page on the wiki called "Peer to Peer".


<pre> When you type it into a page you type it like this: [[Peer to Peer]]</pre>
==Link colour for pages that don't exist yet==
 
When you see a red link like [[Dubious Page Name]] it means that the page does not yet exist.  If you click on the link you will be given the opportunity to create the page (please don't!).  This is the way to create new pages when you are editing on the wiki.  Just make a link to a page that doesn't exist; then, submit the page, and click on the link to edit the new page. When you do create new pages, please put some meaningful content in the new page straight away.
You'll immediately notice the double brackets.  These are "mediawiki markup".  This double bracket link is used for an internal link; it points to a page on the wiki called "Peer to Peer".
 
==Link Colors==
When you see a red link like [[Red Link Example]] it means that the page does not yet exist.  If you click on the link you will be given the opportunity to create the page.  This is a simple way to create new pages when you are editing on the wiki.  Just make a link to a page that doesn't exist; then, submit the page, and click on the link to edit the new page. However, please do not create new pages and leave them empty.
 
External links have arrows attached to them like this: http://google.com .  Even if a link seems like it might be to a page on the wiki, if it is to an external site outside the wiki, it will have an arrow attached to it. For example [http://p2pfoundation.net P2P Foundation]


==Making Internal and External Links==
==Making Internal and External Links==


There are two types of links in a wiki, internal and external.
There are two types of links in a wiki, internal and external.
* Internal links use double brackets to surround a page name, and the page name appears as written: <pre>[[P2P Foundation]]</pre>
* External links use single brackets to surround a URL, like this: <pre>[http://commonstransition.org/]</pre> but the URL is not shown if you include it in brackets: [http://commonstransition.org/]
* To show a plain URL, write the external link without any brackets: http://commonstransition.org/


==Alternative Text for Internal and External Links==
===Internal links===
Internal links use double brackets to surround a page name, and the page name appears as written. If you type
<pre>[[P2P Foundation]]</pre>
then [[P2P Foundation]] shows on the page.
Take care to use capitals exactly where they are used in the page name,
or else the page may not link properly.
You can use a lower-case first letter, and that will automatically be capitalised.


When you want to write a link that uses different text you will also need to use some special markup.
===External links===
External links use single brackets to surround a URL. If you type:
<pre>[http://commonstransition.org/]</pre>
with brackets, the URL is not shown, but instead replaced with a number: [http://commonstransition.org/]


Internal links with alternative text are written like this with double brackets and a 'bar' to separate the name.  In each instance where you want to use the alternative text you will enclose your link with the link text inside the brackets. When you create an internal link you will use the Page Name including the spaces.  In this example we will use the text "The Foundation for P2P Alternative". For ease of reading, best to put a space on either side of the bar (the "|" character) but that is not strictly necessary.
To show a plain URL, write the external link without any brackets:
<pre>http://commonstransition.org/</pre>
shows up as http://commonstransition.org/


Internal Link using double brackets and a bar ("|") to use alternative link text <pre>[[P2P Foundation | The Foundation for P2P Alternatives]]</pre>
==Different Text for Internal and External Links==


This markup creates: [[P2P Foundation | The Foundation for P2P Alternatives]]
You may well want to write a link that uses a different text to act as the link to click on.


When you want to use alternative text for an external link you leave out the bar ("|") and simply leave a space between the link and the start of the link text.
===Internal links===
For internal links, keep the double brackets, but add a bar ("|") between the actual page name,
and the different text you want to show up as the link, all inside the double brackets.
So for example, if you write
<pre>[[P2P Foundation | The Foundation for P2P Alternatives]]</pre>
you get:<br />
[[P2P Foundation | The Foundation for P2P Alternatives]]


<pre>External links with single brackets and a space before link text [http://p2pfoundation.net P2P Foundation]</pre>
Notice that the spaces are kept here, and not replaced with the underscores that you see in the actual URL.
For ease of reading, best to put a space on either side of the bar (the "|" character) but that is not strictly necessary.


This markup creates: [http://p2pfoundation.net P2P Foundation]
===External links===
 
To have a link text for external links, rather than the URL or just a number,
you include the different text inside the single brackets
but this time you leave out the bar ("|") and simply leave a space between the link and the start of the link text.
So if you write:
<pre>[http://commonstransition.org/ Commons Transition]</pre>
you get:<br />
[http://commonstransition.org/ Commons Transition]


==Creating New Pages==
==Creating New Pages==
 
Edit a page to create a new internal link, which will appear red.
There are two very simple methods for creating a new page.
* Click on the link and you will be given the option to create the new page.
 
* Put in your initial content, and save your new page.
#Type the address into the address bar, with underscores (_) in place of any spaces.  Example: <pre>http://wiki.p2pfoundation.net/New_Page_Name_Here</pre>
##The wiki will use this as a prompt to create a new page with the title "New Page Name Here"
##Be sure to capitalize everything that you want capitalized, and to check your spelling.
 
The second method was covered above
#Visit a page and create a new internal link
##Click on the link and you will be taken to the new page.
##Edit and save your new page.




[[Category:P2P Foundation Wiki How-To]]
[[Category:P2P Foundation Wiki How-To]]

Latest revision as of 14:40, 17 July 2019

Intro to Linking

To create a link to a page on this wiki, like Peer to Peer, you just type

[[Peer to Peer]]

You'll immediately notice the double brackets. This is "mediawiki markup". This double bracket link is used for an internal link; it points to a page on the wiki called "Peer to Peer".

Link colour for pages that don't exist yet

When you see a red link like Dubious Page Name it means that the page does not yet exist. If you click on the link you will be given the opportunity to create the page (please don't!). This is the way to create new pages when you are editing on the wiki. Just make a link to a page that doesn't exist; then, submit the page, and click on the link to edit the new page. When you do create new pages, please put some meaningful content in the new page straight away.

Making Internal and External Links

There are two types of links in a wiki, internal and external.

Internal links

Internal links use double brackets to surround a page name, and the page name appears as written. If you type

[[P2P Foundation]]

then P2P Foundation shows on the page. Take care to use capitals exactly where they are used in the page name, or else the page may not link properly. You can use a lower-case first letter, and that will automatically be capitalised.

External links

External links use single brackets to surround a URL. If you type:

[http://commonstransition.org/]

with brackets, the URL is not shown, but instead replaced with a number: [1]

To show a plain URL, write the external link without any brackets:

http://commonstransition.org/

shows up as http://commonstransition.org/

Different Text for Internal and External Links

You may well want to write a link that uses a different text to act as the link to click on.

Internal links

For internal links, keep the double brackets, but add a bar ("|") between the actual page name, and the different text you want to show up as the link, all inside the double brackets. So for example, if you write

[[P2P Foundation | The Foundation for P2P Alternatives]]

you get:
The Foundation for P2P Alternatives

Notice that the spaces are kept here, and not replaced with the underscores that you see in the actual URL. For ease of reading, best to put a space on either side of the bar (the "|" character) but that is not strictly necessary.

External links

To have a link text for external links, rather than the URL or just a number, you include the different text inside the single brackets but this time you leave out the bar ("|") and simply leave a space between the link and the start of the link text. So if you write:

[http://commonstransition.org/ Commons Transition]

you get:
Commons Transition

Creating New Pages

Edit a page to create a new internal link, which will appear red.

  • Click on the link and you will be given the option to create the new page.
  • Put in your initial content, and save your new page.