Help:Contents/Editing: Difference between revisions

2,408 bytes added ,  08:22, 11 April 2021
m
m (→‎Creating Sections: spelling/typo corrections galore)
Line 89: Line 89:




==Page Linking==
==Creating a new Wiki page==  


One of the most useful features of any page is referring the reader to informatin on other pages to futher expand their knowledge or explain something in more detail.
All Wiki page names always start with a capital letter, and the Wiki will always replace an initial lower case letter with the equivalent upper case letter.  You can choose the case of subsequent letters, but these must always be specified in any references to the page exactly as when the page was created.  


If you are referring to a page in the Cumulus Wiki simply enclose the name of the page is two square brackets.
It is easier for the reader to find information on multiple short pages, than have to read a long page. Think carefully about page names; if you use a word like "New" in connection with a feature added in a particular release, will the contents remain "new" for evermore, or will they become "standard" when older releases are forgotten.  In general, page names should be kept short, but if a topic is split over several pages, each page name must make it clear what is on that particular page.


Example: <nowiki>[[Webtags]]</nowiki>
The web page name you choose will form part of a URL <nowiki>https://cumuluswiki.org/a/'''new_page_name'''</nowiki>, so it is normal to place underlines between words in a page name (because spaces cannot appear in a URL, and would be replaced by the messy "%20" code). 


When the reader clicks on the word Webtags they will be taken to the page of the same name. If you wish to show a different word or phrase from the page name use the | symbol
To create a new page, there are two ways:
#When you feel you have enough on the current page simply enclose the proposed name of the page in double square brackets <nowiki>[[.....]]</nowiki> in a cross-reference on an existing page.
#*A link to an internal page name that does not exist, will appear in red on the existing page.  Clicking that link will take you (or anyone else) to a new screen where you can create the new page.
#Go to the URL box in your browser, and replace the name of any existing page (that you are reading, not editing) with your proposed new name, then go to the URL.
#*A screen will appear saying that you have linked to a page that does not yet exist (or has exited before and been deleted), saying that if you type in content then the page will be created.


Example: <nowiki>[[Webtags|Special tags]]</nowiki>
'''Be careful''' a reference to (for example) <nowiki>[[webTags]]</nowiki> would create a new page, as that capital '''T''' in the middle is different to the name of the existing '''Webtags''' page.
==Cross references to other Wiki pages==


In this case, the user will see the words Special tags but when they click it will take them to the Webtags page
You may wish to refer the reader to information on other pages to further expand their knowledge or explain something in more detail.  If you are referring to another page already in the Cumulus Wiki simply enclose the name of the page is two square brackets (just as advised above to link to a new page). If you wish to show a different word or phrase that will mean more to the reader, than the page name, use the '''|''' symbol after the page name and then type the phrase you want the reader to see (this latter approach is also used where you want to replace underlines in the page name with spaces to make it look better to the reader):


if you wish to link to a page outwith the Cumulus Wiki, enclosed the full URL, a space, and a word or phrase in one set of square brackets.
Examples:  <nowiki>[[Webtags]]</nowiki>  and  <nowiki>[[Webtags|Cumulus web tags]]</nowiki>
 
In the first example, if the reader clicks on the word Webtags they will be taken to the page of the same name. In the second case, the user will see the words '''Cumulus web tags''' but when they click it will take them to the '''Webtags''' page.  '''Be careful with the case of the page name when linking in Wiki.'''  The case of the first letter does not matter, so linking to <nowiki>[[webtags]]</nowiki> or <nowiki>[[Webtags]]</nowiki> is the same as Wiki will always uppercase the first letter. 
 
Remember, the case of all letters except the first does matter, and if you do not match the original page name, the Wiki will think you want to link to a page that does not yet exist.
 
 
==Creating a link to an external page ==
 
if you wish to link to a page outside the Cumulus Wiki, such as a post on the support forum, enclose in one set of square brackets: the full URL, a space, and then a descriptive phrase.


Example: <nowiki>[http://www.google.com Google]</nowiki>
Example: <nowiki>[http://www.google.com Google]</nowiki>


The reader will see the word Google but when clicked will be taken to an external page.
The reader will see the word '''Google''' but on clicking that they will be taken to an external page.
<br/><br/>
'''Be careful with the case of the page name when linking in Wiki.''' Pages always start with a capital letter but after this the case is important.  So linking to <nowiki>[[webtags]]</nowiki> or <nowiki>[[Webtags]]</nowiki> is the same as Wiki will always uppercase the first letter.  However <nowiki>[[webTags]]</nowiki> would fail as the real page does not have an uppercase T
<br/><br/>
If you link to an internal page name that does not exist, it will appear in red on the page. You, or the user, can then create the page.  This is a quick way to create a new page!
 


==Using images==
==Using images==
5,838

edits