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

From P2P Foundation
Jump to navigation Jump to search
 
(26 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>[[Page Name]]</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/]


You can also write an external link without any brackets as http://commonstransition.org/ &ndash; where the URL is shown.
===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.


You might want to write an external link with brackets, though, because then you can make them say something like [http://google.com Google] instead of simple the url as http://google.com.
===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/]


==Alternative Text for Internal and External Links==
To show a plain URL, write the external link without any brackets:
<pre>http://commonstransition.org/</pre>
shows up as http://commonstransition.org/


When you want to write a link that uses different text you will also need to use some special markup.
==Different Text for Internal and External Links==


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.
You may well want to write a link that uses a different text to act as the link to click on.


Internal Link using double brackets and a bar ("|") to use alternative link text <pre>[[P2P Foundation | The Foundation for P2P Alternatives]]</pre>
===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]]


This markup creates: [[P2P Foundation | 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.


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.
===External links===


<pre>External links with single brackets and a space before link text [http://p2pfoundation.net P2P Foundation]</pre>
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
This markup creates: [http://p2pfoundation.net P2P Foundation]
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.
Retrieved from "https://wiki.p2pfoundation.net/index.php?title=Help:How_to_Make_Links_and_New_Pages&oldid=117208"