Creating Pages and Links

The ability to easily add pages and create links (to other pages and to external URLs) is one of the most important features of the BGC wikis. There are a number of ways to create pages and these different types of links, and this guide will help you with those procedures.

In addition to basic text links to wiki pages and external URLs—the topics covered here—you will find further wiki how-to pages addressing how to link to uploaded PDF files and create links within embedded images.

Pages

In order to build a detailed and robust site, you must be able to make pages. Fortunately, making pages is very easy on the BGC wikis by either of two methods. First, you can use the Add a Page module, which looks like this:

add-a-page.png

This module appears on all pages, usually at the bottom of the sidebar. In order to create a new page, simply type the name you would like to give the page and hit the new page button. This will take you to a new page where you will be told that This page does not exist, and you will be prompted to create that new page. Add some text into the edit box, hit save, and VOILA! you have a new page.

Make sure to remember what you named your page as you are going to want to link to it later. If you forget, you can always locate it by clicking the List All Pages link in the sidebar and scrolling through the resultant list. To avoid such an issue, however, you can also add new pages by typing a simple code explained below into pages that already exist—in other words, first creating the link and then creating the page. This will prevent you from "losing" your pages because your link will already be intact.

Return to top

Links

There are two types of links in a wiki. Page Links point to other pages in the wiki. URL Links point to web pages outside of the wiki. This guide will help you make either type of link on the wikis.

Additional how-to guides explain how to link to uploaded PDF files and use images to link to wiki pages, external URLs, or uploaded files.

Page Links

Creating links to other pages in your wiki is very easy. You can use one of two buttons in your toolbar or type in the code manually, depending on what you feel is easiest and most intuitive. Each of these three methods is explicated in the following section.

Page Link Wizard

The "page link wizard" button creates your link for you from scratch. It looks like this:

pagelinkwizard.png

When you click on it, a pop-up window will prompt you to enter the destination page name.

destination.png

If you are creating a new page, you will enter the desired name here. If your page already exists, potential matches for what you type will appear beneath this space. For instance, when I begin to type "how-to," a partial list all the DML's how-to pages appears and is further refined as I continue typing:

how-to.png

After you have entered the desired name, or chosen the appropriate page from the list, you have the option to enter "anchor text." If you wish, this text will appear on your wiki instead of the formal name for the linked page. For example, some of our how-to pages will link to another how-to page, but the linked text will read "see this page"—in such a case, the words "see this page" are the anchor text.

After you click the "insert code" button on the pop-up window, the text in your entry box will look like this (substituting your preferred words for those shown):

[[[page name]]]

or

[[[page name |anchor text]]]

If you have used this code to add a new page to your wiki, the page link will display in red. When you click it, you will be prompted to then create that page. Once you add text to the edit box and click the "save" button, the page will be created and your initial link will be activated.

Return to top

Page Link Button

You can also use the "page link" button in your edit box toolbar to help you create the code to add or link to a page. The "page link" button looks like this:

pagelink.png

You can type the desired page name into your wiki page, highlight it with your mouse, and then click the "page link" button—this will add brackets around the selected text, and your link will be created. Alternately, you can first click the button. This will insert the brackets with highlighted text between them into your editing box, and you can then replace the highlighted text with your desired page name.

The text in your entry box will look like this (substituting your preferred words for those shown):

[[[page name]]]

You may want to link to the page with text other than the page's formal name. To do so, you can manually enter into this code what is called "anchor text." For example, some of our how-to pages will link to another how-to page, but the linked text will read "see this page"—in such a case, the words "see this page" are the anchor text. If you wish to do something similar, you can amend your code to look like this (substituting your preferred words for those shown):

[[[page name |anchor text]]]

Lastly, if you wish your linked page to open in a new tab or window (depending on your browser settings), you can manually type an asterisk (*) before the page name. For instance:

[[[*page name |anchor text]]]

If you have used this code to add a new page to your wiki, the page link will display in red. When you click it, you will be prompted to then create that page. Once you add text to the edit box and click the "save" button, the new page will be created and your initial link will be activated.

Return to top

Manual Entry

The code which you would use to create or add page links is very simply the desired page name surrounded by three brackets. It looks like this:

[[[page name]]]

You may wish to display on your wiki different text than the formal page name. For example, some of our how-to pages will link to another how-to page, but the linked text will read "see this page"—in such a case, the words "see this page" are the anchor text. You can substitute anchor text for the page title by following the page name in the code above with a space, a vertical bar (|), and the desired anchor text. Your amended code will then look like this (substituting your preferred words for those shown):

[[[page name |anchor text]]]

Finally, you may desire your linked page to open in a new tab or window (depending on your browser settings). An asterisk (*) preceding your page name will indicate that this should occur. For instance:

[[[*page name |anchor text]]]

If you have used this code to add a new page to your wiki, the page link will display in red. When you click it, you will be prompted to then create that page. Once you add text to the edit box and click the "save" button, the new page will be created and your initial link will be activated.

Return to top

External Links

The easiest way to create an external link is to simply type into your editing box the URL (universal resource locator) of the web page to which you want to link. Wikidot automatically recognizes the URL and creates a hyperlink.

For example, typing http://www.google.com will result in the linked text http://www.google.com.

However, you will often want to display text other than the literal URL when linking to a webpage. You can do this in three ways, according to your preference, as outlined in this section.

URL link wizard

The "URL link wizard" button creates your link for you from scratch. It looks like this:

URLwizard.png

When you click on it, a pop-up window will prompt you to enter the destination URL address.

URLpage.png

After you have entered this, you have the option to enter "anchor text." If you wish, this text will appear on your wiki instead of the long URL.

You can also check a box that will open your link in a new tab or window (depending on your browser settings).

After you click the "insert code" button on the pop-up window, the text in your entry box will look something like one of the following examples:

[http://example.com]

or

[http://example.com anchor text]

or

[*http://example.com anchor text]

Your anchor text is simply separated from your URL address by a space, while the asterisk (*) preceding your URL indicates it should open in a new tab or window.

Return to top

URL Link Button

The "URL link" button will place code within your text box that you can then replace with your preferred elements.

The button looks like this:

URLlink.png

When you click it, you will be provided with the following code:

[http://www.example.com describe link]

You would replace the "http://www.example.com" with the URL to which you want to link, and substitute for the words "describe link" the descriptor you want to use as "anchor text." This allows you designate that link with text of your choice instead of the long URL.

If you want this linked webpage to open in a new tab or window (depending on your browser settings), you can manually add an asterisk (*) before the designated URL. When you have done so, your code will look something like this:

[*http://www.example.com describe link]

Return to top

Manual Entry

To display text other than the literal URL address for an external website, follow the URL with a space and then the desired "anchor text," and finally surround the entirety or this text with a single set of brackets.

The code will look like this (substituting your preferred words for those shown):

[http://www.example.com anchor text]

If you want this linked webpage to open in a new tab or window (depending on your browser settings), you can add an asterisk (*) before the designated URL. Now your code will look something like this:

[*http://www.example.com anchor text]

Return to top

Making Your Link Open in a New Window

Whether you have created a link to another page within your wiki or to an external webpage, the inclusion of an asterisk (*) preceding your directive will open the designated link in a new window. For example:

[[[*page name]]]

or

[*http://en.wikipedia.com Wikipedia]

Return to top

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License