Differences

This shows you the differences between two versions of the page.

--- faqs:about_this_wiki:linking_pages [07/04/2025 03:40 PM (5 months ago)] – removed - external edit (Unknown date) 127.0.0.1
+++ faqs:about_this_wiki:linking_pages [07/04/2025 03:40 PM (5 months ago)] (current) – ↷ Links adapted because of a move operation Chris Daley
@@ Line 1: / Line 1: @@
+====== Linking Pages ======
+This page tells you how to create a link to an existing page or an external resource. if you want to create a new page, [[faqs:about_this_wiki:adding_a_new_page|click here]].
+Linking to an existing page when editing is pretty simple. Say we want to link to the [[people:wiki_admins|Wiki Admins]] page - here's the quick version:
+  * Type in the words that will make up the link
+  * Highlight the words with your mouse and click on the //Insert Link //(paperclip) option on the toolbar
+  * In the Link Configuration popup window, select the Link Target.
+  * Click ''OK''
+  * The selected link should now glow green.
+Lets go into more detail on each step.
+===== Type in the link words =====
+Normally, you'd just type in the words that will make up the link. Then use your mouse to select them.
+You can also just position the cursor where you want the link to appear and have the wiki copy in the title of the page you want to link to. (More on that below.)
+===== Select the Link Configuration options =====
+After you've highlighted the link words or positioned the cursor, click on the //Insert Link //(paperclip) option on the toolbar: {{faqs:about_this_wiki:button_backlinks.png?36}}
+This will bring up the Link Configuration popup window.
+{{ faqs:about_this_wiki:link_configuration.jpg?400 }}
+==== The Link Target & Link Type ====
+The //Link target //can mean different things depending on the //Link Type //selected. We'll go thru each Link Type and explain how to use it.
+=== A page in this wiki ===
+Select this option when you want to link to another page within this wiki. In our example, you would use this option when you want to link to the [[people:wiki_admins|Wiki Admins]] page.
+{{ faqs:about_this_wiki:example_top_right.jpg?200}}When you select //**a page in this wiki**//, the //Link target //is the location ([[faqs:about_this_wiki:namespaces|namespace]] and name) where this page is stored. It's the location displayed in the tab in the main content area. Fortunately, you can easily select it by clicking the paperclip icon next to the //Link target// text field.
+Clicking the paperclip icon will bring up a popup //Link Wizard// window.
+{{ faqs:about_this_wiki:link_wizard.jpg?233 }}
+This window displays the pages in the current [[faqs:about_this_wiki:namespaces|namespace]] and allows you to move up and down thru the sitemap tree to find the page you're looking for. Click on the page you're looking for and the corresponding location will be loaded into the //Link target//.
+In our example, you would click ''jump to parent namespace ''until you reached the top namespace, where you'd see ''people:'' . Click on ''people:'' , then scroll down until you saw ''people:wiki_admin'' . Click on it and you'll see ''people:wiki_admin'' filled in as the Link target.
+=== An interwiki link ===
+This allows you to easily link to a page in other selected wikis. You'll use mainly [[wp>Wikipedia|Wikipedia]] , [[doku>DokuWiki|DokuWiki]] and [[tel>Telephone|Telephone ]]links. There are many other options, including Amazon, Google, etc.
+When you select ''An interwiki link'', the //Link target //changes into two fields:
+{{ faqs:about_this_wiki:link_configuration_interwiki.jpg?400 }}
+== the InterWiki field ==
+The [[faqs:about_this_wiki:InterWiki]] field lets you select which wiki or phone number you want to link to.
+Use ''wp'' for Wikipedia, ''doku'' for [[faqs:about_this_wiki:DokuWiki]] and ''tel'' for a telephone number.
+For the other options, you can get more information [[doku>interwiki|here ]]or view [[https://github.com/dokuwiki/dokuwiki/blob/master/conf/interwiki.conf|the complete list]].
+== the Link Target field ==
+Type in the name of the Wikipedia or [[faqs:about_this_wiki:DokuWiki]] page. You can find it in the title of the page or the last part of the page's URL.
+For phone numbers, just type in the phone number with dashes or parentheses.
+=== An email address ===
+If you select this link type, simply enter the email address into the //Link target//.
+=== An link to an external page ===
+This link type creates a link to a regular web page, like [[https://svcommunitytheatre.org/|https://svcommunitytheatre.org/]] . Enter the URL into the //Link target//.
+=== Other ===
+This link type allows exotic things like [[doku>wiki:syntax#windows_shares|Windows Shares]]. You'll never use this option.
+==== Link Name Type ====
+This defines what text (or image) is displayed on the page for this link.
+=== Automatic Title ===
+This option uses the text in the //Link target //field - or the current page title if you are linking to a wiki page - as the text for the link.
+=== Custom Title ===
+This option displays the //**Link name**// field where you can type in what text you want displayed for the link.
+=== Use an image as Title ===
+This option allows you to use an image as a clickable link. See [[faqs:about_this_wiki:adding_images_and_documents|add an image]] for details on all the additional fields you'll need to fill in.
+===== Clicking OK and Verifying The Link =====
+When done filling everything in, click the ''OK'' button to complete the process. You'll see the link appear on the page.
+After you ''Save'' the page, you might want to click on each link and make sure it's working correctly, especially external links.
+If you have any questions or problems, ask one of the [[people:wiki_admins|Wiki Admins]].