doc:links

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
doc:links [2026/03/31 06:56] – Simon Grantdoc:links [2026/04/04 18:58] (current) – Simon Grant
Line 3: Line 3:
 ====== Links ====== ====== Links ======
  
-Try out all these techniques below in the [[playground:playground]].+//Try out all these techniques below in the [[playground:playground]].//
  
 ---- ----
Line 10: Line 10:
 There are a pair of icons on the toolbar: {{link-icons.png|this is just a demo, don't click here!}} There are a pair of icons on the toolbar: {{link-icons.png|this is just a demo, don't click here!}}
  
-The one on the left is for internal links – that is, links to other wiki pages – and the one on the right for external links.+The one on the left is for internal links – that is, links to other pages in **this** wiki – and the one on the right for external links.
  
-==== Internal links to other pages in the wiki ====+==== Internal links to other pages in this wiki ====
  
 We recommend this as the way to link to existing pages, because of the help that is provided when you click on the internal link icon. A 'Link Wizard' pops up, initially showing the relevant pages in the part of the wiki you are currently in.((This is known as a '[[namespace]]')). If you want to broaden your search for the right page to link to, delete the [[namespace]], i.e. the abbreviation up to and including the colon '':''. That way you will get a list of all the pages across the wiki, in any [[namespace]], and the namespace will show as an abbreviation and a colon, before the page title. We recommend this as the way to link to existing pages, because of the help that is provided when you click on the internal link icon. A 'Link Wizard' pops up, initially showing the relevant pages in the part of the wiki you are currently in.((This is known as a '[[namespace]]')). If you want to broaden your search for the right page to link to, delete the [[namespace]], i.e. the abbreviation up to and including the colon '':''. That way you will get a list of all the pages across the wiki, in any [[namespace]], and the namespace will show as an abbreviation and a colon, before the page title.
Line 27: Line 27:
 To create an internal link, you put the [[namespace]] and the page name you want to link to in double square brackets. For example, if you want to link to the page on Alpacas, writing `[[alps:Alpacas]]` will do the job: it shows as [[alps:Alpacas]]. Note that internal links and page names are not case sensitive. To create an internal link, you put the [[namespace]] and the page name you want to link to in double square brackets. For example, if you want to link to the page on Alpacas, writing `[[alps:Alpacas]]` will do the job: it shows as [[alps:Alpacas]]. Note that internal links and page names are not case sensitive.
  
-Some page names are not quite as displayed in the page title. So, for instance, the page with the title "Low-impact money" is just called "money". If you want to link to this page, you would need to write `[[limo:money|Low-impact money]]` — which does the job like this: [[limo:money|Low-impact money]].+Some page names vary slightly from what is displayed in the page title. So, for instance, the page with the title "Low-impact clothes" is just called "clothes". If you want to link to this page, you would need to write `[[licl:clothes|Low-impact clothes]]` — which does the job like this: [[licl:clothes|Low-impact clothes]].
      
 The way this works, needing to include the namespace, can be a bit tricky, and is why we recommend using the Wizard as above. The way this works, needing to include the namespace, can be a bit tricky, and is why we recommend using the Wizard as above.
  
 ==== External links ==== ==== External links ====
- +  - An example of the general case is `[[https://wiki.p2pfoundation.net|P2P Foundation wiki]]` giving [[https://wiki.p2pfoundation.net|P2P Foundation wiki]]. Note the ''|'' character separating the URL from the link text. 
-1. An example of the general case is `[[https://wiki.p2pfoundation.net|P2P Foundation wiki]]` giving [[https://wiki.p2pfoundation.net|P2P Foundation wiki]]. Note the ''|'' character separating the URL from the link text. +  - For a few particular cases, there is a nice short cut.  
-2. For a few particular cases, especially Wikipedia, there is a nice short cut. For instance, `[[wp>Commons]]` gives [[wp>Commons]]. We don't support Big Tech, but if you really want a Google search, it can be done as `[[google>Growing the Commons]]`, giving this: [[google>Growing the Commons]]+    - For Wikipedia, `[[wp>Commons]]` gives [[wp>Commons]].  
 +    - We try not to support Big Tech, but if you really want a Google search, it can be done as `[[google>Growing the Commons]]`, giving this: [[google>Growing the Commons]] 
 +    - You can refer to DokuWiki's own site using e.g. `[[doku>dokuwiki]]` giving [[doku>dokuwiki]]. 
  
 ---- ----
Line 45: Line 47:
 You can use the same idea as in DokuWiki, but with Markdown syntax, like this:  You can use the same idea as in DokuWiki, but with Markdown syntax, like this: 
  
-* `[Low-impact money](limo:money)` gives [Low-impact money](limo:money)+* `[Low-impact clothes](licl:clothes)` gives [Low-impact clothes](licl:clothes)
 * `[](alps:Alpacas)` gives [](alps:Alpacas). * `[](alps:Alpacas)` gives [](alps:Alpacas).
  
Line 51: Line 53:
 Using the above example here is is `[P2P Foundation wiki](https://wiki.p2pfoundation.net)` giving [P2P Foundation wiki](https://wiki.p2pfoundation.net). Using the above example here is is `[P2P Foundation wiki](https://wiki.p2pfoundation.net)` giving [P2P Foundation wiki](https://wiki.p2pfoundation.net).
  
-However, the DokuWiki short cuts, to Wikipedia, Google, etc., are not available in Markdown.+DokuWiki short cuts, to Wikipedia, Google, etc., are also available in Markdown, with a few more characters. 
 + 
 +`[Commons on Wikipedia](wp>Commons)` gives [Commons on Wikipedia](wp>Commons).
  
 ---- ----
Line 57: Line 61:
 ===== General points about links ===== ===== General points about links =====
  
 +For all links, you have the option of specifying the link text that is displayed as the link.
 +  * In DokuWiki, put `|link text` directly after the URL and before the `]]`.
 +  * In Markdown, put the link text between the `[` and the `]`.
 ==== Internal links ==== ==== Internal links ====
-Internal links to pages that exist are currently shown in green, with no extra decoration. Internal links to pages that don't exist are currently shown in [[red]] (there isn't a page called 'red', please don't create one!).+Internal links to pages that exist are currently shown in green, with no extra decoration. Internal links to pages that don't exist are currently shown in [[red like this]] (there isn't a page called 'red like this', please don't create one!).
  
 When you create an internal link, the backlinks on the page you link to will include the page you are on at present. You can see this if you go to the examples on this page. When you click on the Backlinks icon on those pages, the list includes `doc:links`. When you create an internal link, the backlinks on the page you link to will include the page you are on at present. You can see this if you go to the examples on this page. When you click on the Backlinks icon on those pages, the list includes `doc:links`.
Line 65: Line 72:
  
 ==== External links ==== ==== External links ====
-In general, external links are shown in green, with a globe icon in front of them, unlike internal links that have no extra icon. There is no obvious indication whether the URL linked to has a page or not. You just have to try it and see: if it's not there, you might get a '404' page.+In general, external links are shown in green, with a globe icon in front of them, unlike internal links that have no extra icon. There is no obvious indication whether the URL linked to has a page or not. You just have to try it and see: if it's not there, you might get a '404' page not found message.
  
-When you create an external link, there is no mechanism for creating a backlink, so it's practically impossible to see that you have linked to it.+When you create an external link, there is no mechanism for creating a backlink, so it's practically impossible to see from the other page that you have linked to it.
  
 ---- ----
  • doc/links.1774940198.txt.gz
  • Last modified: 2026/03/31 06:56
  • by Simon Grant