#+TITLE: Using links
#+SHORT-TITLE: links
#+KEYWORDS:
#+TOC-KEYWORDS: manuals
#+DESCRIPTION: 

* References to another website

** Example
If you do not want to be tracked, use \[\[https:\/\/duckduckgo.com\]\[duckduckgo\]\] to search internet.

** Result
If you do not want to be tracked, use [[https://duckduckgo.com][duckduckgo]] to search internet.

* References to another web page
If you want to reference another page of your own website, you can either use complete address or just the name of the page.

** Example
I can reference TOC page using\\
\[\[http:\/\/howto.leanws.com\/toc\]\[its complete address\]\] or\\
\[\[toc\]\[just using name of the page\]\].

** Result
I can reference TOC page using [[http://howto.leanws.com/toc][its complete address]] or [[toc][just using name of the page]].

* Referencing files
Your auxiliary files are stored in the *files/* directory, and you can reference them similarly how
it is done with web pages.

** Example
Reading\\
\[\[files/example.pdf\]\[this PDF document\]\] might help you filling\\
\[\[https:\/\/www.irs.gov\/pub\/irs-pdf\/f1040.pdf\]\[IRS tax forms\]\].

** Result
Reading
[[files/example.pdf][this PDF document]] might help you filling
[[https://www.irs.gov/pub/irs-pdf/f1040.pdf][IRS tax forms]].

** Notes
- When referring to a file for downloading\\
  \[\[files/example.pdf\]\[this PDF document\]\], we have to specify its directory *files/*.
- What happens when we click a link to a file, depends on the web browser and its configuration. Some browsers will open a PDF document as if it was a web page; others will just save it in the *Downloads* folder.

* Audio files
Modern browsers support embedding audio files.

** Example
If you like this free music\\\\\\\\
\[\[audio:relax.mp3\]\]\\\\\\\\
you can\\
\[\[files\/relax.mp3\]\[download the file\]\] and share it with your friends.

** Result
If you like this free music\\
[[audio:relax.mp3]]\\
you can
[[files/relax.mp3][download the file]] and share it with your friends.

** Note
When referring to a file for downloading\\
\[\[files\/relax.mp3\]\[download the file\]\], we have to specify its directory *files/*

* Images
Inserting images in a web page is somewhat similar to inserting an audio file.
The simplest directive is \[\[files\/image-file.jpeg\]\]

** Example
When we view an image on the webpage\\
\[\[image:cat1.jpeg\]\]\\
its size is adjusted to the screen width;
in order to download the full size picture, we refer it as a file:\\
\[\[files/cat1.jpeg\]\[right click to download the full-sized image\]\].

** Result
[[image:cat1.jpeg]]\\
its size is adjusted to the screen width;
in order to download the full size picture, we refer it as a file:
[[files/cat1.jpeg][right click to download the full-sized image]].

** Note
[[image:cat1.jpeg:width=200px:max-width=50%:lower:left]]
To learn how to specify image's size and placement, read [[images-1][simple]] and [[images-2][advanced]] manuals.